turto is a simple, easy-to-use and customizable Discord music bot, especially suitable for self-hosting. Through the following steps, you can have your own turto in minutes.
- Fully customizable multilingual support
- Deploy within only 5 minutes
- Support almost all platform (powered by yt-dlp)
- Slash commands
If you are upgrading from version 0.x.x, you might need to kick the bot from your server, and re-invite with steps below.
turto depends on yt-dlp, make sure you have it installed, if you haven't done so, you can follow these steps to install it. turto also supports Docker, see here if you want to use turto with Docker.
For installing yt-dlp, you can refer to this page on their github repository, they have made instructions for various platforms.
Since you ensure that yt-dlp is installed, you can download pre-compiled turto binaries from the release page. If the platform that you're using isn't provided, you can also compile it yourself.
After you extract the zip file downloaded from the release page, you will see .env file, open it with text editor then you will see the content is like below.
DISCORD_TOKEN=
You need to paste you Token right after DISCORD_TOKEN=, and save the file. If you don't know what is Token, you can just seach "discord bot token" and there are a lot of tutorials telling how to do. You also need to turn the MESSAGE CONTENT INTENT on, in the same page as you get Token.
On Windows you can simply double click the turto.exe file then the bot will start working, or you can also use Command Prompt or PowerShell.
.\turtoMake sure the exetuable have execute permission, if not, it can be done by
chmod +x turtoAnd you can start the bot by
./turtoIn the same folder as the turto executable, you'll find files like config.toml, help.toml, and template.toml. You can open these files in text editors to tweak turto's settings. Since they use the TOML format, make sure you edit them according to the TOML formats.
config.toml is used for configuring turto, the purpose of each parameter is described in the comments within the file. The owner parameter does not necessarily need to be set, but if it is, the owner has the ability to bypass admin permissions to use the /ban and /unban commands, and the /about command will display who turto belongs to.
turto supports multiple languages and will display responses in the language corresponding to the user's regional settings, with English and Traditional Chinese being the default supported languages. To add support for new languages or to modify responses, you can edit help.toml and template.toml. In these files, you will see sections like default and zh-TW. turto will prioritize using a supported language, but if there’s no support for the user's language, it will respond with the content from the default section. You can also edit the content of the default section to have turto use a different default language (or whatever you want it to say). Detailed configuration instructions are written in the comments of both help.toml and template.toml.
You can get your application ID in Discord Developer Portal → Applications → Your bot's application → General Information, and replace your_application_id in the URL below.
https://discord.com/api/oauth2/authorize?client_id=your_application_id&permissions=36718592&scope=bot+applications.commands
Or, you can generate the URL in Discord Developer Portal → Applications → Your bot's application → OAuth2 → URL Generator. Make sure to select these following options.
Scopes
- bot
- applications.commands
Bot permissions
- Send Messages
- Embed Links
- Connect
- Speak
- Use Voice Activity
All you need to do is type / to see a list of all commands available in turto. The slash command provides explanations for both the commands and their parameters. For more detailed information, you can use the /help command to inquire about the specific usage of each command.
If you want to stop the bot, you should press Ctrl + C, this make the bot save data of each guilds (like playlist and settings) then shutdown. If you close the terminal window directly, the bot would not save the data.
Debug mode shows more information of the program, which is useful for debugging, if you are about to report bugs, it would be better to enable debug mode and provide logs.
PowerShell
$env:TURTO_LOG="debug"
.\turtoCommand Prompt
set TURTO_LOG=debug
.\turtoexport TURTO_LOG=debug
./turtoRun this command
docker run -e DISCORD_TOKEN=your_bot_token ghcr.io/phoxwupsh/turto:latestYou need to replace your_bot_token with your Discord bot token, that's it.
To compile turto, you will need Rust toolchain and CMake.
To install Rust toolchain, you can visit here, and follow the instruction.
After you finish the installation, make sure your Rust version is higher than 1.74.0, you can check your Rust version by
rustc -VYou can download CMake for your platform from their website.
Since you ensure Rust toolchain and CMake are installed, you need to download the source. You might want to this repository, especially if you're planning on contributing. Or, you can directly download with Git.
git clone https://github.com/phoxwupsh/turto.gitThen you can head to the directory where Cargo.toml is
cd turtoAnd start compiling
cargo build --releaseAfter it compile successfully, you can see turto executable in directory target → release. If you compile turto yourself, you will need .env, config.toml, help.toml and templates.toml in the same directory with the executable, you can find presets in this repository, with file name end with .template, you can simply rename them and start using.