Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This is a simple Python script to convert your Pinboard bookmarks into the standard HTML-ish bookmarks file format.


The script needs to know your Pinboard username and the associated API token. You can give it this information either by editing the Python script or by passing options to the script. In the former case, open in your favorite text editor and replace the values on lines 19 and 20 with your username and token. You can then do

python [output-file]

Output will go to stdout if you do not specify an output file name.

If you want to pass your username and password as command-line options, run the script like

python -u username -t token [output-file]

If you take this approach you must specify both a username and a token on the command line. The -u and -t flags override the username and password set in the script file. Again, output will go to stdout if you do not specify an output file name.

Version history

  • 1.2 (2012-08-01)
    • This version no longer stores or accepts passwords, but rather uses the API tokens described in this blog post. To use this version, obtain your token (something like "username:2AB96390C7DBE34") from your Pinboard settings. The part after the colon is your API token, which can be set on line 20 of the script or passed in with the -t argument.
    • Don't overwrite an existing bookmarks file if we get a bad response from the server.
  • 1.1 (2011-06-24): Changed my mind and renamed the project from pinboard2bookmarks to py-pinboard2html.
  • 1.0 (2011-06-24): Initial release.


This script was written by Benjamin Esham.

This project is hosted on GitHub. Please feel free to submit pull requests.


Copyright © 2011–2012 Benjamin D. Esham. This program is released under the ISC license, which you can find in the file


A Python script to convert your Pinboard bookmarks into an HTML bookmarks file







No packages published