markmental/freepassport-c

Fork 0

FreePassport-C Media Player is a low-dependency SDL2 + FFmpeg application that allows you to organize your media into a virtual cable guide with live-seeking channels.

Find a file

markmental 2bdeba1b45 Guide cleanup		2026-03-27 23:33:09 -04:00
src	Guide cleanup	2026-03-27 23:33:09 -04:00
.gitignore	Initial Commit	2026-03-27 21:45:40 -04:00
guide-ui.jpg	Initial Commit	2026-03-27 21:45:40 -04:00
Makefile	Milestone, fix black screen and initial frame issues	2026-03-27 22:59:37 -04:00
README.md	Milestone, fix black screen and initial frame issues	2026-03-27 22:59:37 -04:00

README.md

Passport-C Media Player

Passport-C Media Player is a low-dependency SDL2 + FFmpeg prototype that recreates the 2004-era Passport DCT cable guide with live-seeking channels.

Features

Live-TV epoch clock based on time(NULL)
200 ms black-screen channel tuning delay
Fullscreen and guide modes
5-row Passport-style guide with a 90-minute timeline
Background decoder thread with a bounded frame queue
Automatic channel discovery from ./media

Layout

src/ - application, UI, channel scan, and playback code
media/ - channel video files
guide-ui.jpg - visual reference used for proportions and palette

Controls

Up / Down - surf channels
Tab - toggle guide
Esc - exit guide or quit the app

Build

Install development packages for SDL2, SDL2_ttf, and FFmpeg headers before building.

Typical Debian or Ubuntu packages:

sudo apt install build-essential libsdl2-dev libsdl2-ttf-dev libavformat-dev libavcodec-dev libswscale-dev libswresample-dev libavutil-dev

Then build and run:

make
./passport-c-media-player

Media

The player scans ./media for supported video files and converts filenames into channel names and current program titles.

Current sample channels:

media/reading.mp4
media/computers.mp4

Fonts

The UI tries BigBlueTermPlus Nerd Font first, then falls back to common Linux monospace fonts.