# Telegram WebM Converter
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
```
## 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/b5/52/597d78c8ec29e4a61fd907056cca4c449099b42dc550519d8a4cbc03a856/tg_webm_converter-0.1.0.tar.gz",
"platform": null,
"description": "# Telegram WebM Converter\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 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 command:\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## License\n\nMIT License\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Convert images to Telegram WebM stickers.",
"version": "0.1.0",
"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": "1df460f14717bd0edc93c6f0c616e0639b533ff0622e830c383356bcdd969363",
"md5": "8d3f0f33b77eec1fdc05a0a1cf231563",
"sha256": "6e26d54c9dc4c305b71b00ffb28f9cf723940d640efeb363cca10b9f29a29c8c"
},
"downloads": -1,
"filename": "tg_webm_converter-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8d3f0f33b77eec1fdc05a0a1cf231563",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.12",
"size": 6676,
"upload_time": "2025-08-14T12:15:02",
"upload_time_iso_8601": "2025-08-14T12:15:02.846120Z",
"url": "https://files.pythonhosted.org/packages/1d/f4/60f14717bd0edc93c6f0c616e0639b533ff0622e830c383356bcdd969363/tg_webm_converter-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b552597d78c8ec29e4a61fd907056cca4c449099b42dc550519d8a4cbc03a856",
"md5": "757bf6a62011e7b40835430265f92124",
"sha256": "e687741b2d9d4c0cf9ba8591a0be8a4d793fe6868392997813d3b0351ca96f28"
},
"downloads": -1,
"filename": "tg_webm_converter-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "757bf6a62011e7b40835430265f92124",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.12",
"size": 5439,
"upload_time": "2025-08-14T12:15:04",
"upload_time_iso_8601": "2025-08-14T12:15:04.596042Z",
"url": "https://files.pythonhosted.org/packages/b5/52/597d78c8ec29e4a61fd907056cca4c449099b42dc550519d8a4cbc03a856/tg_webm_converter-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-14 12:15:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "7591yj",
"github_project": "tg-webm-converter",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "tg-webm-converter"
}
JSON
