Skip to content
TheAceOfficialsPublic

Repository files navigation

NoxMedia Banner

Transform your Android device into a private, high-performance media server powered by Telegram's infinite cloud storage.

Documentation Reddit Community Platform Kotlin Python Jellyfin Bridge Patreon License

Explore the Official Documentation & Setup Guides →


What is NoxMedia?

NoxMedia is an advanced, standalone Android application that transforms your smartphone or tablet into a private, self-hosted media streaming server and Jellyfin bridge.

By interfacing directly with Telegram's content delivery network through an embedded MTProto pipeline, NoxMedia parses, catalogs, enriches, and serves media files stored in your monitored Telegram channels straight to modern media players—with zero-latency byte-range seeking, automatic anime episode mapping, and zero external PC or hosting requirements.


Why NoxMedia?

  • Unlimited Cloud Media Vault: Upload or forward your 4K HDR movies, series, and anime to private Telegram channels. NoxMedia streams them on demand without consuming local device storage.
  • Hardware-Decoded DirectPlay: Streams raw byte chunks directly to client hardware decoders (ExoPlayer, Infuse, Vesper), preserving native 4K HDR10, Dolby Vision, and multi-channel audio tracks with zero server transcoding overhead.
  • Under 5W Power Consumption: Run 24/7 on a spare Android phone or tablet without needing noisy NAS enclosures, expensive hard drives, or home servers.
  • AI-Powered & Custom Shelves: Curate themed catalogs using Google Gemini or OpenRouter LLM engines, or build rules based on resolution, IMDb scores, and genres.
  • Cross-Platform Ecosystem: Stream seamlessly to Apple TV, iPhone, iPad, Mac, Windows, Linux, Android TV, and Smart TVs.

Supported Players & Clients

Player Supported Hardware Connection Protocol Setup Guide
Firecore Infuse Apple TV 4K, iPhone, iPad, Mac, Vision Pro Jellyfin Direct Mode (:7788) Infuse Guide →
Vesper macOS, iOS, iPadOS, tvOS, visionOS Jellyfin Server (:7788) Vesper Guide →
Nuvio Android (Phone/TV), Windows, Linux, macOS, Smart TVs Stremio Addon Protocol (:7788/manifest.json) Nuvio Guide →

Quick Start

  1. Install NoxMedia: Download the latest APK from GitHub Releases on your Android device (Android 7.0+).
  2. Log in: Enter your Telegram API credentials (api_id & api_hash from my.telegram.org) and authenticate with your phone number or Pyrogram session string.
  3. Connect Channels: Add your public channel (@channelname) or private channel ID (-100...). NoxMedia will automatically index your media.
  4. Stream: Start the server and connect your preferred client (Infuse, Vesper, or Nuvio) using your local IP (e.g., http://192.168.1.15:7788).

For comprehensive step-by-step instructions, finding private channel IDs, and configuring Tailscale for 24/7 remote streaming, visit the Official Documentation Website.


Community & Support

Join the official r/NoxMedia Subreddit to ask questions, share setups, request features, and connect with other users.

NoxMedia is 100% free and open-source under the AGPLv3 license. If you love using NoxMedia or want to support future developments by @TheAceOfficials, consider backing on Patreon:

Support on Patreon

  • Coffee Supporter ($3/mo): Supporter credit in GitHub & App UI + early dev updates.
  • Priority Feature Requester ($5/mo): Fast-track feature requests & direct roadmap input.
  • Supporter Hall of Fame ($10/mo): Official Sponsor Logo/Link across all @TheAceOfficials projects.

Acknowledgements & Roots

  • Telegram-Stremio: For the foundational concept of streaming Telegram media directly to media players.
  • Pyrogram: Elegant, high-performance Telegram MTProto framework in Python.
  • Chaquopy: The Python SDK for Android enabling native embedded MTProto pipelines inside Jetpack Compose.
  • Firecore Infuse, Vesper & Nuvio: For providing world-class player ecosystems across mobile, desktop, and home theater screens.

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPLv3).
Built with passion by TheAceOfficials.