Triboon

Self-hosted streaming for movies, shows, local libraries, music, subtitles, Trakt, and Live TV. Press Play and Triboon finds, mounts, and streams the best healthy source.

Latest release | Android TV APK | Android Mobile APK | Quick start | Unraid

What It Does

Triboon is a Plex-polished, Stremio-style app you run yourself. The admin adds providers, indexers, metadata, subtitles, Trakt, local folders, and optional IPTV playlists. Users sign in, pick a profile, browse, and press Play.

Playback is built around speed:

source-fit -> direct play -> remux -> transcode

That means Triboon tries to choose the right source first, direct-play whenever the device can handle it, and only remux or transcode when the client needs help.

Highlights

• Movies and TV shows with TMDB metadata, detail pages, seasons, episodes, recommendations, cast pages, watchlist, and Continue Watching.
• Best-source search across Newznab-compatible indexers, with quality caps, title verification, health checks, and automatic source failover.
• Usenet streaming directly from archives while they are still remote, with Range seeking and resume support.
• Local libraries for owned media, with lazy loading so large folders do not freeze the app.
• Live TV through M3U or Xtream playlists, including source-scoped caches, guide data, favorites, Android TV native playback, and browser remux.
• Wyzie subtitles, audio-track selection, subtitle sync, Trakt import/export, Music, Android TV shell, and Unraid-friendly Docker hosting.
• Multi-user profiles, invite links, Quick Connect, profile PINs, and encrypted settings.

Quick Start

Docker is the easiest way to run Triboon:

docker compose up --build

Open:

http://localhost:7777

Then:

1. Create the owner account.
2. Open Settings.
3. Add TMDB, usenet, and a Newznab-compatible indexer.
4. Optionally add Wyzie subtitles, Trakt, local libraries, music, or Live TV.
5. Browse and press Play.

Plain Node also works when Node 24+ is installed:

node server/index.js

ffmpeg is optional but strongly recommended. Without ffmpeg, some browser or device combinations may need external-player handoff instead of in-app remux or transcode.

Android APKs

The stable Android TV download is always:

https://github.com/d1same/triboon/releases/latest/download/triboon-tv.apk

The stable Android phone/tablet download is always:

https://github.com/d1same/triboon/releases/latest/download/triboon-mobile.apk

Each release also keeps versioned APKs for history:

triboon-tv-vX.Y.Z.apk
triboon-mobile-vX.Y.Z.apk

The APK filename does not control Android updates. Android accepts an update when the package id and signing key match and the new versionCode is higher.

Unraid

Use the published image:

ghcr.io/d1same/triboon:latest

Recommended mappings:

• /data -> /mnt/user/appdata/triboon
• Optional local media share -> /media as read-only

Recommended environment:

• PUID and PGID for your Unraid user/group
• UMASK
• TRIBOON_SECRET so sessions and encrypted settings survive rebuilds

The Unraid template lives in unraid/triboon.xml.

Security And Privacy

• Credentials and provider settings are encrypted at rest in the data folder.
• API routes are deny-by-default and covered by route tests.
• Stream URLs use signed, scoped tokens.
• IPTV/provider URLs with credentials are redacted from logs and caches.
• Local runtime data, logs, old APKs, screenshots, and secrets are ignored by git.
• Development-only test/demo folders are excluded from GitHub source archives.

Do not commit your data/ folder, .env files, API keys, cookies, provider credentials, logs, or personal media/test captures.

Development

The server intentionally keeps runtime dependencies light: Node 24 LTS and the standard library in server/, with approved external binaries such as ffmpeg and yt-dlp.

Run the app locally:

npm start

Run the verification suite:

npm test

Build the Android debug APK:

$env:JAVA_HOME='C:\Program Files\Android\Android Studio\jbr'
$env:ANDROID_HOME="$env:LOCALAPPDATA\Android\Sdk"
gradle -p android assembleDebug

The APK output is:

android/app/build/outputs/apk/debug/app-debug.apk

If a current external Gradle is not installed, use the pinned wrapper from the android/ folder:

.\gradlew.bat assembleDebug

Project Map

• server/ - API, auth, source search, usenet streaming, IPTV, subtitles, Trakt, remux/transcode, persistence, and static serving.
• web/index.html - the single-file web UI used by browser, desktop wrapper, and Android WebView shell.
• android/ - Android TV shell with D-pad bridge and native Media3/ExoPlayer.
• unraid/ - Unraid template.
• docs-architecture.md - deeper architecture and data-flow notes.
• docs-player-regression-map.md - player behavior contracts and regression checklist.
• docs-release-audit.md - release verification history.

Legal

Triboon is for legally obtained content only. You are responsible for the providers, playlists, indexers, files, and accounts you configure.