🎬 MediaSaveBot

A powerful Telegram bot for downloading media from Instagram, Pinterest, Spotify, and YouTube. Built with Go and gotgbot.

🚀 Quick Start • ✨ Features • 📦 Installation • 💬 Support • ⭐ Star Us

✨ Features

📥 Multi-Platform Media Downloads

📸 Instagram - Photos, videos, carousels, reels
📌 Pinterest - Pins, boards, high-quality images
🎵 Spotify - Tracks, albums, playlists with metadata
🎬 YouTube - Videos, shorts, audio extraction

🤖 Smart Bot Features

⚡ One-Click Download - Just send a link
📊 User Statistics - Track bot usage (Admin only)
📢 Broadcast Messages - Send to all users with progress tracking
🛑 Stop Broadcast - Cancel active broadcasts instantly
💾 User Database - MongoDB integration for user tracking

🔐 Advanced Functionality

✅ Admin Authentication - Secure admin commands
🔄 Retry Mechanism - Handle Telegram flood limits
🚫 Duplicate Prevention - Prevent concurrent requests per user
⚙️ Batch Processing - Download multiple tracks at once
📈 Progress Indicators - Real-time download status

🚀 Quick Start

Prerequisites

Go 1.24.0 or higher
MongoDB 4.4+ (optional, for user tracking)
Telegram Bot Token (create via @BotFather)

Installation

Clone the Repository

git clone https://github.com/Beesonn/MediaSaveBot.git
cd MediaSaveBot

Install Dependencies
```
go mod download
go mod tidy
```

Set Environment Variables

# Required
export TOKEN="your-telegram-bot-token"

# Optional (for user tracking)
export MONGODB_URI="mongodb://localhost:27017"

# Optional (for admin commands - space-separated user IDs)
export ADMIN="123456789 987654321"

Run the Bot
```
go run main.go
```

📋 Commands

Command	Description	Access	Example
`/start`	Initialize bot & show welcome message	Public	Send `/start` to the bot
`/stats`	View total active users	Admin	`/stats`
`/broadcast`	Send message to all users	Admin	Reply to a message with `/broadcast`

🎯 How to Use

Download from Instagram

Send any Instagram link (instagram.com or instagr.am)
Bot automatically detects and downloads
Receive media with captions

Example: https://www.instagram.com/p/ABC123XYZ/

Download from Pinterest

Send Pinterest link (pinterest.com or pin.it)
Instant high-quality image download
Multiple images in one go

Example: https://www.pinterest.com/pin/123456789/

Download Spotify Music

Send Spotify track, album, or playlist link
Bot shows found tracks count
Downloads with artist & title metadata
Handles playlists with batch processing

Example: https://open.spotify.com/track/ABC123XYZ

Admin: Broadcast Messages

Reply to any message with /broadcast
Message sends to all active users
Real-time progress shows
Use 🛑 button to stop

📂 Project Structure

MediaSaveBot/
├── 📄 main.go                    # Entry point & bot dispatcher
├── 📄 go.mod                     # Go dependencies
├── 📄 go.sum                     # Dependency checksums
├── 📄 LICENSE                    # MIT License
├── 📄 README.md                  # This file
│
├── 🤖 bot/
│   ├── commands.go              # /start, /stats, /broadcast handlers
│   └── admin.go                 # Admin functions, broadcast logic
│
├── 💾 database/
│   └── db.go                    # MongoDB user operations
│
└── 🛠️ utils/
    ├── instagram.go             # Instagram downloader
    ├── pinterest.go             # Pinterest downloader
    └── spotify.go               # Spotify downloader

🔧 Configuration

Environment Variables

# ⚠️ REQUIRED
TOKEN="your-telegram-bot-token"

# Optional but recommended
MONGODB_URI="mongodb://username:password@localhost:27017"
ADMIN="123456789 987654321 111111111"  # Space-separated admin IDs

Setup Steps

Get Telegram Bot Token
- Chat with @BotFather on Telegram
- Create new bot with /newbot
- Copy the token

Setup MongoDB (Optional)

# Using Docker
docker run -d -p 27017:27017 --name mongodb mongo:latest

# Connection string: mongodb://localhost:27017

Set Admin IDs
- Get your Telegram User ID from @userinfobot
- Add to ADMIN environment variable

📊 Supported Platforms

Platform	Support	Features
📸 Instagram	✅ Full	Photos, Videos, Carousels, Captions
📌 Pinterest	✅ Full	Images, High Quality, Metadata
🎵 Spotify	✅ Full	Tracks, Albums, Playlists, Audio
🎬 YouTube	🔄 Planned	Video & Audio Downloads

🏗️ Architecture

Handler Flow

User sends link
    ↓
/HandleMessage detects platform (regex)
    ↓
Platform-specific handler (Instagram/Pinterest/Spotify)
    ↓
dlkitgo library processes download
    ↓
Send media back to user

Admin Operations

Admin sends /broadcast
    ↓
Database fetches all users
    ↓
Loop through users with batch sending
    ↓
Real-time progress updates
    ↓
User can stop with callback button

Database Schema

// MongoDB - media_save_bot.users
{
  _id: ObjectId(),
  user_id: 123456789,        // Telegram User ID
  name: "John Doe"           // User's first name
}

🔐 Security Features

✅ Admin Authentication - Only whitelisted users can use admin commands
✅ Flood Wait Handling - Automatic retry with exponential backoff
✅ Rate Limiting - Prevents duplicate concurrent requests per user
✅ Error Handling - Graceful degradation with user-friendly messages
✅ Input Validation - Regex pattern matching for URLs

📦 Dependencies

// Telegram Bot Framework
github.com/PaulSonOfLars/gotgbot/v2 v2.0.0-rc.34

// Media Download Kit
github.com/Beesonn/dlkitgo v1.2.4

// Database Driver
go.mongodb.org/mongo-driver v1.17.9

💻 System Requirements

Component	Minimum	Recommended
Go	1.21.0	1.24.0+
RAM	128 MB	512 MB
Disk	100 MB	500 MB
Network	512 kbps	5 Mbps
OS	Linux/macOS/Windows	Linux (Ubuntu 20.04+)

🚀 Deployment

Local Development

go run main.go

Docker Deployment

FROM golang:1.24-alpine

WORKDIR /app
COPY . .

RUN go mod download
RUN go build -o mediasavebot .

ENV TOKEN=""
ENV MONGODB_URI=""
ENV ADMIN=""

CMD ["./mediasavebot"]

Build & Run

docker build -t mediasavebot .
docker run -e TOKEN="your-token" mediasavebot

🆘 Troubleshooting

Bot doesn't respond

✅ Check if TOKEN environment variable is set
✅ Verify token is valid from @BotFather
✅ Check internet connection

Download fails

✅ Verify the link format is correct
✅ Ensure media still exists on the platform
✅ Check if bot has sufficient permissions

MongoDB connection error

✅ Verify MONGODB_URI format: mongodb://host:port
✅ Check if MongoDB service is running
✅ Database is optional; bot works without it

Admin commands don't work

✅ Verify your User ID is in ADMIN variable
✅ Make sure ID format is correct (digits only)
✅ Restart bot after changing ADMIN IDs

📞 Support

Get Help

💬 Support Group: @XBOTSUPPORTS
📢 Updates Channel: @BeesonsBots
🐛 Bug Reports: GitHub Issues

🤝 Contributing

We welcome contributions! Here's how:

Fork the repository

git clone https://github.com/YOUR-USERNAME/MediaSaveBot.git

Create feature branch
```
git checkout -b feature/amazing-feature
```

Make your changes

git add .
git commit -m "Add amazing feature"

Push to branch
```
git push origin feature/amazing-feature
```
Open Pull Request
- Describe your changes clearly
- Link any related issues
- Include screenshots/examples

📝 License

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

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions...

🌟 Show Your Support

If MediaSaveBot helps you, please consider:

⭐ Star this repository
🔗 Share with friends
🐛 Report bugs if you find any
💡 Suggest features you'd like
🤝 Contribute to the project

Give us a Star! ⭐

https://github.com/Beesonn/MediaSaveBot

📈 Project Statistics

Language: Go 100%
License: MIT
Created: March 2026
Last Updated: April 2026
Status: Active Development ✅

🔗 Quick Links

Link	Purpose
🤖 Telegram Bot	Try the bot live
💬 Support Group	Get help & discuss
📢 Updates Channel	Latest updates
🐛 Issues	Report problems
🍴 Fork	Contribute code

📧 Contact

Developer: @Beesonn
Telegram: @XBOTSUPPORTS

Made with ❤️ by Beesonn

⬆ back to top

Name		Name	Last commit message	Last commit date
Latest commit History 63 Commits
bot		bot
database		database
utils		utils
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
go.mod		go.mod
go.sum		go.sum
main.go		main.go

Folders and files

Latest commit

History

Repository files navigation

🎬 MediaSaveBot

✨ Features

📥 Multi-Platform Media Downloads

🤖 Smart Bot Features

🔐 Advanced Functionality

🚀 Quick Start

Prerequisites

Installation

📋 Commands

🎯 How to Use

Download from Instagram

Download from Pinterest

Download Spotify Music

Admin: Broadcast Messages

📂 Project Structure

🔧 Configuration

Environment Variables

Setup Steps

📊 Supported Platforms

🏗️ Architecture

Handler Flow

Admin Operations

Database Schema

🔐 Security Features

📦 Dependencies

💻 System Requirements

🚀 Deployment

Local Development

Docker Deployment

Build & Run

🆘 Troubleshooting

Bot doesn't respond

Download fails

MongoDB connection error

Admin commands don't work

📞 Support

Get Help

🤝 Contributing

📝 License

🌟 Show Your Support

Give us a Star! ⭐

📈 Project Statistics

🔗 Quick Links

📧 Contact

Made with ❤️ by Beesonn

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages