Command-line tool to convert videos and images between formats (FFmpeg + Pillow)
Project description
Video and Image Converter
Command-line tool to convert videos and images between formats (FFmpeg for video, Pillow for images).
Developed by L3CHUGU1T4
Install (PyPI)
Requires Python 3.8+ and FFmpeg (for video conversion; images work without it).
pip install video-converter-cli
Requirements
- Python 3.8+
- FFmpeg (for video conversion)
- Pillow (included via pip)
Usage
Run converter from any directory:
converter --help
Arguments and options
| Argument / Option | Description |
|---|---|
files |
One or more video or image files to convert. |
-o, --output PATH |
Output file path (only when converting a single file). |
--quality {ultrafast,fast,medium,slow,veryslow} |
Video encoding preset (default: medium). |
--crf N |
Video quality 18–28; lower = better (default: 22). |
Default output
- Videos:
<name>.mp4in the same directory. - Images: JPEG/JPG →
<name>.png; others →<name>.jpg.
Supported formats
- Video: AVI, MP4, MOV, MKV, WebM, FLV, WMV, M4V
- Image: JPEG, PNG, BMP, TIFF, WebP, GIF
Examples
converter video.avi
converter video.avi -o output.mov
converter image.jpg
converter image.png -o output.jpg
converter video.avi --quality slow --crf 18
converter file1.avi file2.jpg file3.png
Building an executable locally (optional)
If you want a standalone executable (no pip) on your machine:
pip install -r requirements.txt
python build_exe.py
python install.py
Or manually:
pip install pyinstaller
pyinstaller --onefile --name converter Converter.py
The executable will be in dist/converter (or dist/converter.exe on Windows).
Publishing to PyPI
To publish or update the package on PyPI:
pip install build twine
python -m build
twine upload dist/*.whl dist/*.tar.gz
(Use build_exe.py only for building the standalone executable; use python -m build for the PyPI package.)
Users can then install with: pip install video-converter-cli and run converter.
License
MIT License. See LICENSE.
Developed by L3CHUGU1T4
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file video_converter_cli-1.1.5.tar.gz.
File metadata
- Download URL: video_converter_cli-1.1.5.tar.gz
- Upload date:
- Size: 7.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
24fd9368f02d2507933d33e97881a9e36288f7b91b715fa78956cffaa1141798
|
|
| MD5 |
eea8f9770e4cd727e76b8e7763eea56a
|
|
| BLAKE2b-256 |
9db1c38e97f60bf8d1ef146fe49d1586ac140f4a74766ecfeee6f6c66052e9d2
|
File details
Details for the file video_converter_cli-1.1.5-py3-none-any.whl.
File metadata
- Download URL: video_converter_cli-1.1.5-py3-none-any.whl
- Upload date:
- Size: 8.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0264468efd50c4a59c2549d05f841bc8b265f573310d788f5a734a2375175a90
|
|
| MD5 |
793bc0b8c6c8e8a28dfda5804e38bd2c
|
|
| BLAKE2b-256 |
a015f29c6b4f0d458008825ce6decf68008c12c6329f50b2521b75a788922d67
|