dhellmann / link_scrubber

Bookmark cleaner
7 stars 2 forks source link

================================================= Link Scrubber -- a pinboard.in bookmark cleaner

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

.. _announcement that Google Reader is being shuttered: http://googleblog.blogspot.com/2013/03/a-second-spring-of-cleaning.html .. _pinboard.in: http://pinboard.in

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 feedproxy.google.com 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.

Installing

Install via pip::

$ pip install git+http://github.com/mgan59/python-pinboard.git#egg=python-pinboard $ pip install linkscrubber

.. note::

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

Running

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

::

$ linkscrubber -t token

or

::

$ linkscrubber -u username -p password

or, leave off the password and you will be prompted

::

$ linkscrubber -u username Password:

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

Disclaimer

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 https://github.com/dhellmann/link_scrubber to report problems.