{"id":14983413,"url":"https://github.com/jonaskroedel/orangedb","last_synced_at":"2025-08-30T05:06:04.605Z","repository":{"id":46825371,"uuid":"477820053","full_name":"jonaskroedel/OrangeDB","owner":"jonaskroedel","description":"Discord.js Bot with mySQL integration","archived":false,"fork":false,"pushed_at":"2023-03-09T17:47:58.000Z","size":101323,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-02T05:24:43.374Z","etag":null,"topics":["bot","discord","discord-bot","discord-js","discord-js-bot","discord-js-bots","javascript","mysql"],"latest_commit_sha":null,"homepage":"https://discord.com/api/oauth2/authorize?client_id=845681260567068712\u0026permissions=8\u0026scope=bot","language":"JavaScript","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/jonaskroedel.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-04T18:13:19.000Z","updated_at":"2024-04-02T17:26:01.000Z","dependencies_parsed_at":"2024-09-29T06:16:38.782Z","dependency_job_id":null,"html_url":"https://github.com/jonaskroedel/OrangeDB","commit_stats":{"total_commits":103,"total_committers":3,"mean_commits":"34.333333333333336","dds":"0.30097087378640774","last_synced_commit":"f7eb43129f575d621ac7fc9e68a4501c2e10ac29"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonaskroedel%2FOrangeDB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonaskroedel%2FOrangeDB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonaskroedel%2FOrangeDB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonaskroedel%2FOrangeDB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonaskroedel","download_url":"https://codeload.github.com/jonaskroedel/OrangeDB/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238900446,"owners_count":19549517,"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":["bot","discord","discord-bot","discord-js","discord-js-bot","discord-js-bots","javascript","mysql"],"created_at":"2024-09-24T14:07:10.817Z","updated_at":"2025-02-14T19:35:03.229Z","avatar_url":"https://github.com/jonaskroedel.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\r\n    \u003cbr\u003e\r\n    \u003ca href=\"https://github.com/jonaskroedel/OrangeDB\"\u003e\u003cimg src=\"./images/OrangeDB.png\"\u003e\u003c/a\u003e\r\n    \u003cbr\u003e\r\n    Orange Discord Bot\r\n    \u003cbr\u003e\r\n\u003c/h1\u003e\r\n\r\n\u003ch3 align=center\u003eA multi-Guild usable Discord bot built with \u003ca href=https://github.com/discordjs/discord.js\u003ediscord.js\u003c/a\u003e\u003c/h3\u003e\r\n\r\n\u003cdiv align=center\u003e\r\n\r\n  \u003ca href=\"https://discord.gg/EejzQcpMHG\"\u003e\r\n    \u003cimg src=\"https://discordapp.com/api/guilds/771331659953602601/widget.png?style=shield\" alt=\"shield.png\"\u003e\r\n  \u003c/a\u003e\r\n\r\n  \u003ca href=\"https://github.com/discordjs\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/badge/discord.js-v13.6.0-blue.svg?logo=npm\" alt=\"shield.png\"\u003e\r\n  \u003c/a\u003e\r\n\r\n  \u003ca href=\"https://github.com/sabattle/CalypsoBot/blob/develop/LICENSE\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/badge/license-GNU%20GPL%20v3-green\" alt=\"shield.png\"\u003e\r\n  \u003c/a\u003e\r\n\r\n\u003c/div\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"#about\"\u003eAbout\u003c/a\u003e\r\n  •\r\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\r\n  •\r\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\r\n  •\r\n  \u003ca href=\"#setting-up\"\u003eSetting Up\u003c/a\u003e\r\n  •\r\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\r\n  •\r\n  \u003ca href=\"#credits\"\u003eCredits\u003c/a\u003e\r\n  •\r\n  \u003ca href=\"https://github.com/jonaskroedel/OrangeDB/blob/master/COMMANDS.md#detailed-page-for-all-commands\"\u003eCommands\u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n\r\n\r\n\u003cp align=\"center\"\u003eThe orange [ˈɔrɪndʒ] is a round, sweet fruit with a thick orange skin and an orange core, which is divided into many parts.\u003c/p\u003e\r\n\u003ch4 align=\"center\"\u003eOr·ange [the]: A fruit\u003c/h4\u003e\r\n\r\n## About\r\n\r\nOrange is an open source, customizable Discord bot that is constantly growing. The Bot comes packaged with a variety of commands. The Bot's codebase also serves as a base framework so everyone can easily create a Discord Bot of all kinds and needs. You can invite Orange to your Discord server using [this](https://discord.com/api/oauth2/authorize?client_id=845681260567068712\u0026permissions=8\u0026scope=bot) link! Also, you can join my Server [Funf](https://discord.gg/EejzQcpMHG) for questions, suggestions, assistance and much more.\r\n\r\nIf you like this repository, feel free to leave a star ⭐ to help promote Orange!\r\n\u003cbr\u003e\r\nYou can find a detailed information sheet with all commands [here](https://github.com/jonaskroedel/OrangeDB/blob/master/COMMANDS.md#detailed-page-for-all-commands).\r\n\r\n## Features\r\n\r\n``34`` commands across ``4`` different categories!\r\n\r\n- ``main`` commands like `meme`, `help` \r\n- ``moderation`` commands like `clear`, `clearchannel`, `prefix`, `userinfo` and much more\r\n- ``music`` commands like `play`, `lyrics`, `24/7`, `autoplay`, `skip` and much more\r\n- ``playlist`` commands like `create`, `load` and much more!\r\n\r\n## Installation\r\n\r\nYou can add Orange to your server with [this](https://discord.com/api/oauth2/authorize?client_id=845681260567068712\u0026permissions=8\u0026scope=bot) link! Alternatively, you can clone this repository and host the bot yourself.\r\n\r\n````\r\ngit clone https://github.com/jonaskroedel/orangedb\r\n````\r\n\r\nAfter cloning, run these commands\r\n\r\n````\r\nnpm install\r\nnpm install discord.js\r\nnpm install dotenv --save\r\nnpm install --save mysql2\r\nnpm install got@11.8.3\r\nnpm install lyrics-finder\r\nnpm install canvas\r\nnpm install menudocs/erela.js#build\r\n````\r\n\r\nto get all the dependencies and packages. You need [Node.js](https://nodejs.org/) and [MySQL](https://www.mysql.com/) installed. I highly recommend to install [nodemon](https://www.npmjs.com/package/nodemon) as it makes testing *much* easier.\r\n\r\n## Setting Up\r\n\r\nYou have to create a ``.env`` file in your root directory to run the bot (you can use the example file provided as a base). Your file should look something like this:\r\n\r\n````\r\nBOT_TOKEN=YOURTOKEN\r\nDB_HOST=YOUR_HOST_ADRESS //eg. localhost\r\nDB_USER=YOUR_DB_USER //eg. root\r\nDB_PASS=YOUR_DB_PASSWORD //eg. root\r\nDB_NAME=orangedb  //if you dont know, then do not change that!\r\nHOST=YOU_LAVALINK_HOST\r\nPASSWORD=YOUR_LAVALINK_PASSWORD\r\nPORT=YOUR_LAVALINK_PORT\r\nPREFIX=o! //default prefix for orange\r\n````\r\n\r\nVisit the Discord [developer portal](https://discordapp.com/developers/applications/) to create an app and use the client token you are given for the `token` option. `ownerId` is your own Discord snowflake.\r\n\r\nAfter that, you have enable `Privileged Intents` on your Discord [developer portal](https://discordapp.com/developers/applications/). You can find these intents under the \"Bot\" section, and there are two ticks you have to switch on. For more information on Gateway Intents, check out [this](https://discordjs.guide/popular-topics/intents.html#the-intents-bit-field-wrapper) link.\r\n\r\n## To-Do\r\n\r\nOrangeDB is a continous state of development. New features/updates can come at any time. Some pending ideas are:\r\n\r\n- ~~Music~~ \r\n- Ticket-System\r\n- Automod\r\n- Autoroles\r\n- Stream alerts\r\n\r\n## License\r\n\r\nReleased under the [GNU GPL v3](https://www.gnu.org/licenses/gpl-3.0.en.html) license.\r\n\r\n## Credits\r\n\r\n- **Jonas Krödel** - *initial work, artwork, idea, implementation and project management* - [github](https://github.com/jonaskroedel)\r\n- **Julian Hoffmann** - *minor helping* - [github](https://github.com/juhom205)\r\n- **Angelo Failoni** - *helping hand and database-design* - [github](https://github.com/BrainFuzz-hub)\r\n- **Mateo Pal** - *artwork, idea* - [reddit](https://www.reddit.com/user/Velocityakavelo)\r\n\r\n\u003ch6 align=\"center\"\u003e© Jonas Krödel 2022\u003c/h6\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonaskroedel%2Forangedb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonaskroedel%2Forangedb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonaskroedel%2Forangedb/lists"}