Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now bookmark cleaner

Project description

With the announcement that Google Reader is being shuttered, I decided I needed to go through my bookmarks and update any that point to a URL while their redirecting service is still online. This script does that automatically.

What does it do?

link_scrubber processes all of your bookmarks, looking for those that redirect. It adds a new bookmark with the target of the redirect and all the same metadata from the original link. By default, only URLs from are processed, but there are command line options to process all redirects or to add more individual sites.

The links are processed in small batches to reduce the load of individual calls against the pinboard API server, so it can take a while to process. Once a batch of links is fetched, it is checked in parallel to speed things up a little.


Install via pip:

$ pip install git+
$ pip install linkscrubber


Unfortunately, python-pinboard does not have a PyPI release, yet, so it needs to be installed first.


To use it, pass your user token to the -t option, or use your username and password with the --user and --password options.

$ linkscrubber -t token


$ linkscrubber -u username -p password

or, leave off the password and you will be prompted

$ linkscrubber -u username

To see what would be changed, without making any changes, use the --dry-run option.

$ linkscrubber --dry-run -t token

For the full list of options, use:

$ linkscrubber -h


You should back up your account before running the script. I have done some testing, but only against one account. Yours might behave differently.

Reporting Bugs

Use the github bug tracker at to report problems.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
linkscrubber-1.2.0.tar.gz (7.8 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page