https://github.com/ashokshau/tgstream
A high-performance file streaming service built with Python that allows you to stream files directly from Telegram.
https://github.com/ashokshau/tgstream
pytdbot python streaming telegram tg
Last synced: 10 months ago
JSON representation
A high-performance file streaming service built with Python that allows you to stream files directly from Telegram.
- Host: GitHub
- URL: https://github.com/ashokshau/tgstream
- Owner: AshokShau
- License: mit
- Created: 2025-08-18T09:58:49.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-08-18T11:29:44.000Z (11 months ago)
- Last Synced: 2025-08-18T12:14:50.486Z (11 months ago)
- Topics: pytdbot, python, streaming, telegram, tg
- Language: Python
- Homepage: https://t.me/FallenProjects
- Size: 27.3 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TgStream - Telegram File Streaming Service
A high-performance file streaming service built with Python that allows you to stream files directly from Telegram.
## Features
- Stream files directly from Telegram using url
- Built with asyncio for high performance
- Containerized with Docker for easy deployment
- Environment-based configuration
- Lightweight and efficient
## 🛠️ Installation
### Option 1: Manual Installation
```bash
# 1. Install system dependencies
sudo apt-get install python3-pip tmux -y
# 2. Install uv (Python package manager)
pip3 install uv
# 3. Clone the repository
git clone https://github.com/AshokShau/TgStream
cd TgStream
# 4. Create virtual environment
uv venv
# 5. Activate virtual environment
source .venv/bin/activate
# 6. Install dependencies
uv pip install -e .
# 7. Copy and edit environment file
cp sample.env .env
nano .env
# 8. Run the bot
start
```
### Option 2: Docker Deployment (Recommended)
```bash
# 1. Build the Docker image
docker build -t tg-stream .
# 2. Run the container (Make sure to create a .env file first)
docker run -d --name songbot --env-file .env tg-stream
```
## Project Structure
```text
TgStream/
├── src/ # Source code
│ ├── api/ # API endpoints
│ ├── __init__.py # Package initialization
│ ├── __main__.py # Entry point
│ └── config.py # Configuration settings
├── .dockerignore # Docker ignore file
├── .env # Environment variables
├── .gitignore # Git ignore file
├── Dockerfile # Docker configuration
├── pyproject.toml # Project metadata and dependencies
└── README.md # This file
```
# Usage
http://0.0.0.0:5069/stream?url=https://t.me/username/12345