Skip to content

rafsanbasunia/reelnn

Repository files navigation


🌟 Love this project? Give it a star! It really helps! 🌟


🎬 reelnn - A Self-Hosted Streaming Web App Using Telegram

reelnn (reel-inn) is a self-hosted media web app that allows users to stream and manage their personally owned videos directly from Telegram. Built with Next.js for the frontend and Python for the backend, it uses Telegram as a storage backend — removing the need for traditional video hosting services.

⚠️ Important: This tool is designed only for legal, personal use. It does not host or provide any copyrighted content.


🌐 Demo

reelnn.vercel.app

🧪 Note: The demo uses public domain videos and placeholder metadata purely for demonstration purposes.


🚀 Features

  • 📂 Telegram Storage: Streams video files directly from Telegram bots or private channels.
  • 🎞️ TMDb Integration: Automatically fetches metadata from The Movie Database (TMDb).
  • 🔍 Search & Discover: Find your media easily with a responsive search interface.
  • Fast & Lightweight: Powered by Next.js and optimized for performance.
  • 🔐 Secure API: Secured backend with Next.js API routes.
  • 🎥 Embedded Player: Watch videos directly in-browser.
  • 🧠 Metadata Caching: Smart caching for faster load times.
  • 🎚️ Custom Homepage: Manage homepage layout via a content manager.
  • ⬇️ Download Option: Download media via browser or Telegram.
  • 🗄️ MongoDB Support: Simple and fast database for storing metadata.
  • 🔗 Shortener Support: Built-in support for URL shorteners.
  • ➕ More features coming soon!

🧠 How It Works

  1. Upload: Upload your own video files (MP4, MKV, etc.) to a private Telegram group or channel.
  2. Indexing: The backend extracts basic info and fetches metadata from TMDb.
  3. Display: Media appears instantly on your site with artwork and descriptions.
  4. Stream or Download: Watch or download the media via Telegram-based storage.

🛠️ Installation

To use reelnn, you must deploy the backend first.

➡️ Backend Setup

👉 Follow the guide at Setup Wiki


⚠️ Legal Disclaimer

  • This tool is designed solely for personal use to stream and organize legally owned media files.
  • No copyrighted content is included, hosted, or distributed.
  • You are fully responsible for the content you upload to Telegram.
  • This project does not promote or support piracy in any form.
  • This product uses the TMDb API but is not endorsed or certified by TMDb.

🤝 Contributing

PRs are welcome! For major changes, please open an issue first to discuss what you’d like to add or fix.


📄 License

MIT

Releases

No releases published

Packages

 
 
 

Contributors

Languages