{"id":16219814,"url":"https://github.com/clemenselflein/matrix-sticker-import-bot","last_synced_at":"2025-10-29T02:31:26.898Z","repository":{"id":243548604,"uuid":"812296596","full_name":"ClemensElflein/matrix-sticker-import-bot","owner":"ClemensElflein","description":"Matrix Sticker Import Bot is an open-source tool that enables users to seamlessly import Telegram stickers into their Stickerpicker instance using a Matrix bot. The project includes a Docker container that integrates Stickerpicker and MStickerEditor, providing each user with their own customizable sticker packs.","archived":false,"fork":false,"pushed_at":"2025-01-29T09:38:38.000Z","size":10,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T10:30:03.291Z","etag":null,"topics":["chatbot","docker","matrix","matrix-bot","python","stickers","telegram","telegram-bot"],"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/ClemensElflein.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-06-08T13:45:24.000Z","updated_at":"2025-01-29T09:38:42.000Z","dependencies_parsed_at":"2024-06-09T19:27:23.606Z","dependency_job_id":"f5dfe63b-7128-47fb-a10b-c66ac536e277","html_url":"https://github.com/ClemensElflein/matrix-sticker-import-bot","commit_stats":null,"previous_names":["clemenselflein/matrix-sticker-import-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClemensElflein%2Fmatrix-sticker-import-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClemensElflein%2Fmatrix-sticker-import-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClemensElflein%2Fmatrix-sticker-import-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClemensElflein%2Fmatrix-sticker-import-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ClemensElflein","download_url":"https://codeload.github.com/ClemensElflein/matrix-sticker-import-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238759768,"owners_count":19525873,"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":["chatbot","docker","matrix","matrix-bot","python","stickers","telegram","telegram-bot"],"created_at":"2024-10-10T11:56:11.030Z","updated_at":"2025-10-29T02:31:26.531Z","avatar_url":"https://github.com/ClemensElflein.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Matrix Sticker Import Bot\n\nMatrix Sticker Import Bot is an open-source project that enables users to import Telegram stickers into their Stickerpicker instance using a Matrix bot. This project leverages the capabilities of the [Stickerpicker](https://github.com/maunium/stickerpicker) and [MStickerEditor](https://github.com/LuckyTurtleDev/mstickereditor) open-source projects, providing an easy-to-use Docker container that includes both projects. It hosts Stickerpicker, allowing each user to have their own personalized sticker packs.\n\n## Features\n\n- **Matrix Bot Integration**: Listens to Matrix chats and imports Telegram stickers into Stickerpicker.\n- **Simple Docker Hosting**: Provides a straightforward Docker container setup that includes Stickerpicker, MStickerEditor, and the Sticker Import Bot.\n- **User-Specific Sticker Packs**: Hosts Stickerpicker instances for each user, enabling individual management of sticker packs.\n\n## Prerequisites\n\n- Docker installed on your system.\n- A Telegram bot key for fetching the stickers.\n- Matrix account credentials (bot user account with access token, homeserver URL).\n\n## Configuration\n\nConfiguration is similar to MStickerEditor, utilizing the same configuration file. Just use your bot credentials in the Matrix section, and you are set.\n\nExample `config.toml` file:\n\n```toml\n[telegram]\nbot_key = \"your-telegram-bot-token\"\n\n[matrix]\nuser = \"@sticker-bot:example.com\"\nhomeserver_url = \"https://example.com\"\naccess_token = \"your_matrix_access_token_for_sticker_bot_user\"\n```\n\n## Running the Container\n\nThe container image is built on ghcr.io, so you can simply run it using `docker run`. Ensure to expose the port for the HTTP server, mount a directory where the JSON files for the sticker packs are stored, and mount the `config.toml` file into the container.\n\nExample command:\n\n```sh\ndocker run -d \\\n  -p 8080:8080 \\\n  -v /path/to/sticker-packs:/app/packs \\\n  -v /path/to/config.toml:/root/.config/mstickereditor/config.toml \\\n  ghcr.io/ClemensElflein/matrix-sticker-import-bot:latest\n```\n\nReplace `/path/to/sticker-packs` and `/path/to/config.toml` with the actual paths on your host system.\n\n## Usage\n\n- **Enable the Stickerpicker Widget**: In order to see the Stickerpicker Widget, send `/devtools` in any chat in Element. Then select `Explore account data`-\u003e`m.widgets` and set the content to this JSON:\n\n  ```json\n  {\n    \"stickerpicker\": {\n      \"content\": {\n        \"type\": \"m.stickerpicker\",\n        \"url\": \"http://example.com:8080/stickerpicker/@you:example.com/?theme=$theme\",\n        \"name\": \"Stickerpicker\",\n        \"creatorUserId\": \"@you:example.com\",\n        \"data\": {}\n      },\n      \"sender\": \"@you:example.com\",\n      \"state_key\": \"stickerpicker\",\n      \"type\": \"m.widget\",\n      \"id\": \"stickerpicker\"\n    }\n  }\n  ```\n\n  \n\n- **Matrix Bot Commands**: Interact with the bot in Matrix chats to add new sticker packs to your Stickerpicker instance. Send `!help` to get the available commands.\n\n## Technologies Used\n\n- [Stickerpicker](https://github.com/maunium/stickerpicker): A fast and simple Matrix sticker picker widget.\n- [MStickerEditor](https://github.com/LuckyTurtleDev/mstickereditor): A tool to import Telegram stickers for use in Stickerpicker.\n\n\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n\n\n## Acknowledgments\n\nSpecial thanks to the maintainers of [Stickerpicker](https://github.com/maunium/stickerpicker) and [MStickerEditor](https://github.com/LuckyTurtleDev/mstickereditor) for their amazing projects.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclemenselflein%2Fmatrix-sticker-import-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclemenselflein%2Fmatrix-sticker-import-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclemenselflein%2Fmatrix-sticker-import-bot/lists"}