binarygeek119/finposter repository overview

FinPoster – Jellyfin Poster Display

A display app for Jellyfin that shows poster walls, showtimes, ads, and now-playing media. Use it on a TV or second screen to rotate random library posters, display a "Now Showing" schedule, show ad slides, and reflect playback when something starts.

Author: binarygeek119 GitHub: https://github.com/binarygeek119/FinPoster⁠

---

⁠Quick start

docker run -d
--name finposter
-p 3001:3001
-v finposter_data:/data
binarygeek119/finposter

Then open http://localhost:3001⁠ in a browser. Tap or click anywhere on the display to open Settings. In Jellyfin settings enter your server URL and API key (or username/password), then Load Libraries and enable the libraries you want.

---

⁠Environment (optional)

FINPOSTER_DATA_DIR Data directory inside the container (default: /data) HOST Bind address (default: 0.0.0.0) PORT Port to listen on (default: 3001)

---

⁠Volume

/data Persists settings, cache, and uploads. Mount this so your configuration and cached artwork survive container restarts.

---

⁠AI disclaimer

This application was 100% AI-generated. The author used prompts and AI coding tools to create it. The code should be reviewed by a professional developer before use in production. Use at your own risk.