---

⚡ Response Speed: 1-2 Seconds | 🚀 Uptime: 99.9% High Availability | 💎 Audio Quality: Lossless 320kbps + 1080p HD Video

---

🎛️ 𝑪𝒐𝒎𝒎𝒂𝒏𝒅𝒔 & 𝑼𝒔𝒂𝒈𝒆 𝑴𝒂𝒏𝒖𝒂𝒍

🎵 𝑼𝒔𝒆𝒓 𝑷𝒍𝒂𝒚𝒃𝒂𝒄𝒌 𝑪𝒐𝒎𝒎𝒂𝒏𝒅𝒔 (Click to Expand)

Command	Description
/play <query/link>	Stream audio in group voice chat.
/vplay <query/link>	Stream HD video in group voice chat.
/cplay <query/link>	Stream audio in linked channel voice chat.
/cvplay <query/link>	Stream video in linked channel voice chat.
/queue	View the current queue of upcoming songs.
/playlist	View or play your personal saved playlist.
/lyrics <song name>	Search and fetch synchronized song lyrics.
/ping	Check bot latency, CPU load, and server uptime.
/stats	View global bot usage statistics.
/settings	Open interactive chat configuration menu.
/help	Open the interactive help panel.
/repo	Display repository information.

🎚️ 𝑨𝒅𝒎𝒊𝒏 𝑽𝒐𝒊𝒄𝒆 𝑪𝒉𝒂𝒕 𝑪𝒐𝒏𝒕𝒓𝒐𝒍𝒔 (Click to Expand)

Command	Description
/pause	Temporarily pause current track playback.
/resume	Resume playback from paused state.
/skip	Skip current track and play next in queue.
/end or /stop	Stop playback and clear the active queue.
/mute	Mute assistant in the group voice chat.
/unmute	Unmute assistant in the group voice chat.
/seek <seconds>	Jump forward or backward in active track.
/speed <0.5x - 2.0x>	Adjust stream playback speed.
/loop <1-10 / disable>	Repeat current track or active queue.
/shuffle	Randomize the order of queued tracks.

👑 𝑺𝒖𝒅𝒐 & 𝑶𝒘𝒏𝒆𝒓 𝑴𝒂𝒏𝒂𝒈𝒆𝒎𝒆𝒏𝒕 (Click to Expand)

Command	Description
/broadcast <text>	Broadcast an announcement to all served chats.
/gban <user_id>	Global ban malicious users across all bot chats.
/ungban <user_id>	Remove global ban from a user ID.
/restart	Restart bot and assistant sessions cleanly.
/update	Pull and merge latest updates from Git upstream.
/logs	Retrieve recent execution error and activity logs.

---

🚀 𝑫𝒆𝒑𝒍𝒐𝒚𝒎𝒆𝒏𝒕 𝑴𝒆𝒕𝒉𝒐𝒅𝒔

🟣 𝑶𝒏𝒆-𝑪𝒍𝒊𝒄𝒌 𝑯𝒆𝒓𝒐𝒌𝒖 𝑫𝒆𝒑𝒍𝒐𝒚𝒎𝒆𝒏𝒕

---

🚀 𝑽𝑷𝑺 𝑫𝒆𝒑𝒍𝒐𝒚𝒎𝒆𝒏𝒕

⚡ 𝑽𝒊𝒆𝒘 𝑽𝑷𝑺 𝑫𝒆𝒑𝒍𝒐𝒚𝒎𝒆𝒏𝒕 𝑪𝒐𝒎𝒎𝒂𝒏𝒅𝒔 (Click Here)

🔹 𝑺𝒕𝒆𝒑 𝟏: 𝑼𝒑𝒅𝒂𝒕𝒆 & 𝑼𝒑𝒈𝒓𝒂𝒅𝒆 𝑺𝒚𝒔𝒕𝒆𝒎

sudo apt-get update && sudo apt-get upgrade -y

🔹 𝑺𝒕𝒆𝒑 𝟐: 𝑪𝒍𝒐𝒏𝒆 𝑴𝒖𝒔𝒊𝒄𝑺𝒑 𝑹𝒆𝒑𝒐𝒔𝒊𝒕𝒐𝒓𝒚

git clone https://github.com/DevloperSP/MusicSp

🔹 𝑺𝒕𝒆𝒑 𝟑: 𝑬𝒏𝒕𝒆𝒓 𝑹𝒆𝒑𝒐𝒔𝒊𝒕𝒐𝒓𝒚 𝑫𝒊𝒓𝒆𝒄𝒕𝒐𝒓𝒚

cd MusicSp

🔹 𝑺𝒕𝒆𝒑 𝟒: 𝑹𝒖𝒏 𝑨𝒖𝒕𝒐𝒎𝒂𝒕𝒆𝒅 𝑺𝒆𝒕𝒖𝒑 𝑰𝒏𝒔𝒕𝒂𝒍𝒍𝒆𝒓

bash setup

🔹 𝑺𝒕𝒆𝒑 𝟓: 𝑪𝒐𝒏𝒇𝒊𝒈𝒖𝒓𝒆 𝑬𝒏𝒗𝒊𝒓𝒐𝒏𝒎𝒆𝒏𝒕 𝑽𝒂𝒓𝒊𝒂𝒃𝒍𝒆𝒔

cp sample.env .env && vi .env

🔹 𝑺𝒕𝒆𝒑 𝟔: 𝑺𝒕𝒂𝒓𝒕 𝑴𝒖𝒔𝒊𝒄𝑺𝒑 𝑩𝒐𝒕

bash start

---

🛠️ 𝑴𝒐𝒓𝒆 𝑫𝒆𝒑𝒍𝒐𝒚𝒎𝒆𝒏𝒕 𝑶𝒑𝒕𝒊𝒐𝒏𝒔 (Click to Expand)

🐳 𝑫𝒐𝒄𝒌𝒆𝒓 𝑪𝒐𝒏𝒕𝒂𝒊𝒏𝒆𝒓 𝑫𝒆𝒑𝒍𝒐𝒚𝒎𝒆𝒏𝒕

Deploy with containerization using the pre-configured Dockerfile:

# 1. Clone repository
git clone https://github.com/DevloperSP/MusicSp
cd MusicSp

# 2. Setup environment variables
cp sample.env .env
vi .env

# 3. Build Docker container image
docker build -t musicsp .

# 4. Run Docker container in detached mode
docker run -d --name musicsp_bot --env-file .env musicsp

💻 𝑴𝒂𝒏𝒖𝒂𝒍 𝑳𝒐𝒄𝒂𝒍 / 𝑫𝒆𝒗𝒆𝒍𝒐𝒑𝒎𝒆𝒏𝒕 𝑺𝒆𝒕𝒖𝒑

For local development and testing:

# 1. Clone repository
git clone https://github.com/DevloperSP/MusicSp && cd MusicSp

# 2. Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# 3. Install dependencies
pip install -U pip
pip install -U -r requirements.txt

# 4. Configure .env and run
cp sample.env .env
python3 -m MusicSp

---

⚙️ 𝑬𝒏𝒗𝒊𝒓𝒐𝒏𝒎𝒆𝒏𝒕 𝑽𝒂𝒓𝒊𝒂𝒃𝒍𝒆𝒔 (𝑪𝒐𝒏𝒇𝒊𝒈𝒖𝒓𝒂𝒕𝒊𝒐𝒏)

📋 𝑽𝒊𝒆𝒘 𝑭𝒖𝒍𝒍 𝑬𝒏𝒗𝒊𝒓𝒐𝒏𝒎𝒆𝒏𝒕 𝑽𝒂𝒓𝒊𝒂𝒃𝒍𝒆𝒔 𝑻𝒂𝒃𝒍𝒆

Variable	Required	Default	Description
API_ID	Yes	—	Telegram API ID from my.telegram.org.
API_HASH	Yes	—	Telegram API Hash from my.telegram.org.
BOT_TOKEN	Yes	—	Telegram Bot Token from @BotFather.
OWNER_ID	Yes	—	Telegram numeric ID of the bot owner.
MONGO_DB_URI	Yes	—	MongoDB Atlas connection URI string.
LOG_GROUP_ID	Yes	—	Telegram Private Group ID for logging (e.g., -100xxxxxxx).
STRING_SESSION	Yes	—	Pyrogram v2 / Kurigram String Session for Assistant 1.
STRING_SESSION2 - 5	Optional	None	Multi-assistant string sessions for load balancing.
SPOTIFY_CLIENT_ID	Optional	None	Spotify Developer API Client ID.
SPOTIFY_CLIENT_SECRET	Optional	None	Spotify Developer API Client Secret.
API_URL	Optional	None	Custom YouTube audio extraction API URL.
API_KEY	Optional	None	Authentication Key for custom YouTube API.
DURATION_LIMIT	Optional	1700	Maximum song duration limit in minutes.
AUTO_LEAVING_ASSISTANT	Optional	False	Auto-leave voice chat assistant when call terminates.

---

🏗️ 𝑺𝒚𝒔𝒕𝒆𝒎 𝑨𝒓𝒄𝒉𝒊𝒕𝒆𝒄𝒕𝒖𝒓𝒆

graph LR
    User([👤 Telegram User / Group]) -->|Commands / Play Request| Bot[🤖 MusicSp Bot Core]
    Bot -->|Async Query| DB[(🗄️ MongoDB Atlas)]
    Bot -->|Metadata Search| Fetcher[📡 YouTube / Spotify / Apple]
    Bot -->|Stream Dispatch| VC[🔊 PyTgCalls WebRTC Engine]
    VC -->|Audio & Video Feed| Call([🎙️ Group Voice Chat / Video Call])
    Assistant[👥 Assistant Userbot] -->|Active Call Participant| Call

Loading

---

🤝 𝑪𝒐𝒏𝒕𝒓𝒊𝒃𝒖𝒕𝒊𝒐𝒏 & 𝑳𝒊𝒄𝒆𝒏𝒔𝒆

Contributions are welcome! Follow these steps:

1. 🍴 Fork the Repository to your GitHub account.
2. 🌿 Create a Feature Branch: git checkout -b feature/cool-feature
3. ✍️ Commit Changes: git commit -m 'Add cool feature'
4. 🚀 Push Branch: git push origin feature/cool-feature
5. 📬 Submit a Pull Request to our main branch.

---

💬 𝑪𝒐𝒎𝒎𝒖𝒏𝒊𝒕𝒚 & 𝑺𝒖𝒑𝒑𝒐𝒓𝒕