Always trying to decide on a movie to watch together? This may be the fun solution you've been looking for. Dating app style — swipe right to like, swipe left to pass. If you both swipe right on the same movie, IT'S A MATCH!!

Supports Plex & Jellyfin

Screenshots

Performance Note (First-Time Run)

When you click Host Session or select a new genre for the absolute first time, Kino-Swipe caches your media library locally in a SQLite database to ensure instant loading speeds later.

• First run / New genre: May take 5–15 seconds depending on the size of your Plex or Jellyfin library while it builds the initial local dataset.
• Subsequent runs: Instantaneous. The app shuffles and serves cards out of the local cache immediately.
• Automatic Updates: The cache automatically and silently updates in a background thread every 24 hours, meaning you will never experience that initial setup delay again after the first run.
• Plex Homescreen Sync: Matches on Plex homescreen are only visable to the user who made the match, All other remote or admin users will not see those matches.

Features

• Plex & Jellyfin Integration: Connects directly to your Plex or Jellyfin server to pull movies.
• Coloured sessions: Plex Yellow lets you know you're in a Plex session and Jellyfin Blue for Jellyfin.
• Real-Time Sync: Host a room, share a 4-digit code, and swipe with a partner instantly.
• Visual Feedback: Faint Red/Green glow with thumbs-up or thumbs-down overlays that react as you drag posters left or right.
• Select Genre: Both sessions stay in sync while browsing genres.
• Add to Watchlist: Tap a match to open in Plex or save to watchlist/favourites for later.
• Watch Trailer: Tap the poster for full synopsis, cast, and trailer via TMDB.
• PWA Support: Add to your Home Screen for a native app feel.
• Match Notifications: Instant alerts with haptic feedback when you both swipe right on the same movie.
• Match History: All matches saved to history until you're ready to delete them.
• Plex-Homescreen-Sync: Each match will automatically show on a per-users Plex Homescreen (Until deleted from Kino).
• Plex Home Users Have kids with restricted accounts? You can now select their profile if they are a Home User to only see suitable movies.
• Jellyfin Restricted Libraries Also for Jellyfin users with restricted libraries will only see their movies.
• Solo Mode: Flying solo? Host a session and flick the solo toggle — every right swipe saves to your Match History.

Requirements

Plex

• Plex Media Server
• Plex Auth Token

Jellyfin

• Jellyfin Media Server
• Jellyfin API Key

Both

• TMDB API Key (optional — required for trailers and cast)
• HTTPS/Reverse Proxy (required to install as a PWA on your phone)

You only need one media server configured. Both can run side by side on the same instance — users pick which one to log into at the login screen.

TMDB API Setup

Only required if you want trailers and cast to work on the rear of the movie posters.

Deployment

Option 1: Docker Compose

services:
  kino-swipe:
    image: bergasha/kino-swipe:latest
    container_name: kino-swipe
    ports:
      - "5005:5005"
    environment:
      - PLEX_URL=https://YOUR_PLEX_IP:32400        # Optional
      - PLEX_TOKEN=YOUR_PLEX_TOKEN                  # Optional
      - JELLYFIN_URL=http://YOUR_JELLYFIN_IP:8096   # Optional
      - JELLYFIN_API_KEY=YOUR_JELLYFIN_API_KEY      # Optional
      - APP_LOCALE=en                               # Optional: use de for Plex library "Filme"
      - FLASK_SECRET=SomeRandomString
      - TMDB_API_KEY=your_tmdb_key_here
    volumes:
      - ./data:/app/data
      - ./static:/app/static
    restart: unless-stopped

Option 2: Docker Run

docker run -d \
  --name kino-swipe \
  -p 5005:5005 \
  -e PLEX_URL=https://YOUR_PLEX_IP:32400 \          # Optional
  -e PLEX_TOKEN=YOUR_PLEX_TOKEN \                   # Optional
  -e JELLYFIN_URL=http://YOUR_JELLYFIN_IP:8096 \    # Optional
  -e JELLYFIN_API_KEY=YOUR_JELLYFIN_API_KEY \       # Optional
  -e APP_LOCALE=en \                                # Optional: use de for Plex library "Filme"
  -e FLASK_SECRET=SomeRandomString \
  -e TMDB_API_KEY=your_tmdb_key_here \
  -v ./data:/app/data \
  -v ./static:/app/static \
  --restart unless-stopped \
  bergasha/kino-swipe:latest

At least Plex or Jellyfin must be configured. Both can be also set at the same time.

Plex library locale (optional): defaults to en (Movies). Set APP_LOCALE=de if your Plex movie library is named Filme.

This product uses the TMDB API but is not endorsed or certified by TMDB.