oscars-pool/README.md

Oscars Pool 2026

Little nodejs + mongodb app that I hack together with ChatGPT to keep track of watched movies for an incoming Oscars Pool with some friends.

Setup

Config those in your .env file:

DOG_NAMES=woof, WOOF, Woof     (for "verification")
GITHUB_OWNER=quoije     (for version history)
GITHUB_REPO=oscars-pool     (for version history)
JWT_SECRET=RANDOM STRING     (for authentication token)
MONGO_URI=mongodb+srv://USER:[email protected]/?retryWrites=true&w=majority&appName=Cluster69
OMDB_API=1234567     (for movie info)

run with node .\index.js

Python video file server (mp4/mkv)

This repo also includes a small Python server that serves local video files with HTTP Range support (required for HTML5 <video> seeking).

• Put your files in: ./media/ (repo root)
• Served as: http://localhost:8001/media/<filename>
• List endpoint: http://localhost:8001/api/media

HLS (for better browser compatibility, especially MKV)

The Python server can also generate and serve HLS (.m3u8 + .ts) using ffmpeg, and the web player will automatically try this when a /media/*.mkv file is used (or when direct playback fails).

• Prepare endpoint: http://localhost:8001/api/hls?source=<path relative to media>
• Playlist served from: http://localhost:8001/hls/<id>/index.m3u8
• Output is cached under: ./.hls_cache/ (ignored by git)

Example:

• Source: http://localhost:8001/media/MyMovie.mkv
• The player will request: http://localhost:8001/api/hls?source=MyMovie.mkv and then play the returned .m3u8.

Install

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Run

python3 video_server.py

Use in the web player

Set the movie's video_src (or vod_link) to something like:

• http://localhost:8001/media/MyMovie.mp4
• http://localhost:8001/media/MyMovie.mkv

If the Node app is on a different origin/port, the video server enables CORS by default. You can lock it down with:

export CORS_ORIGINS="http://localhost:5000"