Skip to content

harshramuos/ShrutiMusic

 
 

Repository files navigation

ShrutiMusicBot Logo

🎵 Shruti Music Bot 🎵

A Powerful Telegram Music Bot to Play Songs in Voice Chats

Support Channel Support Group Owner

GitHub Forks GitHub Stars GitHub Contributors

Deploy to Heroku

🚀 Deploy to Render (Free)

Deploy to Render

✨ Features

  • Play Music: Stream high-quality music in Telegram voice chats
  • Multiple Sources: YouTube, Spotify, SoundCloud, and local files
  • Playlists: Create and manage playlists for your group
  • Multi-Language: Available in multiple languages
  • Elegant UI: Clean and modern user interface
  • Group Management: Powerful admin commands
  • High Quality: Crystal clear audio streaming

📊 Repository Stats

Repo Size Issues Forks Stars LICENSE Last Commit

🔥 Essential Commands

Command Description
/play Play song from YouTube
/pause Pause the current stream
/resume Resume the paused stream
/skip Skip to the next song
/stop Stop the streaming
/playlist Show the playlist
/song Download a song as audio
/settings Open bot settings

🚀 Deployment Guide

🔧 VPS Deployment (Step by Step)

Prerequisites

First, update your system and install required packages:

sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install python3-pip ffmpeg git -y

Clone the Repository

git clone https://github.com/NoxxOP/ShrutiMusicBot
cd ShrutiMusicBot

Setup Virtual Environment

python3 -m venv venv
source venv/bin/activate

Install Dependencies

pip3 install -U pip
pip3 install -U -r requirements.txt

Configuration

Copy example config file and edit it with your values:

cp sample.env .env
nano .env

Fill in your:

  • API_ID & API_HASH from my.telegram.org
  • BOT_TOKEN from @BotFather
  • SESSION_STRING (Generate using session generator bot)
  • MUSIC_BOT_NAME (your bot name)
  • SUDO_USERS (your user ID)

Starting the Bot

There are two ways to start the bot:

  1. Using Python directly:
python3 -m ShrutiMusic
  1. Using Bash script:
bash start

Running in Background with Screen

To keep the bot running in background:

screen -S shrutibot
bash start

To detach the screen, press Ctrl+A then D

To reattach the screen later:

screen -r shrutibot

☁️ Heroku Deployment

Deploy to Heroku

  1. Click the button above
  2. Fill in the required details:
    • App name
    • API_ID & API_HASH
    • BOT_TOKEN
    • MUSIC_BOT_NAME
    • SESSION_STRING
    • SUDO_USERS (your User ID)
  3. Click "Deploy App"
  4. Once deployed, go to Resources tab and turn on the worker

🔄 How to Generate Session String

Use our Session Generator Bot: @ShrutiSessionBot

  1. Start the bot
  2. Send phone number with country code
  3. Enter the OTP
  4. Your session string will be generated

🤔 Common Issues & Fixes

  • Bot not responding: Check if the bot is running and has proper permissions
  • No sound in VC: Ensure ffmpeg is properly installed
  • Can't join voice chat: Make sure the bot is an admin with voice chat permissions
  • API Issues: Double check your API_ID and API_HASH

🌟 Credits and Acknowledgements

  • NoxxOP: Main Developer
  • All contributors who helped make this project better

📝 License

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

📞 Support

For any questions or help, join our Support Group

Made with love


🎵 Enjoy Streaming Music with Shruti Bot! 🎵

About

# 🎵 ShrutiMusic - Telegram Music Bot 🎧 ᴀᴅᴠᴀɴᴄᴇᴅ ᴛᴇʟᴇɢʀᴀᴍ ᴍᴜꜱɪᴄ ʙᴏᴛ ꜰᴏʀ ɢʀᴏᴜᴘ ᴠᴏɪᴄᴇ ᴄʜᴀᴛꜱ | ʏᴏᴜᴛᴜʙᴇ, ꜱᴘᴏᴛɪꜰʏ & ᴍᴏʀᴇ | ʜɪɢʜ ǫᴜᴀʟɪᴛʏ ᴍᴜꜱɪᴄ ᴘʟᴀʏʙᴀᴄᴋ | ᴄᴜꜱᴛᴏᴍɪᴢᴀʙʟᴇ & ᴜꜱᴇʀ-ꜰʀɪᴇɴᴅʟʏ | ᴘᴏᴡᴇʀᴇᴅ ʙʏ ᴘʏᴛɢᴄᴀʟʟꜱ | ᴍᴀɪɴᴛᴀɪɴᴇᴅ ʙʏ @ᴡᴛꜰ_ᴡʜʏᴍᴇᴇʜ | ꜱᴜᴘᴘᴏʀᴛ: @ꜱʜʀᴜᴛɪʙᴏᴛꜱᴜᴘᴘᴏʀᴛ 🎵

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 98.9%
  • Other 1.1%