PocketCasts service integration for Exist.io

Track your daily podcast listening minutes in PocketCasts as an attribute in Exist.io.

Setup

Install a copy of the repository:

git clone --recurse-submodules https://codeberg.org/da/exist.io-pocketcasts.git

How it works

The program submits data to Exist and then exits. It needs to be run at least once per day (a few minutes before midnight in your local time zone). On every run, it checks for new episodes in your PocketCasts archive, and submits your listening time to Exist.

It is recommended that you use the provided systemd unit files to manage the program’s lifecycle. It will run the program every few hours during the day, plus just before midnight.

Configuration

Provide configuration options as environmental variables. All configuration options are required.

EXIST_CLIENT_ID=
EXIST_CLIENT_SECRET=
EXIST_OAUTH2_RETURN="http://localhost:9009/"
POCKETCASTS_USERMAIL=
POCKETCASTS_PASSWORD=

You can obtain the two first values and supply the third by registering your client as an Exist app.

Optional configuration options:

PLAYBACK_SPEED=1.0
ADS_MINUTES_SKIPPED_PER_HOUR=

If you skip ahead, you should subtract that from your listening time. Skipped playback time is recorded as listened time by PocketCasts. The value will vary from podcast to podcast and day to day. Supply an average value (six to ten minutes per hour is a typical range).

systemd

The systemd directory contains example systemd service unit files for running the program periodically as a systemd service. You may need to adjust the paths to the ExecStart program and the EnvironmentFile file where you store your config.