GoodLinks to CrossPoint

I really like tiny ereaders like the ones Xteink makes. I also really like GoodLinks, the read-later service.

So I made this to take selected articles from my GoodLinks queue, convert them to ePubs, and send them to my tiny reader.

For the full command, state, device, recovery, and undo reference, see the complete reference.

One-time setup

1. Install pandoc, eg brew install pandoc.
2. Clone the project and install its CLI in a local virtual environment:

git clone https://github.com/diegopetrucci/goodlinks-to-crosspoint.git
cd goodlinks-to-crosspoint
python3 -m venv .venv
.venv/bin/python -m pip install --no-deps .
.venv/bin/goodlinks-crosspoint --version

3. Open GoodLinks on the Mac, go to Settings > API, enable the API server, and note down the token.
4. cp .sync.env.example .sync.env and change (if you want) the GoodLinks tag for the articles you want to sync.

Syncing the selected articles

On the CrossPoint device, select File Transfer and join the Wi-Fi network as the Mac.

If you use pass as a secrets manager:

1. Save the GoodLinks token: pass insert goodlinks-crosspoint/goodlinks-token
2. Start the sync: ./sync.sh.

If you don't use pass:

printf 'GoodLinks API token: '
IFS= read -r -s GOODLINKS_TOKEN
printf '\n'
export GOODLINKS_TOKEN
.venv/bin/goodlinks-crosspoint sync
unset GOODLINKS_TOKEN