# Telegram WebM Converter
> This project started off as
> a [shell script](https://github.com/7591yj/converts/blob/main/batch_convert_telegram_webm.sh) for my own personal
> needs
> , so please do expect some rough edges.<br>
> If you find any bugs or have suggestions, please open an issue.
> Thank you for your feedback!
Convert images to Telegram WebM stickers.
## Features
- Convert an image to 100x100 WebM icon (max 32KB)
- Convert images to 512x512 WebM stickers (max 256KB)
- Batch processing support
- Automatic size optimization
## Requirements
- Python 3.8+
- FFmpeg
This application requires [FFmpeg](https://ffmpeg.org/) to be installed on your system.
FFmpeg is open-source software licensed under the LGPLv2.1/GPLv2 (or later).
Please refer to the FFmpeg website for more details on its licensing.
## Installation
```bash
pip install tg-webm-converter
```
## Usage
```bash
# Convert all images in current directory
tg-webm-converter
# Convert specific file to icon, others to stickers
tg-webm-converter -i icon.png
# Convert only one file to sticker
tg-webm-converter -f image.jpg
# Convert only one file to icon
tg-webm-converter --icon-file icon.png
```
## Build from Source
### Prerequisites
- Python 3.8+
- Poetry: `curl -sSL https://install.python-poetry.org | python3 -`
- [FFmpeg](https://ffmpeg.org/): As mentioned above, FFmpeg is a core dependency. Ensure it's installed and accessible
in your system's PATH.
### Setup
1. Clone the repository
```bash
git clone https://github.com/7591yj/tg-webm-converter.git
cd tg-webm-converter
```
2. Install Dependencies with Poetry
Poetry will automatically create a virtual environment for the project and install all required dependencies.
```bash
poetry install
```
### Running from Source
Once the development environment is set up, you can run the tg-webm-converter command directly using Poetry's run
command:
```bash
# Run the application (same as `tg-webm-converter` if installed via pip)
poetry run tg-webm-converter
# Example: Convert all images in current directory
poetry run tg-webm-converter
# Example: Convert specific file to icon
poetry run tg-webm-converter --icon-file icon.png
# Run tests
poetry run pytest
```
## Future Plans
- Consider a GUI version for easier use.
- Optimize performance for large batch conversions.
- Explore options for even smaller file sizes.
## License
MIT License
Raw data
{
"_id": null,
"home_page": null,
"name": "tg-webm-converter",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.12",
"maintainer_email": null,
"keywords": "webm, sticker, icon, conversion, ffmpeg",
"author": "Yeongjin Kim",
"author_email": "77034308+7591yj@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/cb/22/82e61e91c7d639928f76a1c0d357e9598852bf710a6938001db50d156f20/tg_webm_converter-0.1.1.tar.gz",
"platform": null,
"description": "# Telegram WebM Converter\n\n> This project started off as\n> a [shell script](https://github.com/7591yj/converts/blob/main/batch_convert_telegram_webm.sh) for my own personal\n> needs\n> , so please do expect some rough edges.<br>\n> If you find any bugs or have suggestions, please open an issue.\n> Thank you for your feedback!\n\nConvert images to Telegram WebM stickers.\n\n## Features\n\n- Convert an image to 100x100 WebM icon (max 32KB)\n- Convert images to 512x512 WebM stickers (max 256KB)\n- Batch processing support\n- Automatic size optimization\n\n## Requirements\n\n- Python 3.8+\n- FFmpeg\n\nThis application requires [FFmpeg](https://ffmpeg.org/) to be installed on your system.\nFFmpeg is open-source software licensed under the LGPLv2.1/GPLv2 (or later).\nPlease refer to the FFmpeg website for more details on its licensing.\n\n## Installation\n\n```bash\npip install tg-webm-converter\n```\n\n## Usage\n\n```bash\n# Convert all images in current directory\ntg-webm-converter\n\n# Convert specific file to icon, others to stickers\ntg-webm-converter -i icon.png\n\n# Convert only one file to sticker\ntg-webm-converter -f image.jpg\n\n# Convert only one file to icon\ntg-webm-converter --icon-file icon.png\n```\n\n## Build from Source\n\n### Prerequisites\n\n- Python 3.8+\n- Poetry: `curl -sSL https://install.python-poetry.org | python3 -`\n- [FFmpeg](https://ffmpeg.org/): As mentioned above, FFmpeg is a core dependency. Ensure it's installed and accessible\n in your system's PATH.\n\n### Setup\n\n1. Clone the repository\n\n ```bash\n git clone https://github.com/7591yj/tg-webm-converter.git\n cd tg-webm-converter\n ```\n\n2. Install Dependencies with Poetry\n\n Poetry will automatically create a virtual environment for the project and install all required dependencies.\n\n ```bash\n poetry install\n ```\n\n### Running from Source\n\nOnce the development environment is set up, you can run the tg-webm-converter command directly using Poetry's run\ncommand:\n\n```bash\n# Run the application (same as `tg-webm-converter` if installed via pip)\npoetry run tg-webm-converter\n\n# Example: Convert all images in current directory\npoetry run tg-webm-converter\n\n# Example: Convert specific file to icon\npoetry run tg-webm-converter --icon-file icon.png\n\n# Run tests\npoetry run pytest\n```\n\n## Future Plans\n\n- Consider a GUI version for easier use.\n- Optimize performance for large batch conversions. \n- Explore options for even smaller file sizes.\n\n## License\n\nMIT License\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Convert images to Telegram WebM stickers.",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/7591yj/tg-webm-converter",
"Repository": "https://github.com/7591yj/tg-webm-converter"
},
"split_keywords": [
"webm",
" sticker",
" icon",
" conversion",
" ffmpeg"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3b6c2abcdcbb84d8dd3212531630664e42f8e9dbd0d9f68262d129695e1d9917",
"md5": "32ac67c90cf4438aa25438f14718551d",
"sha256": "53ac2c05bd6f4de2531e5fabb9a46377e428cf2225b309ad196509e31b9b3b81"
},
"downloads": -1,
"filename": "tg_webm_converter-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "32ac67c90cf4438aa25438f14718551d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.12",
"size": 7925,
"upload_time": "2025-09-01T07:35:02",
"upload_time_iso_8601": "2025-09-01T07:35:02.293669Z",
"url": "https://files.pythonhosted.org/packages/3b/6c/2abcdcbb84d8dd3212531630664e42f8e9dbd0d9f68262d129695e1d9917/tg_webm_converter-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "cb2282e61e91c7d639928f76a1c0d357e9598852bf710a6938001db50d156f20",
"md5": "3e4cc74f26f54fd671bb2634989c0f78",
"sha256": "7f6925d520aca3acb44f7245037744c5184cfca84bc8860b1593a0b37ef13bef"
},
"downloads": -1,
"filename": "tg_webm_converter-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "3e4cc74f26f54fd671bb2634989c0f78",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.12",
"size": 6335,
"upload_time": "2025-09-01T07:35:04",
"upload_time_iso_8601": "2025-09-01T07:35:04.674962Z",
"url": "https://files.pythonhosted.org/packages/cb/22/82e61e91c7d639928f76a1c0d357e9598852bf710a6938001db50d156f20/tg_webm_converter-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-01 07:35:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "7591yj",
"github_project": "tg-webm-converter",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "tg-webm-converter"
}
JSON
