Skip to main content

Video and Image Converter

Command-line tool to convert videos and images between formats (FFmpeg for video, Pillow for images, rawpy for Canon CR2 RAW).

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 and rawpy (included via pip; rawpy may need LibRaw on your system if wheels are unavailable)

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>.mp4 in the same directory.
  • Images: JPEG/JPG → <name>.png; others (including CR2) → <name>.jpg.

Supported formats

  • Video: AVI, MP4, MOV, MKV, WebM, FLV, WMV, M4V
  • Image: JPEG, PNG, BMP, TIFF, WebP, GIF, CR2 (Canon RAW)

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
converter canon.cr2
converter canon.cr2 -o developed.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

Release files for video-converter-cli 1.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for video-converter-cli 1.1.7
File Size Uploaded
video_converter_cli-1.1.7.tar.gz 8.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for video-converter-cli 1.1.7
File Interpreter ABI Platform
video_converter_cli-1.1.7-py3-none-any.whl Python 3 none any Details

Total release size: 17.5 kB

Release files / video_converter_cli-1.1.7.tar.gz

Download URL video_converter_cli-1.1.7.tar.gz
Size 8.4 kB
Tags Source
SHA-256 checksum
How to use checksums
af883611d7c2fcaca08043e17c221aba10db6de098f9437038180125a7ad9109
BLAKE2b-256 checksum
How to use checksums
51ac25c22c88d7918d7bf69f046a8c1eca09a9ff400bc937b54835b9021c4f84
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / video_converter_cli-1.1.7-py3-none-any.whl

Download URL video_converter_cli-1.1.7-py3-none-any.whl
Size 9.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
15c20181cc440b276d278eb114417902d27f29b1557822995a0aca9940f15617
BLAKE2b-256 checksum
How to use checksums
ce40056b7f482a4e29ee56d973e25fbab2770564457c83ff28a0c5fad6c37691
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release history Release notifications | RSS feed

This release

1.1.7 This release

2 release files

1.1.6

2 release files

1.1.5

2 release files

1.1.4

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page