{"id":13758381,"url":"https://github.com/thibautbessone/DiscordBlueBot","last_synced_at":"2025-05-10T08:30:25.394Z","repository":{"id":19560719,"uuid":"78592827","full_name":"thibautbessone/DiscordBlueBot","owner":"thibautbessone","description":"Customizable soundboard bot for Discord, along other useful commands","archived":false,"fork":false,"pushed_at":"2023-04-14T17:56:05.000Z","size":16114,"stargazers_count":29,"open_issues_count":1,"forks_count":16,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-11-16T15:37:39.339Z","etag":null,"topics":["bluebot","bot","discord","java","jda","soundboard"],"latest_commit_sha":null,"homepage":"https://bluebot.pw","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thibautbessone.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":"bluebot","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"custom":"http://paypal.me/dabedeedabedaa"}},"created_at":"2017-01-11T01:57:41.000Z","updated_at":"2023-11-06T14:29:34.000Z","dependencies_parsed_at":"2024-08-03T13:01:28.467Z","dependency_job_id":"a3319fe6-98b1-4ba2-b465-da9751040d5d","html_url":"https://github.com/thibautbessone/DiscordBlueBot","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thibautbessone%2FDiscordBlueBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thibautbessone%2FDiscordBlueBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thibautbessone%2FDiscordBlueBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thibautbessone%2FDiscordBlueBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thibautbessone","download_url":"https://codeload.github.com/thibautbessone/DiscordBlueBot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253389390,"owners_count":21900751,"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":["bluebot","bot","discord","java","jda","soundboard"],"created_at":"2024-08-03T13:00:28.968Z","updated_at":"2025-05-10T08:30:24.971Z","avatar_url":"https://github.com/thibautbessone.png","language":"Java","funding_links":["https://patreon.com/bluebot","http://paypal.me/dabedeedabedaa"],"categories":["Libraries"],"sub_categories":["Java"],"readme":"# BlueBot - A Java-written Discord bot\n\n\u003cp align=\"center\" \u003e\n  \u003cimg src=\"http://i.imgur.com/6ivzOgT.png\" alt=\"BlueBot\"/\u003e\n  \u003cimg height=\"164\" src=\"https://i.imgur.com/IbZUkkh.png\" alt=\"BlueBot\"/\u003e\u003cbr\u003e\n   \u003cb\u003eJoin the support server :\u003c/b\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca  href=\"https://discord.gg/rSekkJv\"\u003e\n    \u003cimg src=\"https://discordapp.com/api/guilds/268853008455041025/widget.png?style=banner2\"\u003e\n  \u003c/a\u003e\u003cbr\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\nYou can add the bot to your server by clicking on\n\u003ca href=\"https://discordapp.com/oauth2/authorize?client_id=268420199370194944\u0026scope=bot\u0026permissions=-1\"\u003ethis link\u003c/a\u003e\u003cbr\u003e\u003cbr\u003e\n\u003c/p\u003e\n\n\nYou can also contact me on **Steam** : [\u003cimg src=\"https://img.shields.io/badge/Steam-Blue-blue.svg\"\u003e](http://steamcommunity.com/profiles/76561198206490817)\n\nThe **API** can be found [here](https://github.com/DV8FromTheWorld/JDA).\nHowever, the required dependencies for the bot are included in this repository.\n\n**BlueBot** will provide useful features like :\n* Moderation \u0026 utility features\n* Ability to enable \u0026 disable features\n* Owner-only commands\n* Extensible \u0026 customizable soundboard\n* CleverBot integration (currently disabled)\n* GIFs search\n* Twitch alerts\n* Command prefix customization\n* Quick reactions, jokes \u0026 other stuff\n* Cyanide \u0026 Hapiness comics\n\u003c!--* Custom memes (soon)--\u003e\n* More to come !\n\n## Getting started\n\n\u003c!--If you want a .exe (or something like that), go [here](https://github.com/thibautbessone/DiscordBlueBotReleases) and download the latest version for all the features. Simple instructions are provided in order to make the bot to work.--\u003e\n\nTo edit the code, just follow these steps : \n* Create your own app [here](https://discordapp.com/login?redirect_to=/developers/applications/me).\n* **Clone the project** into your favorite IDE using GitHub's integration (if you're not downloading a release). \n* On your application page, get your application **token**\n* Open **config.blue**\n* Replace **YOURTOKENHERE** by your application token\n* Replace **YOURIDHERE** by your ID\n* Create a directory named soundboard in the bot's root folder. You will place your .mp3 files here.\n\n\n## Interface\n\n* Double click anywhere on the background to minimize\n* Click anywhere on the background to drag the window\n* Start buttons launches the bot, Stop button stops it\n* Edit button opens the config file in your default text editor\n* Quit button stops the bot (if running) and closes the window\n\n## Commands\n\nBlueBot provides a lot of commands. Use ```!help``` to display the complete list of them.\n\nBy typing ```help``` after each command, you'll get information on how to use the command. \n\n**Example :** by typing ```!ping help``` you'll get the following response : \n```\nThe command ping pings the bot (to check if it's online). Usage : !ping\n```\n\n## Hosting the bot\n\nYou can host your own instance of the bot. To do so, head over to the [Releases](https://github.com/thibautbessone/DiscordBlueBot/releases) page and download the latest one.\nTo run BlueBot, you'll need Java 8 and OpenJFX. After installing them (Google is your friend, it depends on your OS), you'll be ready to go.\n\nIf you are using the bot on several servers, in order to have a dedicated soundboard per server, you'll have to :\n* Enable Discord Developer mode (in the app settings, go to Appearance -\u003e Advanced -\u003e Toggle Developer mode on), then right click on your server and click on ```Copy ID```.\n* Inside the `soundboard` folder, create a folder named like the server ID (for example, if one of the server has ```264445054966991498``` as ID, you want to name your folder ```264445054966991498```)\n* Drop your .mp3 files inside this folder. These sounds will only be available on this particular server.\n\nTo toggle between the general soundboard and the dedicated one, remember to use the ```!enable``` and ```!disable``` commands.\n\n## Running BlueBot on a headless device (VPS, Raspberry ...)\n\nFirst, install Java with OpenJDK \u0026 OpenJFX:\n* Install OpenJDK (ex. Debian : ```sudo apt-get install openjdk-11-jdk```)\n* Install OpenJFX (ex Debian : ```sudo apt-get install openjfx```)\n\nSince BlueBot is using JavaFX for the GUI, you'll need to install a display emulator to run the app. I personally use [Xvfb](https://www.x.org/releases/X11R7.6/doc/man/man1/Xvfb.1.xhtml)\n\n* Install Xvfb (ex. Debian : ```sudo apt-get install xvfb```)\n* Run ```Xvfb :1 \u0026``` to start an emulated display in the background\n* Run ```export DISPLAY=:1``` to set it as main display\n* Run the bot with ```java --module-path /usr/share/openjfx/lib --add-modules javafx.controls -jar BlueBot.jar cmd \u0026```\n\n## License\n\nThis project is released under the [MIT License](https://github.com/thibautbessone/DiscordBlueBot/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthibautbessone%2FDiscordBlueBot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthibautbessone%2FDiscordBlueBot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthibautbessone%2FDiscordBlueBot/lists"}