SHA256
1
0
Fork
You've already forked server
0
The server code for the watchlist server. Watchlist is an application where you can track your progress on movies and series.
  • TypeScript 100%
Find a file
2026年05月13日 16:20:48 +02:00
src fix: TS2769 in init.ts 2026年05月13日 16:18:40 +02:00
.env.example fix: set postgres port back to default in example env 2026年05月13日 16:20:48 +02:00
.gitignore chore: add ._ files and config file to ignore 2026年05月13日 16:09:01 +02:00
bun.lock feat!(config): add config parsing & restructure config file 2026年05月13日 16:12:01 +02:00
config.schema.ts feat!(config): add config parsing & restructure config file 2026年05月13日 16:12:01 +02:00
docker-compose.yml chore: make postgres port customizable 2026年05月08日 20:03:28 +02:00
example.config.json feat!(config): add config parsing & restructure config file 2026年05月13日 16:12:01 +02:00
LICENSE chore!: change license from AGPL-3.0-only to EUPL-1.2 2026年05月08日 19:59:13 +02:00
package.json feat!(config): add config parsing & restructure config file 2026年05月13日 16:12:01 +02:00
README.md chore: update readme 2026年05月06日 12:37:14 +02:00
server.ts feat!(config): add config parsing & restructure config file 2026年05月13日 16:12:01 +02:00
tsconfig.json feat!(config): add config parsing & restructure config file 2026年05月13日 16:12:01 +02:00

Watchlist Server

A self-hosted media watchlist server powered by TMDB.

Requirements

  • Bun >= 1.3.11
  • Docker + Docker Compose

Installation

1. Obtain a TMDB API key

  1. Create an account at themoviedb.org
  2. Go to Settings > API in your account dashboard
  3. Request an API key (select "Developer" for personal use)
  4. Copy the API Key (v3)
  5. Paste it into .env as API_KEY_TMDB=<your_key>

2. Configure environment

Either:

  • Copy .env.example to .env and edit the values manually, or
  • Run secrets.sh to auto-generate secure values for secrets and passwords (will ask for a tmdb api key)
cp .env.example .env
# or
bash secrets.sh

3. Start db, install deps & start server

docker compose up -d
bun i
bun run server

Development

Environment Variables

Variable Description Must change default
API_KEY_TMDB TMDB API key Yes
POSTGRES_USER Database username No
POSTGRES_PASSWORD Database password Yes
POSTGRES_DATABASE Database name No
APP_HOST Address the Express server binds to No
APP_PORT Port the server listens on No