{"id":15112373,"url":"https://github.com/interstella0/stemoji","last_synced_at":"2025-10-26T11:30:29.235Z","repository":{"id":257522577,"uuid":"858498899","full_name":"InterStella0/stemoji","owner":"InterStella0","description":"A discord bot that utilizes the discord application emoji feature as your custom emoji use!","archived":false,"fork":false,"pushed_at":"2024-12-25T01:48:18.000Z","size":9584,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-11T15:21:55.702Z","etag":null,"topics":["bot","custom","discord","discord-bot","emoji","emoji-bot","host","lightweight","postgres","postgresql","python","self","self-host","sqlite"],"latest_commit_sha":null,"homepage":"","language":"Python","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/InterStella0.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":"2024-09-17T02:15:25.000Z","updated_at":"2024-12-25T01:48:22.000Z","dependencies_parsed_at":"2024-10-09T15:40:46.026Z","dependency_job_id":"58ee85b4-1834-4711-b434-66baf0000127","html_url":"https://github.com/InterStella0/stemoji","commit_stats":null,"previous_names":["interstella0/stemoji"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InterStella0%2Fstemoji","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InterStella0%2Fstemoji/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InterStella0%2Fstemoji/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InterStella0%2Fstemoji/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/InterStella0","download_url":"https://codeload.github.com/InterStella0/stemoji/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238315457,"owners_count":19451622,"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","custom","discord","discord-bot","emoji","emoji-bot","host","lightweight","postgres","postgresql","python","self","self-host","sqlite"],"created_at":"2024-09-26T00:44:26.072Z","updated_at":"2025-10-26T11:30:28.097Z","avatar_url":"https://github.com/InterStella0.png","language":"Python","readme":"# Stemoji\n![Code Size](https://img.shields.io/github/languages/code-size/InterStella0/stemoji?style=flat)\n![Total lines](https://tokei.rs/b1/github/InterStella0/stemoji?style=flat)\n![GitHub](https://img.shields.io/github/license/InterStella0/stemoji)\n\nThis is an open source discord bot that allows you to use customize emojis that you put in the bot. It utilizes\nthe new application emoji features that supports up to 2000 custom emojis! It is lightweight and simple to \nset up.\n\n**Try it now:**\n- [Add To My Discord](https://discord.com/oauth2/authorize?client_id=1297004204350636112)\n- [Add To a Discord Server](https://discord.com/oauth2/authorize?client_id=1297004204350636112\u0026permissions=1126312224049216\u0026integration_type=0\u0026scope=bot)\n\n## Bot Feature\n### Steal emojis\n  ![stealing.gif](./readmes/steal_emoji.gif)\n\nFeatures includes:\n  - Steal emoji from messages contents and reactions.\n  - Steal server emojis (when bot are added in the server).\n\n### Emoji Usage\n|               Simple                |              Texting Mode               |\n|:-----------------------------------:|:---------------------------------------:|\n| ![simple.gif](./readmes/simple.gif) | ![adaptive.gif](./readmes/adaptive.gif) | \n|              **Fast**               |             **Searchable**              |\n|   ![fast.gif](./readmes/fast.gif)   |   ![search.gif](./readmes/search.gif)   | \n\nOther features includes:\n- Listing out all emojis.\n- Emoji management:\n  - Adding, renaming, and deleting your own emojis.\n  - Setting favourite emojis.\n- Reacting with custom emojis.\n\n### For use\n- Available on Direct Messages by user installs.\n- Available for use in servers that allows external application installs.\n- Available for servers that adds the bot.\n\n## Self-host Configuration\n\u003cdetails\u003e\n\u003csummary\u003e4 Steps to host your own stemoji bot.\u003c/summary\u003e\n\n### Clone the repository\n```\ngit clone https://github.com/InterStella0/stemoji\n```\n### Python\nInstall Python 3.11 or above.\nThen install python dependencies below.\n```commandline\npip install -r requirements.txt\n```\n\n### Configure Bot\n1. Rename **default.env** to **.env**.\n2. Go to [discord api portal](https://discord.com/developers/applications).\n3. New Application \u003e [insert your bot's name] \u003e Bot \u003e Reset Token \u003e Copy Token\n4. Set your bot's token at **BOT_TOKEN=\"\"**.\n\nThe full environment variable description are written on [Environment variable](#environment-variable) section.\n\n### Run the bot!\n```commandline\npython main.py\n```\n\n### Install the bot on discord\n1. Discord Developer Portal \u003e Installation \u003e Select User Install \u003e Copy User Install Link\n2. Click on the install link\n3. Click Try It Now\n4. Restart your discord client\n\n### Done!\nYour bot should be fully configured! Any errors must be solve yourself or you can\nopen an issue if you believe it's a bug.\n\n## Nerdge Section\n### Environment variable\nThe description for each environment variable are described below.\n\n|          VARIABLE           |  TYPE   | DEFAULT  |                                       DESCRIPTION                                       |\n|:---------------------------:|:-------:|:--------:|:---------------------------------------------------------------------------------------:|\n|          BOT_TOKEN          | String  |          |                      Get it from discord API portal. **REQUIRED**                       |\n|     TEXT_COMMAND_PREFIX     | String  | stemoji  |                     This will be the prefix for your text commands.                     |\n| TEXT_COMMAND_PREFIX_MENTION | Boolean |   TRUE   |                  This will allow text commands to be used by mentions.                  |\n|   MESSAGE_CONTENT_INTENTS   | Boolean |  FALSE   |                      It allows prefix commands to work everywhere.                      |\n|       MEMBERS_INTENTS       | Boolean |  FALSE   |               Allows your bot to have better profile mirroring experience               |\n|          DATABASE           | String  |  sqlite  |                     Database choice, use 'sqlite' for simple setup.                     |\n|        DATABASE_DSN         | String  | emoji.db |                               Database connection string.                               |\n|         OWNER_ONLY          | Boolean |  FALSE   |                       Disallow other people from using your bot.                        |\n|       MIRROR_PROFILE        | Boolean |  FALSE   |            Uses your profile picture and display name as the bot's profile.             |\n|       RETAIN_PROFILE        | Boolean |   TRUE   | Recover your bot's profile during shutdown. **Only relevant if MIRROR_PROFILE is TRUE*. |\n|       BOT_NAME_SUFFIX       | String  |   bot    |    Add a name suffix on your bot's name **Only relevant if MIRROR_PROFILE is TRUE*.     |\n\u003c/details\u003e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterstella0%2Fstemoji","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finterstella0%2Fstemoji","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterstella0%2Fstemoji/lists"}