movie-night-planner

KO | EN

gitlite — search

#javascript #python #react #llm #android #deep-learning #linux #docker #windows #awesome #cli #awesome-list #vue #pytorch

movie-night-planner

(★ 12)

A self-hosted web app for coordinating family movie nights with fair turn-based picking, wishlists, and media server integration.

movie-night-planner Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Movie Night Planner

A self-hosted web app for coordinating family movie nights with fair turn-based picking, wishlists, and media server integration. Built for households that want to take turns choosing movies, track what they've watched, and integrate with services like Plex, Radarr, and Overseerr.

## Screenshots

## Features

- **Fair turn-based movie picking** -- rotation system so everyone gets a fair pick
- **Movie search** via TMDb API with rich metadata
- **Personal wishlists** with drag-and-drop reordering
- **"Up Next" queue** with one-click promotion from wishlists
- **Watch history tracking** to keep a record of what you have watched
- **Movie trailer support** with YouTube playlist generation
- **Plex integration** -- check library availability for any movie
- **Radarr integration** -- view download status for monitored movies
- **Overseerr integration** -- manage media requests
- **Plex watch history import** -- bring in your existing watch data
- **Data import** for backup and migration
- **Mobile-friendly responsive design**
- **Docker deployment support**

## Quick Start

### Prerequisites

- [Node.js](https://nodejs.org/) 20+
- A [TMDb API key](https://www.themoviedb.org/settings/api) (free)

### Development

```bash
# Install dependencies
npm install

# Copy the example env file and add your TMDb API key
cp .env.example .env

# (Optional) Seed sample data
npm run db:seed

# Start the development server
npm run dev
```

The app will be available at `http://localhost:5173`.

### Docker

```bash
docker build -t movie-night-planner .
docker run -d \
  -p 3000:3000 \
  -v movie-night-data:/app/data \
  -e TMDB_API_KEY=your_key_here \
  movie-night-planner
```

The app will be available at `http://localhost:3000`.

For a full Docker Compose setup with reverse proxy guidance, see [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md).

## Environment Variables

| Variable | Required | Default | Description |
|---|---|---|---|
| `DATABASE_URL` | No | `file:./data/movie-night.db` | SQLite database path |
| `TMDB_API_KEY` | **Yes** | -- | API key from [themoviedb.org](https://www.themoviedb.org/settings/api) |
| `PLEX_URL` | No | -- | Plex server URL (e.g. `http://plex:32400`) |
| `PLEX_TOKEN` | No | -- | Plex authentication token |
| `RADARR_URL` | No | -- | Radarr server URL (e.g. `http://radarr:7878`) |
| `RADARR_API_KEY` | No | -- | Radarr API key |
| `OVERSEERR_URL` | No | -- | Overseerr server URL (e.g. `http://overseerr:5055`) |
| `OVERSEERR_API_KEY` | No | -- | Overseerr API key |

## Integration Setup

All integrations are optional. The app works standalone with just a TMDb API key.

### Plex

Provides library availability checking so you can see which movies are already in your Plex library.

1. Get your Plex token: see [Finding an authentication token](https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/).
2. Set `PLEX_URL` and `PLEX_TOKEN` in your environment.

### Radarr

Shows download and monitoring status for movies in your Radarr instance.

1. Find your API key in Radarr under Settings > General.
2. Set `RADARR_URL` and `RADARR_API_KEY` in your environment.

### Overseerr

Displays media request status from Overseerr.

1. Find your API key in Overseerr under Settings > General.
2. Set `OVERSEERR_URL` and `OVERSEERR_API_KEY` in your environment.

## Database Commands

| Command | Description |
|---|---|
| `npm run db:seed` | Seed the database with sample members |
| `npm run db:generate` | Generate a Drizzle migration file (development) |
| `npm run db:push` | Push schema changes directly (development) |

The database schema is created automatically on first startup — no manual migration step is needed.

### Plex Utilities

| Command | Description |
|---|---|
| `npm run plex:export` | Export Plex watch history to a file |
| `npm run plex:import` | Import watch history from an export file |
| `npm run plex:fix-posters` | Fix poster URLs in the database |

## Tech Stack

- **Framework**: [SvelteKit 2](https://kit.svelte.dev/) with [Svelte 5](https://svelte.dev/)
- **Language**: TypeScript
- **Database**: SQLite via [better-sqlite3](https://github.com/WiseLibs/better-sqlite3)
- **ORM**: [Drizzle ORM](https://orm.drizzle.team/)
- **UI**: [Skeleton UI](https://www.skeleton.dev/) + [Tailwind CSS](https://tailwindcss.com/)
- **Deployment**: Docker (Node.js 20 Alpine)

## License

This project is licensed under the [MIT License](LICENSE).

movie-night-planner

movie-night-planner Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

movie-night-planner

movie-night-planner Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README