/music-tool-bot

The one and only Telegram bot you need to manage your music files

Primary LanguagePythonMIT LicenseMIT

Music Tool Bot

The one and only Telegram bot you want to manage your music and MP3 files. Check it out here: @MusicToolBot

Supports 2 languages for now: English and Persian. (Add more if you want)

Requirements to run this bot

  1. Python 3.8 or higher (Preferably)
  2. ffmpeg
  3. venv
  4. Optionally you can install pm2 (globally) which is a Node.js module to manage processes. Since pm2 can also manage Python processes, I use it to run the bot in production. No Node.js/JavaScript knowledge is required. Just install pm2 and run convenient script runners using pipenv. If you want to run the bot using other process managers, that's fine.

Project setup

  1. Register for a Telegram Bot:
    Register a new bot at Bot Father and get a bot token.

  2. Clone this repo:
    Run git clone https://github.com/amirhoseinsalimi/music-tool-bot.git music-tool-bot && cd music-tool-bot

  3. Fire up your venv shell:

    • Run python3 -m venv venv to create a virtual environment
    • Run source venv/bin/activate to activate the virtual environment
    • Run pip install pipenv to install pipenv. If you get an error regarding building the wheel library while installing packages, you can install python v3.11.x.

  4. Install dependencies:
    Run pipenv install -d

  5. Setup environment variables:
    Run cp .env.example .env. Then put your credentials there:

    Field Type Description
    OWNER_USER_ID int The user ID of the owner of the bot (YOU). This user can add/delete admins.
    BOT_NAME str The name of the bot
    BOT_USERNAME str The username of the bot. This username is sent as signature in captions.
    BOT_TOKEN str The bot token you grabbed from @BotFather
    DB_NAME str Database name. Read the next step for more information.
    BTC_WALLET_ADDRESS str BTC wallet address to receive donations.
    ETH_WALLET_ADDRESS str ETH wallet address to receive donations.
    TRX_WALLET_ADDRESS str TRX wallet address to receive donations.
    USDT_TRC20_WALLET_ADDRESS str USDT (TRC20) wallet address to receive donations.
    USDT_ERC20_WALLET_ADDRESS str USDT (ERC20) wallet address to receive donations.
    SHIBA_BEP20_WALLET_ADDRESS str SHIBA (BEP20) wallet address to receive donations.
    SHIBA_ERC20_WALLET_ADDRESS str SHIBA (ERC20) wallet address to receive donations.
    DOGE_WALLET_ADDRESS str DOGE wallet address to receive donations.
    ZARIN_LINK_ADDRESS str ZarinLink address to receive donations.

  6. Set up the database:
    This bot persists the IDs of users and admins in a SQLite database. So you need to create a database followed by running migrations:
    pipenv run db:migrate.
    Then run seeds to populate the admins table with an owner-level access:
    pipenv run db:seed.

  7. Run the bot
    a. Start the bot pipenv run start
    b. Restart the bot pipenv run restart

See below for all possible commands:

Command pipenv run <command> Description
dev Start the bot for development with hot reload thanks to jurigged
start Start the bot for production using pm2 module. Creates a process called music-tool-bot
restart Restarts the bot process with the name music-tool-bot
stop Stops the bot process with the name music-tool-bot
db:migrate Run migrations
db:refresh Rollback all migration and re-run them (Use with caution)
db:status Print the status of migrations
db:seed Run seeds to create a user with owner privileges
test Run tests (Not implemented yet)
t Alias for test command

Contribution

In the beginning, I had written this bot in JavaScript, but due to a lack of quality packages, it was full of bugs. Then I decided to learn Python and thought: Why not re-write @MusicToolBot in Python? And then I began to revive the project.

This tiny bot is my first practical Python project. I tried to learn Python along with coding, so I could better wrap my head around the syntax and the built-in functionality of the language. However, as a novice Python developer, I know this bot can be written in a more smart way with better code structure. So, if you know Python, I would really appreciate any help to make this kid better. My main concern is the application structure, but please feel free to create PRs, open discussions and make small fixes (like typos). In addition, I have some plans and features for this bot, you can find them on the issue board. Also, I'd be very appreciated if you can translate the bot to your language.