Skip to main content

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>.mp4 in 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

video_converter_cli-1.0.0.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

video_converter_cli-1.0.0-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file video_converter_cli-1.0.0.tar.gz.

File metadata

  • Download URL: video_converter_cli-1.0.0.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for video_converter_cli-1.0.0.tar.gz
Algorithm Hash digest
SHA256 aea1620f7160fb72216af2cf06dd7e738c0e2a255a7a98ccaf839b26f665ec0e
MD5 23a95d0971c31c1c511db0c6c7219097
BLAKE2b-256 4c1e3d577ada224eaf5a026e2181529e9b13dce1bc73308b039957f0dc8f4837

See more details on using hashes here.

File details

Details for the file video_converter_cli-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for video_converter_cli-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 05b1daf2d46ec6c20b7a8f1d67bcf7176d3cfb53f00d900367361e87cf5904c0
MD5 c20d173b221fc58dde9da54e4d85f49b
BLAKE2b-256 b7d9cc21cd25d876c3f550fbb016073717a7a1d7a9729907fe64611f0476556a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page