https://github.com/mosegontar/Pinku

A Pinboard-to-buku importation utility
https://github.com/mosegontar/Pinku

bookmarks buku pinboard pinboard-api pinboard-bookmarks utility

Last synced: 3 months ago
JSON representation

A Pinboard-to-buku importation utility

• Host: GitHub
• URL: https://github.com/mosegontar/Pinku
• Owner: mosegontar
• Created: 2017-09-24T15:34:43.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2022-12-08T00:44:41.000Z (almost 2 years ago)
• Last Synced: 2024-08-12T14:23:25.813Z (3 months ago)
• Topics: bookmarks, buku, pinboard, pinboard-api, pinboard-bookmarks, utility
• Language: Python
• Homepage:
• Size: 14.6 KB
• Stars: 30
• Watchers: 3
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
pinku

=====

``pinku`` is a `Pinboard `_-to-`buku `_ importation utility.

``pinku`` is **not** (at least at this time) a syncing utility and works in only one direction: to import bookmarks *from* Pinboard *into* buku. If the URL already exists in buku, the entry is skipped over.

Installation

------------

``pip install pinku``

Usage

-----

Ensure that you have set the ``PINBOARD_API_KEY`` environment variable to your Pinboard API token. You can find your API token `here `_.

``pinku`` takes command-line arguments that serve as filters for searching through Pinboard bookmarks. ``pinku`` will then add the results to your buku database.

Pinku supports all of the filter arguments for the Pinboard API ``/all`` endpoint. Please visit `Pinboard's API documentation `_ to read the details.

**Please note that Pinboard limits API calls to the /all endpoint to once every five minutes**

Examples

--------

Add *all* Pinboard bookmarks to buku:

.. code-block::

    pinku

Add your 10 most recent Pinboard bookmarks to buku:

.. code-block::

    pinku -r 10

Add all Pinboard bookmarks tagged ``web-dev`` and ``programming`` (max 3 tags per Pinboard API) to buku:

.. code-block::

    pinku -t web-dev, programming

Add the first 3 Pinboard bookmarks tagged ``web-dev`` to buku:

.. code-block::

    pinku -t web-dev -r 3

Add the first 3 Pinboard bookmarks tagged ``history`` that also have a Pinboard "to read" status:

.. code-block::

    pinku -t history -r 3 --toread

Add all Pinboard bookmarks since September 1, 2017 to buku:

.. code-block::

    pinku --fromdt 2017-09-01

Add all bookmarks that were added to Pinboard between 7/1/2017 and 9/1/2017 to buku:

.. code-block::

    pinku --fromdt 2017-09-01 --todt 2017-09-01