Skip to content
Unsavory removes stale Pinboard bookmarks
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd/unsavory
internal
.gitignore
.goreleaser.yml
Dockerfile
LICENSE
README.md

README.md

unsavory: get rid of those stale bookmarks!

unsavory checks your Pinboard bookmarks for dead links (HTTP status code 404) and removes them. Additionally it will also inform you about links which return a status code other than 200 (OK). This is a Go re-implementation of the original Ruby version.

If you wonder about the name, this program was originally written for del.icio.us and I can't resist a bad pun.

Installation

Homebrew

$ brew tap citizen428/homebrew-tap
$ brew install unsavory

Release

Head over to the release page and download the archive for your operating system/architecture.

Docker

$ docker run --rm citizen428/unsavory -token=user:NNNNNN --dry-run

Manual

$ go install github.com/citizen428/unsavory...

Options

Usage of unsavory:
  -dry-run
    	Enables dry run mode
  -proxy-url string
    	HTTP proxy URL
  -token string
    	Pinboard API token

Usage

Just start unsavory from the command line and provide the Pinboard API token from your settings page.

$ unsavory -token=user:NNNNNN
Retrieving URLs
Retrieved 783 URLS
...

If you don't want to actually delete links, add the -dry-run option:

$ unsavory -token=user:NNNNNN -dry-run
You are using dry run mode. No links will be deleted!

Retrieving URLs
Retrieved 783 URLS
...

Proxy servers

If a HTTP_PROXY environment variable is present, Go's HTTP client will automatically use it. Alternatively a proxy server can be specified via the --proxy-url option:

$ unsavory --token=user:NNNNNN --proxy-url=http://example.com:8080

Warning

Any link that returns an HTTP status code of 404 will be deleted without warning. There's no undo, use at your own risk!

Todo

  • Add tests
  • Feature parity with legacy Ruby version
  • Add option to replace links with Archive.org links (?)
  • Add option to update redirects (?)

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/citizen428/unsavory.

License

The program is available as open source under the terms of the MIT License.

You can’t perform that action at this time.