{"id":18286468,"url":"https://github.com/v0idzdev/bb-bot","last_synced_at":"2025-04-05T08:31:26.823Z","repository":{"id":40665099,"uuid":"464251123","full_name":"v0idzdev/bb-bot","owner":"v0idzdev","description":"🤖🔒 Fully-featured Discord bot with music, polls, memes and moderation.","archived":false,"fork":false,"pushed_at":"2023-06-02T13:13:31.000Z","size":571,"stargazers_count":32,"open_issues_count":0,"forks_count":16,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-06-02T14:26:33.528Z","etag":null,"topics":["24-7","24-7-hosting","24-7-music-bot","bot","discord","discord-admin-bot","discord-api","discord-bot","discord-mod","discord-moderation-bot","discord-music-bot","discord-py","functional-programming","gcp","gcp-compute","gcp-compute-engine","google-cloud","procedural","procedural-programming","python-3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/v0idzdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-27T20:54:42.000Z","updated_at":"2023-05-25T23:44:14.000Z","dependencies_parsed_at":"2022-08-10T00:27:37.952Z","dependency_job_id":null,"html_url":"https://github.com/v0idzdev/bb-bot","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v0idzdev%2Fbb-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v0idzdev%2Fbb-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v0idzdev%2Fbb-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v0idzdev%2Fbb-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/v0idzdev","download_url":"https://codeload.github.com/v0idzdev/bb-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223174955,"owners_count":17100324,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["24-7","24-7-hosting","24-7-music-bot","bot","discord","discord-admin-bot","discord-api","discord-bot","discord-mod","discord-moderation-bot","discord-music-bot","discord-py","functional-programming","gcp","gcp-compute","gcp-compute-engine","google-cloud","procedural","procedural-programming","python-3"],"created_at":"2024-11-05T13:20:29.518Z","updated_at":"2024-11-05T13:20:30.224Z","avatar_url":"https://github.com/v0idzdev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.postimg.cc/vm6mgHK3/Banner.png\" alt=\"BB.Bot's banner image.\"\u003e\u003cbr\u003e\n\u003ch1 align=\"center\"\u003e🤖 BB.Bot\u003c/h1\u003e\n\u003ch3 align=\"center\"\u003e🔒 Moderation | 🎵 HQ Music Streaming | 😆 Memes | ⭐ Reaction Roles | ❓ Polls\u003c/h3\u003e\n\u003ch4 align=\"center\"\u003ePowered by discord.py and GCP, BB.Bot is the bot for you.\u003c/h4\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/matthewflegg/beepboop?include_prereleases\u0026label=Latest%20Version\u0026style=social\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/matthewflegg/beepboop?label=Latest%20Stable%20Version\u0026style=social\"\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n**As of May 4, 2022, the development, maintenance, and support for BB.Bot has come to an end.**\n\n**BB.Bot** is a Discord bot powered by **Python** and **GCP's Compute Engine**. Featuring 24/7 uptime, HQ music streaming, admin commands, and more, BB.Bot will bring your server to life. **Available for free**, our bot comes with **no additional costs** and **long-term support**.\n\n* Click **[here](https://discord.com/api/oauth2/authorize?client_id=947593856839458916\u0026permissions=8\u0026scope=bot%20applications.commands)** to invite BB.Bot to your server.\n* Click **[here](https://discord.gg/tdFRB8uU)** to join our Discord server.\u003cbr\u003e\n* Click **[here](#-self-hosting)** for self-hosting instructions.\n* Click **[here](https://github.com/matthewflegg/bb-bot/blob/master/CONTRIBUTIONS.md)** for information about contributing.\n\nCurrently, BB.Bot `2.0.0` is in development. If you're thinking of contributing, please do so on the `release/v2.0.0` branch.\n\u003cbr\u003e\u003cbr\u003e\n\n## 📢 **Commands List**\n\n* We use `...argument` to denote a **list of arguments**, like `argument a`, `argument b`, etc...\n* We use `argument?` to denote an **optional argument**. You can use the command **with** or **without** one.\u003cbr\u003e\u003cbr\u003e\n\n### 🧭 Contents\n\n* **[Help Commands](#-help-commands)**\n* **[Admin Commands](#-admin-commands)**\n* **[Music Commands](#-music-commands)**\n* **[Role Commands](#-role-commands)**\n* **[Misc Commands](#-misc-commands)**\n* **[Info Commands](#-info-commands)**\n\u003cbr\u003e\u003cbr\u003e  \n\n### 🔖 Help Commands\n\n\u003e **~help**\n\nSends an embed containing a list of commands and categories.     \nYou can use **`~help \u003ccommand\u003e`** or **`~help \u003ccategory\u003e`** to see more information.\n\n\u003e **~docs**\n\nSends an embed linking to **this page**.\n\u003cbr\u003e\u003cbr\u003e             \n\n### 🔑 Admin Commands\n\n\u003e **~clear `number of messages?`**\n\nClears a specified number of messages from a text channel. Using the command on its own will clear **all** messages\u003cbr\u003e\n**Requires**: `Manage Messages`\n\n\u003e **~blacklist | ~bladd `...words?`**\n\nAllows the user to choose words to ban on the server with a dropdown menu.\u003cbr\u003e\n**Requires**: `Manage Messages`\n\n❗ Optionally, you can type words after the command if you'd prefer not to use the dropdown.\n\n\u003e **~clearblacklist | ~blclear**\n\nClears the blacklist for the server.\u003cbr\u003e\n**Requires**: `Manage Messages`\n\n\u003e **~showblacklist | ~blshow**\n\nShows the blacklist for the server.\u003cbr\u003e\n**Requires**: `Manage Messages`\n\n⚠️ Other users will be able to see the words on the list. Only use this in an admin/mod-only channel.\n\n\u003e **~blacklistremove | ~blrem `...words?`**\n\nAllows the user to choose words to remove from the blacklist with a dropdown menu.\u003cbr\u003e\n**Requires**: `Manage Messages`\n\n❗ Optionally, you can type words after the command if you'd prefer not to use the dropdown.\n\n\u003e **~kick `member` `reason?`**\n\nKicks a specified user from the server.\u003cbr\u003e\n**Requires**: `Kick Members`\n\n\u003e **~ban `member` `reason?`**\n\nBans a specified user from the server.\u003cbr\u003e\n**Requires**: `Ban Members`\n\n\u003e **~softban `member` `number of days` `reason?`**\n\nTemporarily bans a specified user from the server.\u003cbr\u003e\n**Requires**: `Ban Members`\n\n⚠️ It is **not** recommended to use this when self-hosting, unless your bot will be running 24/7.\n\n\u003e **~unban `member`**\n\nUnbans a specified user from the server.\u003cbr\u003e\n**Requires**: `Ban Members`\n\u003cbr\u003e\u003cbr\u003e        \n\n### 🔊 Music Commands\n\n\u003e **~connect** | **~join**\n\nJoins the VC you're currently in.\n\n💿 When you use `play`, the bot will join automatically before playing, so this isn't needed most of the time.\n\n\u003e **~play | ~p `song to search for`**\n\nSearches YouTube for a song and then plays the top result.\n\n\u003e **~pause | ~ps**\n\nPauses the song currently playing if there is one.\n\n\u003e **~resume | ~r**\n\nResumes the song currently playing if there's one currently paused.\n\n\u003e **~skip | ~s**\n\nSkips the song currently playing if there is one.\n\n\u003e **~queue | ~q | ~songs**\n\nShows a list of songs that are queued.\n\n\u003e **~nowplaying | ~np**\n\nShows the song currently playing if there is one.\n\n\u003e **~volume | ~vol `volume as a percentage`**\n\n🎧 Tip: You can use this command to have finer control over volume - you can set the volume to 8.78, for instance.\n\nAdjust the volume of the music player.\n\n\u003e **~stop | ~del**\n\nStops the music player and clears all existing songs from the queue.\n\n⚠️ This command kicks the bot from the VC.\n\u003cbr\u003e\u003cbr\u003e    \n\n### 🌟 Role Commands\n\n\u003e **~reactrole | ~crr `emoji` `@role` `message`**\n\nCreates an embed that users can react to for a role.\u003cbr\u003e\n**Requires**: `Manage Roles`\n\n\u003e **~removereactrole | ~rrr `@role`**\n\nDeletes all reaction role messages for a particular role.\u003cbr\u003e\n**Requires**: `Manage Roles`\n\u003cbr\u003e\u003cbr\u003e     \n\n### 📒 Misc Commands\n\n❓ Currently, we're testing out **[slash commands](https://support.discord.com/hc/en-us/articles/1500000368501-Slash-Commands-FAQ)** for this category.\n\n\u003e **~choose `...options`** or **/choose `...options`**\n\nRandomly chooses an option from a list. Use quote marks \"\" around the options if they are longer than one word.\n\n⚠️ `/choose` does not currently support choices with multiple words.\n\n\u003e **~meme** or **/meme**\n\nSends a random meme from Reddit.\n\n\u003e **~poll `yes/no question`** or **/poll `yes/no question`**\n\nCreates a poll that users can react with yes or no to.\u003cbr\u003e\n\n\u003e **~twitch `streamer name`** or **/twitch `streamer name`**\n\nGets information about a Twitch stream if the streamer is currently streaming.\n\n\u003e **~echo `text`** or **/echo `text`**\n\nRepeats a message in a text channel.\n\n\u003e **~ping** or **/ping**\n\nShows your current ping/latency in milliseconds.\n\n\u003e **~youtube | ~yt `search term`** or **/youtube `search term`**\n\nSearches YouTube for a video and sends you a link to it. You can choose to view it on YouTube or in Discord.\n\u003cbr\u003e\u003cbr\u003e  \n\n### 💡 Info Commands\n\n❓ Just like misc commands, we're also testing out **[slash commands](https://support.discord.com/hc/en-us/articles/1500000368501-Slash-Commands-FAQ)** for this category.\n\n\u003e **~joined `@member?`** or **/joined `@member?`**\n\nShows the join date of a member on a server. If no member is specified, it shows your join date.\n\n\u003e **~toprole `@member?`** or **/toprole `@member?`**\n\nShows a member's highest ranking role on a server. If no member is specified, it shows your top role.\n\n\u003e **~permissions | ~perms `@member?`** or **/permissions `@member?`**\n\nShows the permissions a member has on a server. If no member is specified, it shows your permissions.\n\u003cbr\u003e\u003cbr\u003e\n\n## 🚀 Self Hosting\nHow to set up **BB.Bot** for self-hosting, step by step.\u003cbr\u003e\n\n⚠️ For **development** versions of the bot, the prefix is `'?'`. This is so that we don't get the main \u0026 dev versions mixed up!\n\n* Click **[here](https://realpython.com/installing-python/)** for more information on **installing Python**.\n* Click **[here](https://discordpy.readthedocs.io/en/stable/discord.html)** for more information on **setting up a Discord bot** using the **Discord Developer Portal**.\n* Click **[here](https://dev.twitch.tv/docs/authentication/register-app)** for more information on **registering a Twitch API application**.\n\u003cbr\u003e\u003cbr\u003e\n\n### 🔖 Prerequisites\n\n* **Python** 3.10+\u003cbr\u003e\n* A **Discord API application with a Bot user**, with:\u003cbr\u003e\n    * **All** priveleged gateway intents\n    * `Administrator` permissions\n    * `bot` and `applications.commands` scopes.\n* A registered **Twitch API application**.\n\u003cbr\u003e\u003cbr\u003e\n\n### ⏳ Installing\n\n1. Install a **.ZIP** from the **[releases](https://github.com/matthewflegg/bb-bot/releases)** page.\u003cbr\u003e\n3. **Extract it** to your preferred file location.\u003cbr\u003e\n4. **Create a file** in the **root directory** called `.env`. It should look like this:\n```\nTOKEN=\u003cYour Discord Bot Token\u003e\nTEST_GUILD_ID=\u003cYour Server's ID. This is optional\u003e\nTWITCH_CLIENT_ID=\u003cYour Twitch Client ID\u003e\nTWITCH_CLIENT_SECRET=\u003cYour Twitch Client Secret\u003e\n```\n\n### 🔌 Running\n\n##### 🐧 Linux/UNIX\n* Go to the **root directory** and run `chmod +x scripts/start.sh`.\n* Then **run the script** using `./scripts/start.sh`.\n\n##### 🏠 Windows\n* Press **Windows + X**.\n* Choose **Windows PowerShell (Admin)**.\n* Go to the **root directory** and run `Set-ExecutionPolicy Bypass`.\n* Finally, **run** `.\\scripts\\start.ps1`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv0idzdev%2Fbb-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fv0idzdev%2Fbb-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv0idzdev%2Fbb-bot/lists"}