Welcome to Titanium's main code repo! Titanium is your multipurpose, open source Discord bot.
Add Titanium Now! (you will agree to the Privacy Policy and Terms of Use policy)
Contributions to Titanium are welcome! To contribute, make a pull request and I'll take a look. When contributing, please ensure that you use Ruff to check and format your code. This ensures that all of Titanium's code stays in a consistent style. To do this with the uv package manager, run uvx ruff check --fix and uvx ruff format.
This program is free soft 8000 ware: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License in the licence file for more details.
- Wikipedia, Urban Dictionary, ReviewDB search
- Random Dog and Cat images
- Fun commands - 8ball, fun insults, freaky text and more
- Search Spotify and get full quailty Album Art (Spotify API Keys needed)
- Get lyrics for songs
- Convert any streaming service URL to Spotify and get info
- Fireboard system and message stats
- Image manipulation, video to GIF
- Message and user quotes
- Per user / server wide tags
- User and server information
- Expandable cog system to allow you to make your own commands
- + even more features!
The best way to see all of Titanium's commands is to add the bot to your server using the link at the top of the readme or in the quick start section, and use Discord's slash command list.
- me: bot code
- deeppyer: deepfry image code (licenced under MIT)
You can quickly start using Titanium with the following link to add the main Titanium instance:
Add Titanium (you will agree to the Privacy Policy and Terms of Use policy)
If you would like to self-host your own instance of Titanium instead, please read the section below.
Self-hosting Titanium is possible, however you must get the required modules and API tokens first.
Important
While I have taken every precaution to block offensive content from being displayed without a disclaimer, it is your responsibility as the bot host to monitor for any offensive content being posted using the bot.
Caution
When generating Bot Tokens and API Secrets, do not share them with anybody!
Titanium requires a Discord Bot Token to function. The steps to get one are as follows:
- Go to the Discord Developer Portal and log in with your Discord Account.
- Create a new application and fill in the information required.
- Go to the
Botsection, and generate a new bot. - Give your bot a username, and optionally, a PFP and banner.
- Copy the Bot Token, and paste it into the bot token field in the config file. Due to security reasons, you will only be able to view the bot token once from Discord Developer Portal before having to generate a new one.
To use the Spotify commands in Titanium, a Spotify Client ID and Secret are required. If you do not provide these, Spotify commands will automatically be disabled. The steps to get these are as follows:
- Go to the Spotify Developers dashboard. A free or premium Spotify account is required.
- Create a new app, set the app name and description to whatever you please. No additional APIs are required.
- Set the Redirect URI to any valid URL.
http://example.comis known to work. Then, create the app. - Copy the Client ID and Secret for your app, and paste them into their respective fields in the config file.
Titanium relies on several Python packages. A pyproject.toml file has been provided; it contains the list of required dependencies and target Python version that can be used with many package managers. I have also provided uv.lock and .python-version files for the uv package manager, see the instructions below to use it:
Installation
- Install UV. This is the tool I use to manage dependencies for the project.
- Open a terminal inside Titanium's root directory.
- Run
uv run main.pyto install all required packages and start the bot.
If an error occurs, please create a GitHub issue and I will take a look.
To invite your instance of Titanium to your server, an invite is required. You can use the following template to make a bot invite URL:
https://discord.com/oauth2/authorize?client_id=(YOUR CLIENT ID)
After you have done this, you will need to go to the Discord Developer Portal and complete the following steps:
- Select your bot from the list of apps.
- Go to the Installation tab.
- Tick
Guild InstallandUser Install. - Select
Discord Provided Linkfor the install link. - In Default Install Settings, select the following options:
User Install
Scopes
applications.commands
Guild Install
Scopes
applications.commands, bot
Permissions
Add Reactions, Attach Files, Embed Links, Manage Messages, Manage Webhooks, Read Message History, Send Messages, Send Messages in Threads, Use Embedded Activities, Use External Emojis, Use External Stickers, Use Slash Commands, View Audit Log, View Channels - Remember to save your changes when you're done!
Titanium uses several privileged intents. If your bot instance is verified (required for 100+ servers), you MUST get approval from Discord before you can use them.
- Presence Intent - needed for the now playing command, server counters.
- Server Members Intent - needed for server member counts in the server info command, getting when members leave for the leaderboard.
- Message Content Intent - Required for getting message content for the fireboard, and for processing the leaderboard.
Titanium is modular and will load compatible cogs automatically.
The default cogs path is:
(RUNNING-PATH)/commands.
This path can be changed to a path of your selection in the config file.
I have developed an example cog that you can look at and modify to fit your needs. You can find it in example.py. When you are ready to use the cog, place it in your cogs folder (/commands by default).