Package: pintools
PintoolsCommand line tools for working withPinboard.Features:Import starred repositories from GithubCopy saved reddit linksOrganize tags based on originating siteTitle fixerInstallpip install pintoolsDev installRequirespre-commit$ git clone https://github.com/patrickleweryharris/pintools.git
$ cd pintools
$ make installDependenciesSeerequirements.txtUsagePinboard AuthenticationPintools useslionheart/pinboard.pyto connect with Pinboard. Authentication is completed using your Pinboard API
token, which can be found insettings->passwordon Pinboard.Pintools will by default look for your Pinboard API token in$PINBOARD_API_TOKEN. Alternatively it
can be specified using the--pinboard_tokenargument if you do not want to use
the environment variable.Sync Github StarsPintools can be used to copy Github stars to your Pinboard account. Starred
gists are not currently copied.Usage:pintools github [-h] [--token TOKEN]Github AuthenticationPintools usesPyGithubto connect to
Github. In order to authenticate with Github, you will need to create aPersonal
Access Tokenin your Github account, with theread:userscope.Pintools will look for this Personal Access Token in$PYGITHUB_ACCESS_TOKEN.
Alternatively, this token can be specified using the--tokenarguementSync Reddit Saved LinksPintools can be used to copy Reddit saved items to your Pinboard account. Note
that new saved items can be saved viaIFTTT, but if you want to
back up the entirety of your saved links, you need to use a script like this
because IFTTT will only work on new saved items.Saved comments are not currently copied.Usage:pintools reddit [-h] [--secret SECRET] [--client_id CLIENT_ID] USERNAME PASSWORDReddit AuthenticationPintools usesPRAWto connect with
Reddit. You will need to crate a developer application (personal use script) on
Reddit in order to authenticate. Please follow the PRAW insructions on 'Password
Flow'here.Once you have created a personal use script application on Reddit, save the
Client-ID and Client-Secret. By default, pintools will look for these in$REDDIT_CLIENT_IDand$REDDIT_CLIENT_SECRET. Alternatively, these can be
specified using the--client_idand--secretarguments. Username and
password for Reddit must also be provided on the command line.Organize Pinboard links by originating sitePintools can be used to tag each bookmark against the originating site,
for easier organization. For example, any bookmark fromgithub.comwill
be tagged withgithub.Usage:pintools tags [-h] [--config CONFIG_FILE]This can be optionally customized using a config file. The config file can group several
domains under one URL.The config file uses YAML syntax like so:domains: # list title must always be 'domains'
  utoronto: # Each key is the final tag you want on your bookmarks
    - utoronto # each item in the list is the base URL you want the tag associated with
    - cs.toronto # don't include .com or www.
  twitter:
    - t
    - twitterThere is an example config filehereFix TitlesPintools can fix bookmark titles for you, which sometimes get messed up when
saving bookmarks automatically with IFTTT.Usage:pintools titles [-h] [--tag TAG]In order to prevent accidentally nuking all your bookmark titles, this feature
operates on a single tag. For each bookmark with the tag specified, pintools
will grab the title of the URL, and update the bookmark's title in Pinboard.