Audible to Exist

Sync Audible listening data into Exist with Python. Uses the Audible Python API.

What this does

This script:

• authorizes with Audible in your browser and stores reusable device credentials locally
• authorizes with Exist in your browser and stores refreshable OAuth tokens locally
• creates the required Exist attributes if they do not already exist
• fetches today's Audible listening stats
• writes the values into Exist

Attributes created in Exist

• Audible listening as minutes (Media)
• Audible books finished as an integer count (Media)

Setup

1. Install dependencies:

pip install -r requirements.txt

2. Make a new Developer API Client on Exist.io (Account Settings -> Developer Clients -> Add a new client)

• Name = Whatever you want!
• Support Email = Whatever you want!
• Redirect URI = http://localhost:8000/
• OAuth2 client type = Confidential

You will use the resulting client ID and client secret for the OAuth environment variables below.

3. Copy .env.example values into your shell environment.

Required variables:

• EXIST_CLIENT_ID - From your Exist.io Developer API Client
• EXIST_CLIENT_SECRET - From your Exist.io Developer API Client
• AUDIBLE_LOCALE - Audible account Country code (https://audible.readthedocs.io/en/latest/marketplaces/marketplaces.html#country-codes)

First run

Authorize Audible in your browser and save credentials:

python main.py auth

Authorize Exist in your browser and save credentials, this also ensures the required Exist attributes exist and stores their resolved names for future syncs:

python main.py exist-auth

Sync today's and yesterday's data:

python main.py sync

Sync a larger recent window including today:

python main.py sync --days 30

Inspect the Audible daily stats and finished-book count for a specific day:

python main.py inspect --date 2026-05-03

I'd recommend using Task Scheduler (or any equivalent) to run this script once a day just before midnight. The script uses the machine's local timezone when deciding what counts as "today".