Cursor Agentandmathieumoran1
2935ba73a6
Add HLS generation and serving for MKV files to improve browser compatibility. Co-authored-by: mathieumoran1 <[email protected]>
61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
## 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")<br>
|
|
**GITHUB_OWNER=**`quoije` (for version history)<br>
|
|
**GITHUB_REPO=**`oscars-pool` (for version history)<br>
|
|
**JWT_SECRET=**`RANDOM STRING` (for authentication token)<br>
|
|
**MONGO_URI=**`mongodb+srv://USER:[email protected]/?retryWrites=true&w=majority&appName=Cluster69`<br>
|
|
**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
|
|
|
|
```bash
|
|
python3 -m venv .venv
|
|
source .venv/bin/activate
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
### Run
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
export CORS_ORIGINS="http://localhost:5000"
|
|
```
|