reelnn

KO | EN

gitlite — search

#python #hacktoberfest #typescript #llm #deep-learning #docker #macos #java #nodejs #windows #awesome #awesome-list #pytorch #security

(★ 88)

A telegram index with TMDB api.

reelnn Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

---

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

</div>

---
<p align="center">
  <img src="https://media3.giphy.com/media/v1.Y2lkPTc5MGI3NjExcWFudzZ3aWk5ejZ1cXBoaXo2ZW9ldXh0emd4Z2pkeTFnaHdzaTlnaCZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/CClicUlLWi6pSJ7pu0/giphy.gif" />
</p>

# 🎬 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](https://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)](https://www.themoviedb.org/).
- 🔍 **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](https://github.com/rafsanbasunia/reelnn/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](https://choosealicense.com/licenses/mit/)

reelnn

reelnn Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

reelnn

reelnn Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README