Flow is a Telegram bot that helps you identify songs from voice messages, fetch lyrics, and provide links to listen to your favorite tracks.
- Identify Songs: Send a voice message, and Flow will recognize the song for you.
- Get Song Details: Retrieve the song title, artist name, and a link to listen to the song.
- Fetch Lyrics: Get lyrics for the identified song.
- Search Online: Provides quick buttons to search for the song on YouTube and Spotify.
- Start the Bot: Click here to open Flow on Telegram.
- Send a Voice Message: Flow will analyze and identify the song for you.
- Get More Info: After identification, you can request lyrics or search the song online.
- Use Commands:
/start
- Start the bot and see the welcome message./help
- Display the help menu./features
- View the bot's capabilities.
To run this bot locally, follow these steps:
- Python 3.7+
- Telegram Bot Token (from @BotFather)
- Shazam API Key
- Clone this repository:
git clone https://github.com/yourrepo/flow-bot.git cd flow-bot
- Install dependencies:
pip install -r requirements.txt
- Create a
.env
file and add your API keys:TELEGRAM_BOT_TOKEN=your_telegram_bot_token SHAZAM_API_KEY=your_shazam_api_key
- Run the bot:
python bot.py
The bot requires the following dependencies:
telebot
shazamio
asyncio
requests
beautifulsoup4
dotenv
Feel free to fork this repository and contribute by submitting pull requests.
This project is licensed under the MIT License.
Enjoy using Flow and enhance your music experience! 🎵