Tvium

One IPTV player. Every screen.

Your sources. Your library. Your screens.

Try the Web preview · Download the latest test build

Tvium is a modern, all-in-one IPTV player designed to bring live television, movies, and series from user-provided sources into one clean, organized experience.

Use the same familiar player in a Web browser, on a phone or tablet, on a computer, or across the living room on a TV and compatible streaming box.

Important

Tvium is a media player. It does not provide TV channels, playlists, subscriptions, or access to any IPTV provider. Users are responsible for their sources and for ensuring they have the right to access the content they play.

Everything in one place

• Live TV — browse channels by group and start watching without navigating through complex menus.
• Movies and series — turn compatible sources into a visual, easy-to-explore library.
• Your own sources — import playlists you already have; Tvium does not lock you into a provider.
• A consistent experience — move between small touchscreens, desktops, browsers, TVs, and remote controls without learning a different app each time.
• Built for large libraries — progressive loading keeps browsing responsive as collections grow.
• Privacy first — source details and viewing data are designed to remain local, with no advertising or tracking.
• Clean by design — content stays at the center, with focused navigation and a calm interface.

Designed for every screen

Tvium is being built as one cross-platform product rather than a collection of unrelated players.

Screen	Planned experience
Web	Watch from a modern browser without installing a desktop app.
Phone and tablet	Touch-friendly playback on Android, iPhone, and iPad.
TV and streaming box	Remote-first navigation for Android TV, Google TV, Apple TV, and compatible boxes.
Desktop	A full library experience on macOS and Windows.

Platform availability will be announced only after testing on the relevant devices.

Sources and organization

Tvium accepts progressive M3U and M3U8 imports and protected Xtream-compatible connections. Optional XMLTV programme guides can be imported from a local file or private HTTPS address to show the current and next programme for matched live channels. Test builds include local favorites, history, parental controls, and movie and series organization; their device coverage is still growing.

Source metadata is preserved so Tvium can improve presentation without silently changing the user's playlist.

Development status

Tvium is in active development. Early test builds are available from GitHub Releases, and the Web preview runs directly in a compatible browser. These builds are previews and may still contain incomplete features. The current macOS download is ad-hoc signed and is not yet a normal plug-and-play installer; see the Release Guide before testing it.

Workspace tests and platform exercises have validated:

• M3U file and URL import;
• secure Xtream-compatible profiles and shared family sources without duplicate catalogs;
• local XMLTV programme guides with honest Now/Next information;
• grouped Live, Movies, and TV Shows views;
• keyboard and TV-style focus navigation;
• a cross-platform HLS playback foundation;
• Web, macOS, Android, and unsigned iOS development builds;
• progressive parsing of synthetic playlists containing up to 100,000 entries.

Use the documentation index to find the project review, approved requirements plan, and proposed improvements. The roadmap tracks detailed evidence; the Phase 0 report is historical.

Privacy and safety

Tvium is local-first. Playlist addresses, credentials, private stream URLs, and viewing activity must never be committed to this repository or exposed in diagnostics. The project includes sanitization boundaries specifically for sensitive source information.

Please report security issues privately through GitHub's Security tab. Do not open a public issue containing credentials, playlist URLs, or personal data.

For contributors

Local setup and verification commands

Install Flutter stable, then run from the repository root:

flutter --disable-analytics
dart pub get
dart run melos bootstrap
dart run melos run format:check
dart run melos run analyze
dart run melos run test

Launch the macOS prototype with:

cd apps/tvium_app
flutter run -d macos

Before contributing, read Contributing, Architecture, and Security. Pull requests must use fictional .test fixtures and must never contain real IPTV credentials or copyrighted channel branding.

License

No open-source license has been selected yet. Until a license is published, normal copyright restrictions apply. See the licensing decision for the current position.