TikTok Video Download: Download TikTok videos without watermarks
Instagram Video Download: Download Instagram Reels, posts, and IGTV videos without watermarks
Image/Photo Support: Download TikTok and Instagram image collections
Caching: Redis-based caching to avoid re-downloading the same content
Rate Limiting: Built-in rate limiting to prevent abuse
Internationalization: Multi-language support (English, Russian)
Docker Support: Easy deployment with Docker Compose
TypeScript: Fully typed codebase for better development experience

📋 Prerequisites

Node.js >= 18
pnpm >= 9.15.9
Redis server
Telegram Bot Token

🛠️ Installation

Note

: This is an open-source project. You can either use the live bot or deploy your own instance.

1. Clone the repository

git clone https://github.com/yourusername/next-downloader-bot.git
cd next-downloader-bot

2. Install dependencies

pnpm install

3. Environment Setup

Create a .env file in the root directory:

# Telegram Bot Configuration
BOT_TOKEN=your_telegram_bot_token_here
TELEGRAM_API_ROOT=https://api.telegram.org

# Redis Configuration
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=your_redis_password_here

# Rate Limiting (optional, default: 5000ms)
RATE_LIMIT=5000

4. Development

# Start development mode
pnpm dev

# Build the project
pnpm build

# Start production mode
pnpm start

🐳 Docker Deployment

Quick Start: Use the live bot instead of deploying your own instance.

Quick Start with Docker Compose

Create your .env file with the required environment variables
Run the application:

docker-compose up -d

This will start:

Redis server with password protection
Telegram Bot API server
Next-Downloader-Bot application

Development with Docker

For development, use the development compose file:

docker-compose -f docker-compose.dev.yml up -d

📱 Usage

Using the Live Bot

Start the bot on Telegram
Send a TikTok or Instagram video or image URL
The bot will download and send you the content without watermarks

Self-Hosting

If you want to run your own instance:

Start a conversation with your bot on Telegram
Send a TikTok or Instagram video or image URL
The bot will download and send you the content without watermarks

Supported URL Formats

Short TikTok URLs: https://vt.tiktok.com/ZSHs35NpuL1nt-mE2tD
Instagram post URLs: https://www.instagram.com/p/SHORTCODE/

🏗️ Project Structure

Next-Downloader-Bot/
├── apps/
│   └── bot/                    # Main bot application
│       ├── src/
│       │   ├── bot/           # Bot logic and handlers
│       │   ├── config/        # Configuration files
│       │   ├── utils/         # Utility functions
│       │   └── index.ts       # Entry point
│       ├── locales/           # Internationalization files
│       └── package.json
├── packages/                   # Shared packages
│   ├── eslint-config/         # ESLint configuration
│   ├── typescript-config/     # TypeScript configuration
│   └── lint-staged-config/    # Lint-staged configuration
├── docker-compose.yml         # Production Docker setup
├── docker-compose.dev.yml     # Development Docker setup
└── package.json

🔧 Configuration

Environment Variables

Variable	Description	Required	Default
`BOT_TOKEN`	Telegram bot token from @BotFather	✅	-
`TELEGRAM_API_ROOT`	Telegram API root URL	✅	-
`REDIS_HOST`	Redis server host	❌	`redis`
`REDIS_PORT`	Redis server port	❌	`6379`
`REDIS_PASSWORD`	Redis server password	✅	-
`RATE_LIMIT`	Rate limit in milliseconds	❌	`5000`

Redis Configuration

The bot uses Redis for caching downloaded videos to avoid re-downloading the same content. Make sure Redis is properly configured with:

Password protection enabled
Sufficient memory for caching
Proper TTL settings

🧪 Development

Available Scripts

# Install dependencies
pnpm install

# Development mode
pnpm dev

# Build the project
pnpm build

# Start production
pnpm start

# Lint code
pnpm lint

# Format code
pnpm format

# Run tests
pnpm test:unit
pnpm test:e2e

Code Quality

The project uses:

ESLint for code linting
Prettier for code formatting
TypeScript for type safety
Husky for git hooks
Lint-staged for pre-commit checks

🌐 Internationalization

The bot supports multiple languages. Language files are located in apps/bot/locales/:

en.ftl - English
ru.ftl - Russian

To add a new language:

Create a new .ftl file in the locales directory
Add the language to the bot configuration
Update the language detection logic

📊 Monitoring

The bot includes comprehensive logging using Pino:

Request/response logging
Error tracking
Performance monitoring
Rate limit tracking

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature')
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Disclaimer

This bot is for educational purposes only. Please respect TikTok's and Instagram's terms of service and copyright laws. Users are responsible for ensuring they have the right to download and use the content.

🆘 Support

If you encounter any issues:

Check the Issues page
Create a new issue with detailed information
Include logs and error messages

README.md

Next-Downloader-Bot

🤖 Try the Bot

🚀 Features