bird2board 0.2.0

Convert bird based bookmarks to board based ones.

bird2board

Convert bird based bookmarks to board based ones.

This tool takes raw Twitter Bookmarks data and pushes the bookmarks to Pinboard.

Installation:

1. Clone this repository
2. Install with pip

#> cd bird2board
#> pip install .

Usage:

First download the raw Twitter bookmarks data:

• Open the Twitter Bookmarks page
• Using Developer tools, look for Network requests starting with Bookmarks?variables=.
• For each of these requests, copy the response, which starts with {"data":{. You can copy the response through the right click context menu.
• Save the response JSON into a new file.
• If you have more than a single screen of bookmarks, scroll down to create more requests and responses. Copy these into new files in a directory.

Next find your Pinboard API token:

• Sign into Pinboard
• Go to Settings page and select Password tab.
• Copy the API token including the username at the start.

Then use the tool to convert the bookmark data and save in Pinboard:

#> bird2board --help
Usage: bird2board [OPTIONS] PATH

  Save Twitter Bookmark .json file(s) at PATH (file or directory) to account
  using PINBOARD TOKEN.

Options:
  --toread / --not-toread    set Pinboard bookmarks as "to read"
  --shared / --not-shared    set Pinboard bookmarks as shared
  --replace / --no-replace   replace existing Pinboard bookmark for an URL
  -p, --pinboard-token TEXT  user token for Pinboard API  [required]
  --help                     Show this message and exit.

Example usage:

#> bird2board -p MY_TOKEN --toread ./responses/

Instead of providing the Pinboard API token as an option to the script, you can set the $BIRD2BOARD_PINBOARD_TOKEN environmental variable.

#> export BIRD2BOARD_PINBOARD_TOKEN=MY_TOKEN
#> bird2board --toread ./responses/

Notes:

• The Pinboard API requires a 3 second wait between API requests, so submitting a large number of bookmarks can take a long time.
• The Twitter Bookmark responses captured above are from the non-public API, and there will likely be breaking changes to the response structure in the future. Most recent breaking change to the response data was in June 2021.