https://github.com/0xafz/pixel
Youtube Downloader Telegram Bot
https://github.com/0xafz/pixel
hydrogram python redis yt-dlp
Last synced: 12 months ago
JSON representation
Youtube Downloader Telegram Bot
- Host: GitHub
- URL: https://github.com/0xafz/pixel
- Owner: 0xAFz
- License: gpl-3.0
- Created: 2024-10-31T22:38:09.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-28T12:21:49.000Z (about 1 year ago)
- Last Synced: 2025-01-28T13:36:57.242Z (about 1 year ago)
- Topics: hydrogram, python, redis, yt-dlp
- Language: Python
- Homepage:
- Size: 18.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pixel
A powerful and user-friendly Telegram bot that enables users to download audio and video content from YouTube using the robust yt-dlp library. This bot provides a convenient interface for downloading YouTube content directly through Telegram.
## Prerequisites
### Local Development Requirements
- Python3
- FFmpeg
- Docker
- Docker Compose plugin
### Production Requirements
- Docker
- Docker Compose plugin
## Local Development Setup
### 1. Environment Configuration
First, create your environment file by copying the example:
```bash
cp .env.example .env
```
Edit the `.env` file with your actual configuration values:
```bash
vim .env
```
### 2. Start Required Services
Launch the necessary Docker services:
```bash
docker compose up -d
```
### 3. Run the Application
Execute the Python application:
```bash
python3 main.py
```
## Production Setup
### 1. Environment Configuration
Create your environment file by copying the example:
```bash
cp .env.example .env
```
Edit the `.env` file with your production configuration values:
```bash
vim .env
```
### 2. Build and Run
Build and start the production containers:
```bash
docker compose -f prod.compose.yml up --build -d
```
## Important Notes
- Always ensure your `.env` file contains the correct configuration for your environment
- Never commit the `.env` file to version control
- The production setup uses a separate Docker Compose file (`prod.compose.yml`) optimized for production use
- Make sure all required ports specified in your Docker configuration are available
- Back up any important data before running production deployments
## Troubleshooting
If you encounter issues:
1. Check if all prerequisites are properly installed
2. Verify your `.env` configuration
3. Ensure all required ports are available
4. Check Docker logs if services fail to start:
```bash
docker compose logs
```
For production issues:
```bash
docker compose -f prod.compose.yml logs
```