{"id":30800561,"url":"https://github.com/ashokshau/tgstream","last_synced_at":"2025-09-05T20:09:38.520Z","repository":{"id":310477227,"uuid":"1039999267","full_name":"AshokShau/TgStream","owner":"AshokShau","description":"A high-performance file streaming service built with Python that allows you to stream files directly from Telegram.","archived":false,"fork":false,"pushed_at":"2025-08-18T11:29:44.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-18T12:14:50.486Z","etag":null,"topics":["pytdbot","python","streaming","telegram","tg"],"latest_commit_sha":null,"homepage":"https://t.me/FallenProjects","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AshokShau.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-18T09:58:49.000Z","updated_at":"2025-08-18T11:29:47.000Z","dependencies_parsed_at":"2025-08-18T12:15:07.123Z","dependency_job_id":"3aa11419-9f96-4120-b312-ee96e5b3ed4c","html_url":"https://github.com/AshokShau/TgStream","commit_stats":null,"previous_names":["ashokshau/tgstream"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/AshokShau/TgStream","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshokShau%2FTgStream","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshokShau%2FTgStream/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshokShau%2FTgStream/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshokShau%2FTgStream/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AshokShau","download_url":"https://codeload.github.com/AshokShau/TgStream/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshokShau%2FTgStream/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273813835,"owners_count":25172892,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["pytdbot","python","streaming","telegram","tg"],"created_at":"2025-09-05T20:09:33.145Z","updated_at":"2025-09-05T20:09:38.507Z","avatar_url":"https://github.com/AshokShau.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TgStream - Telegram File Streaming Service\n\nA high-performance file streaming service built with Python that allows you to stream files directly from Telegram.\n\n## Features\n\n- Stream files directly from Telegram using url\n- Built with asyncio for high performance\n- Containerized with Docker for easy deployment\n- Environment-based configuration\n- Lightweight and efficient\n\n## 🛠️ Installation\n\n### Option 1: Manual Installation\n\n```bash\n# 1. Install system dependencies\nsudo apt-get install python3-pip tmux -y\n\n# 2. Install uv (Python package manager)\npip3 install uv\n\n# 3. Clone the repository\ngit clone https://github.com/AshokShau/TgStream\n\ncd TgStream\n\n# 4. Create virtual environment\nuv venv\n\n# 5. Activate virtual environment\nsource .venv/bin/activate\n\n# 6. Install dependencies\nuv pip install -e .\n\n# 7. Copy and edit environment file\ncp sample.env .env\nnano .env\n\n# 8. Run the bot\nstart\n```\n\n### Option 2: Docker Deployment (Recommended)\n\n```bash\n# 1. Build the Docker image\ndocker build -t tg-stream .\n\n# 2. Run the container (Make sure to create a .env file first)\ndocker run -d --name songbot --env-file .env tg-stream\n```\n\n## Project Structure\n\n```text\nTgStream/\n├── src/                    # Source code\n│   ├── api/               # API endpoints\n│   ├── __init__.py        # Package initialization\n│   ├── __main__.py        # Entry point\n│   └── config.py          # Configuration settings\n├── .dockerignore          # Docker ignore file\n├── .env                   # Environment variables\n├── .gitignore             # Git ignore file\n├── Dockerfile             # Docker configuration\n├── pyproject.toml         # Project metadata and dependencies\n└── README.md              # This file\n```\n\n# Usage\n\nhttp://0.0.0.0:5069/stream?url=https://t.me/username/12345\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashokshau%2Ftgstream","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashokshau%2Ftgstream","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashokshau%2Ftgstream/lists"}