{"id":28715520,"url":"https://github.com/dismob/dismob","last_synced_at":"2026-03-15T16:58:04.872Z","repository":{"id":285808169,"uuid":"959419978","full_name":"dismob/dismob","owner":"dismob","description":"A base for a discord bot with modularity and extensibility in mind.","archived":false,"fork":false,"pushed_at":"2025-06-13T23:49:39.000Z","size":37,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-14T00:28:04.350Z","etag":null,"topics":["bot","design","discord","discord-bot","discord-py","discordbot","discordpy","dismob","modular","modular-design","modularity","python","python-3","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dismob.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},"funding":{"ko_fi":"benpyton","liberapay":"benpyton","custom":"https://www.paypal.com/donate/?hosted_button_id=9VWP66JU5DZXN"}},"created_at":"2025-04-02T18:52:50.000Z","updated_at":"2025-06-13T23:49:43.000Z","dependencies_parsed_at":"2025-04-02T19:42:08.777Z","dependency_job_id":"4c1773fc-3777-4951-9a99-1dbfd81aeccf","html_url":"https://github.com/dismob/dismob","commit_stats":null,"previous_names":["benpyton/dismob","dismob/dismob"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dismob/dismob","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dismob%2Fdismob","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dismob%2Fdismob/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dismob%2Fdismob/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dismob%2Fdismob/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dismob","download_url":"https://codeload.github.com/dismob/dismob/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dismob%2Fdismob/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259910742,"owners_count":22930713,"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","design","discord","discord-bot","discord-py","discordbot","discordpy","dismob","modular","modular-design","modularity","python","python-3","python3"],"created_at":"2025-06-15T02:10:18.281Z","updated_at":"2026-03-15T16:58:04.867Z","avatar_url":"https://github.com/dismob.png","language":"Python","funding_links":["https://ko-fi.com/benpyton","https://liberapay.com/benpyton","https://www.paypal.com/donate/?hosted_button_id=9VWP66JU5DZXN"],"categories":[],"sub_categories":[],"readme":"# Discord Modular Bot (Dismob)\n\nThis is a base discord modular bot using discord.py\n\nEvery features must be done in bot extensions placed in `plugins/\u003cmodule\u003e/main.py`.\n\nAn example extension `ping` is available which adds only one command `ping` to the bot.\n\n## Installation\n\nMake sure you've installed python.\n\nopen a command-line terminal in your project cloned/downloaded project folder.\n\nCreate a virtual environment for python.\n\n```cmd\npython -m venv venv\n```\n\nActivate it or enable it in your IDE.\n\nInstall dependencies.\n\n```cmd\npython -m pip install -r requirements.txt\n```\n\nAdd a `.env` file at the root directory (alongside `main.py`) and add those lines:\n\n```txt\nBOT_TOKEN=\"your bot token here\"\nOWNER=\"your discord ID here\"\nCONFIG_DIR=\"config\"\nBOT_PREFIX=\"bot.\"\nLOG_NAME=\"devbot\"\nLOG_CONSOLE_LEVEL=\"WARNING\"\nLOG_FILE_LEVEL=\"INFO\"\nLOCALE=\"fr_FR\"\nTZ=\"Europe/Paris\"\n```\n\n\u003e [!NOTE]  \n\u003e The `CONFIG_DIR` is optional and will default to `config` if not set.  \n\u003e The `BOT_PREFIX` is optional and will default to `!` if not set.  \n\u003e The `LOG_NAME` is optional and will default to `dismob` if not set.  \n\u003e The `LOG_CONSOLE_LEVEL` is optional and will default to `INFO` if not set.  \n\u003e The `LOG_FILE_LEVEL` is optional and will default to `INFO` if not set.  \n\u003e The `LOCALE` is optional  \n\u003e The `TZ` is optional  \n\nThen to start the bot run:\n\n```cmd\npython main.py\n```\n\n## Commands\n\nThere are some commands built into the bot itself, they help manage the modules and other crucial features.  \nAll of them are only available to the bot owner, as they have impact on all guilds the bot is added.\n\nCommand | Aliases | Description\n--- | --- | ---\n`shutdown` | | Stop the bot.\n`sync` | | Sync the slash commands of the bot. This command is also available as standard bot command, useful when syncing for the first time.\n`nick [\u003cname\u003e]` | `name` | Change the nickname of the bot in the current server, if no name is passed, then it will reset it to the default one.\n`status [online\\|idle\\|dnd\\|invisible]` | | Change the bot's status.\n`modules \u003csubcommand\u003e [\u003cargs\u003e ...]` | `mod` `plugins` | Manage the modules available to the bot. (see below for list of subcommands)\n\nBelow is the list of subcommands related to the module managements.  \n\nSubcommand | Aliases | Description\n--- | --- | ---\n`status [\u003cmodule\u003e ...]` | `s` | Display the loaded status of provided module names (or all available modules if no module name provided).\n`load \u003cmodule\u003e ...` | `l` `enable` `activate` | Load provided module names (at least one). For example `/module load ping` will load the `plugins/ping/main.py` extension.\n`unload \u003cmodule\u003e ...` | `u` `disable` `deactivate` | Unload provided module names (at least one). For example `unload ping` will unload the `plugins/ping/main.py` extension.\n`reload \u003cmodule\u003e ...` | `rl` `r` | Reload provided module names (at least one). For example `reload ping` will reload the `plugins/ping/main.py` extension.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdismob%2Fdismob","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdismob%2Fdismob","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdismob%2Fdismob/lists"}