GUI frontend for saving articles to Pocket via pocket-cli
Find a file
2024-10-25 17:49:51 +05:30
COPYING Add licence (GPL-3.0-or-later) 2024-10-25 17:01:51 +05:30
pocket-save Add licence (GPL-3.0-or-later) 2024-10-25 17:01:51 +05:30
pocket-save.desktop Initial commit with a working script 2024-10-25 17:00:04 +05:30
README.md Add README (and screenshots!) 2024-10-25 17:49:51 +05:30
screenshot.png Add README (and screenshots!) 2024-10-25 17:49:51 +05:30

pocket-save

Quickly save links to Pocket

Setup

In order to run this script, you will need to have yad, notify-send, and pocket-cli installed. The first two can probably be obtained via your system package manager, but it is recommended to get pocket-cli from this repo which is an updated version of the original repo.

You can install it like any custom Python program, for example through pipx:

pipx install git+https://git.disroot.org/badrihippo/pocket-cli

Once you have set up the dependencies and activated pocket-cli, you can set up this script by doing the following:

  • Copy pocket-save to your ~/.local/bin (or some other place like /usr/local/bin)
  • Copy pocket-save.desktop to your ~/.local/share/applications (or some other place like `/usr/local/share/applications^)
  • Make sure `pocket-cli8 has executable permissions

Or, if you prefer to blindly copy-paste:

mkdir -p ~/.local/bin \
  && cp -i pocket-save ~/.local/bin
  && cmod +x ~/.local/bin/pocket-save

mkdir -p ~/.local/share/applications \
  && cp -i pocket-save.desktop ~/.local/share/applications

You should see a "Save to Pocket" option open up on your system menu. You can now set your apps to open pocket-save URL when you want to save your article to Pocket, or set your default browser to an app like Junction which will then allow you to choose different "browsers" (including pocket-save) each time you open a link.

Before saving, pocket-save will prompt you to enter some tags. This is mandatory, as a workaround, because Pocket has for some reason stopped accepting pocket-cli requests unless they contain either a title or tags.

Screenshots

Here's how the saving sequence looks when saving a link via Junction and pocket-save on mobile:

Four screenshot previewing the saving sequence

Contributing

I mean this is just a small script but contributions but contributions are welcome! Feel free to open a pull request, or contact me if you want to do it some other way.

Licence

This script is licenced under the GNU General Public Licence version 3, or, at your convenience, any later version. See the COPYING file for more details.