Audiobookshelf Tracker

Audiobookshelf Tracker is a self-hosted web application to track the listening history from Audiobookshelf.

The application records the:

• Listening progress
• Author or podcast name
• Title

With this tracker you can easily keep track of the audiobooks and podcast episodes they have listened to, avoiding duplicates and making it simpler to safely delete completed items without the fear of forgetting them or accidentally re-downloading or replaying them.

Audiobookshelf Tracker ensures a well-organized and efficient history management of your personal audio libraries.

Install

Create the local data folder for the SQLite database:

mkdir data
chmod -R 777 data

Create a docker-compose.yml and set the environment variables:

services:
  server:
    container_name: server
    image: ghcr.io/xairoo/audiobookshelf-tracker-server:latest
    restart: always
    ports:
      - 3005:3005
    networks:
      - audiobookshelf_tracker
    volumes:
      - ./data:/data
    environment:
      - CLIENT_PORT=3000
      - SERVER_PORT=3005
      - USERNAME= # username for the tracker
      - PASSWORD= # admin password for the tracker
      - JWT_SECRET= # random salt, change this
      - ABS_URL= # Audiobookshelf server, e.g.: http://192.168.0.129:13378
      - ABS_TOKEN= # Your Audiobookshelf admin token (Settings -> Users -> root account -> API token)

  client:
    container_name: client
    image: ghcr.io/xairoo/audiobookshelf-tracker-client:latest
    restart: always
    ports:
      - 3000:3000
    networks:
      - audiobookshelf_tracker
    environment:
      - CLIENT_PORT=3000
      - SERVER_PORT=3005

networks:
  audiobookshelf_tracker:
    external: true

Create a Docker network

docker network create audiobookshelf_tracker

Start the containers

docker compose -f docker-compose.yml up -d

Now you can login at http://localhost:3000 with the username and password based on USERNAME and PASSWORD.

Enjoy!

Remote Access

You can easily tunnel the client container with Cloudflare Tunnel or a NGINX proxy. Just use http://localhost:3000 as target.

Update

docker compose -f docker-compose.yml pull
docker compose -f docker-compose.yml down
docker compose -f docker-compose.yml up --detach

Development

Clone the repo, create a docker-compose-dev.yml for your local environment and follow these steps:

# Install dependencies
npm ci

# Create a network, which allows containers to communicate
# with each other, by using their container name as a hostname
docker network create audiobookshelf_tracker

# Build prod using new BuildKit engine
docker compose -f docker-compose-dev.yml build

# Start the containers
docker compose -f docker-compose-dev.yml up

Open http://localhost:3000.

Stop the two containers:

docker compose -f docker-compose-dev.yml down