{"id":16566867,"url":"https://github.com/sudoskys/tsticker","last_synced_at":"2025-04-10T19:50:32.950Z","repository":{"id":247971837,"uuid":"826314284","full_name":"sudoskys/tsticker","owner":"sudoskys","description":"Telegram Sticker Utils | Make Sticker from git-like CLI","archived":false,"fork":false,"pushed_at":"2025-03-10T08:36:09.000Z","size":478,"stargazers_count":26,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T17:21:50.771Z","etag":null,"topics":["telegram","telegram-bot-api","telegram-sticker","telegram-stickers"],"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/sudoskys.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-07-09T13:18:25.000Z","updated_at":"2025-03-10T11:32:06.000Z","dependencies_parsed_at":"2024-08-29T12:55:00.425Z","dependency_job_id":"564b410e-5573-4a02-982e-e875f561b17b","html_url":"https://github.com/sudoskys/tsticker","commit_stats":null,"previous_names":["sudoskys/tsticker"],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudoskys%2Ftsticker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudoskys%2Ftsticker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudoskys%2Ftsticker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudoskys%2Ftsticker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sudoskys","download_url":"https://codeload.github.com/sudoskys/tsticker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248282995,"owners_count":21077750,"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":["telegram","telegram-bot-api","telegram-sticker","telegram-stickers"],"created_at":"2024-10-11T21:01:50.736Z","updated_at":"2025-04-10T19:50:32.940Z","avatar_url":"https://github.com/sudoskys.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# tsticker\n\n[![PyPI version](https://badge.fury.io/py/tsticker.svg)](https://badge.fury.io/py/tsticker) [![Downloads](https://pepy.tech/badge/tsticker)](https://pepy.tech/project/tsticker)\n\n## 📘 Overview\n\n`tsticker` is a telegram sticker pack management cli.\n\nJust put your images in the `\u003csticker dir\u003e/stickers` directory and run `tsticker push` to override your cloud sticker\nwith local stickers.\n\n![intro](.github/intro.png)\n\nOr you can use the `tsticker sync` command to override your local sticker pack with the cloud sticker pack.\n\nSimple? Yes, it is!\n\n- Auto select emoji for sticker\n- Auto resize image for sticker\n- Auto convert (gif,webm,mov ...) to webm for animated sticker\n- You can change the name of the pack by changing the title property in index.json.\n\u003e The only thing that can be edited in `index.json` is the `title`\n\n## 📦 Commands\n\n| Command             | Description                                                                                      |\n|---------------------|--------------------------------------------------------------------------------------------------|\n| `tsticker init`     | Initializes a new sticker pack.                                                                  |\n| `tsticker sync`     | **Override**, Syncs the sticker pack from your local directory with changes from the cloud.      |\n| `tsticker push`     | **Override**, Pushes changes from your local directory to the cloud, updating existing stickers. |\n| `tsticker login`    | Logs in to your Telegram account.                                                                |\n| `tsticker logout`   | Logs out of your Telegram account.                                                               |\n| `tsticker help`     | Displays help information for the CLI.                                                           |\n| `tsticker download` | Download any sticker pack from the cloud to your local directory.                                |\n| `tsticker trace`    | Import cloud sticker pack from url.                                                              |\n| `tsticker show`     | Show the sticker pack information.                                                               |\n\n| Example                                                          | Description                                  |\n|------------------------------------------------------------------|----------------------------------------------|\n| `tsticker init -s regular -n 'sticker_id' -t 'My sticker title'` | Initialize a new sticker                     |\n| `tsticker sync`                                                  | Sync sticker pack                            |\n| `tsticker push`                                                  | Push sticker pack                            |\n| `tsticker login -t \u003cbot_token\u003e -u \u003chuman_user_id\u003e`               | Log in to Telegram                           |\n| `tsticker logout`                                                | Log out of Telegram                          |\n| `tsticker download -l \u003cany sticker link\u003e`                        | Download any sticker pack, cant make changes |\n| `tsticker trace -l \u003csticker link\u003e`                               | Import sticker pack(can make changes)        |\n\n**If you encounter any issues, please [create a new Issue](https://github.com/sudoskys/tsticker/issues) on our GitHub\nrepository.**\n\n## 📋 Prerequisites\n\nWait! Before installing `tsticker`, ensure that your computer meets the following requirements:\n\n- [install ffmpeg](https://ffmpeg.org/download.html)\n\n- [install ImageMagick](https://docs.wand-py.org/en/0.6.12/guide/install.html)\n\n## Installing `tsticker`\n\nThe recommended way to install `tsticker` is through `pipx` for isolated environments:\n\n```bash\npipx install tsticker\n```\n\nIf `pipx` is not installed, install it with the following commands:\n\n```bash\npython3 -m pip install --user pipx\npython3 -m pipx ensurepath\n```\n\nIf you want to upgrade `tsticker` to the latest version, use the following command:\n\n```bash\npipx upgrade tsticker\n```\n\n## 🔑 Login with Telegram\n\nWe need create a bot as a bridge to manage stickers.\n\nRemember the bot can **only** **auto** manage stickers **created by the bot itself**, once you lost your bot, you can\nonly manage stickers manually.\n\nTo create and manage stickers with `tsticker`, you need a **Telegram Bot Token**. Follow these steps:\n\n1. Open Telegram and search for the [BotFather](https://t.me/BotFather) bot.\n2. Start a conversation with BotFather and send the command `/newbot`.\n3. Follow the instructions to create your bot and acquire the bot token.\n\nThe bot token provided by BotFather will be used as your `BotToken`.\n\nWin + R, type `cmd`, and press Enter to open the command prompt. Run the following command to login\n\nReplace `\u003ctoken\u003e` with your Telegram bot token and `\u003cuser\u003e` with your Telegram user ID (you can get your user ID\nfrom [getidsbot](https://t.me/getidsbot) by sending `/my_id`).\n\n```bash\ntsticker login -t \u003ctoken\u003e -u \u003cuser\u003e\n```\n\nWe use https://pypi.org/project/keyring/ to manage your tokens, which may require additional steps. If you encounter\nproblems, refer to: https://github.com/jaraco/keyring\n\n## Adding or Removing Stickers\n\nJust put your images in the `\u003cpack\u003e/stickers` directory and run `tsticker push` to override your cloud sticker pack with\nthe local sticker pack. We support almost all image formats, including `png`, `jpg`, `jpeg`, `gif`, `webm`, and\n`mov` and so on.\n\nPlease don't operate lots of stickers at once time, if there is any error, it will break your workflow, but you can\nuse `tsticker sync` to recover.\n\n```bash\ntsticker push\n```\n\neven there are auto-resize and auto-convert, there still have some bad input such as too large image, too long video, so\nbe careful.\n\nThe name of the sticker file can be some direct emoji(like `😄some🧑` ), or you can fill in the name freely, and we will\nlook for the most similar\nemoji!\n\n## Limitations of `tsticker`\n\n| Note                            | Description                                                                                                          |\n|---------------------------------|----------------------------------------------------------------------------------------------------------------------|\n| **No Support for Tgs Stickers** | `tgs` format is not supported for this cli. We using mixed `png` and `webm` format for static and animated stickers. |\n| **Rate Limiting**               | Each request is throttled to 2 seconds to avoid being blocked by Telegram.                                           |\n| **Only Bot User**               | Stickers can only be managed through your bot or the official @Stickers bot by the sticker pack creator.             |\n\n## 📄 License\n\n`tsticker` is released under the MIT License. See [LICENSE](LICENSE) for more information.\n\n---\n\nEnhance your Telegram sticker creation process with `tsticker` and become part of our community striving to simplify\nsticker management through the command line!\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudoskys%2Ftsticker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsudoskys%2Ftsticker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudoskys%2Ftsticker/lists"}