https://github.com/dhellmann/link_scrubber
Bookmark cleaner
https://github.com/dhellmann/link_scrubber
Last synced: 10 months ago
JSON representation
Bookmark cleaner
- Host: GitHub
- URL: https://github.com/dhellmann/link_scrubber
- Owner: dhellmann
- Created: 2013-03-28T22:34:15.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2018-12-16T15:36:26.000Z (over 7 years ago)
- Last Synced: 2025-04-01T07:54:21.719Z (about 1 year ago)
- Language: Python
- Size: 35.2 KB
- Stars: 7
- Watchers: 4
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.rst
Awesome Lists containing this project
README
=================================================
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.