A lightning-fast, interactive command-line media conversion tool built in pure Python.
Mooper is a modern, dependency-light CLI tool for converting media files between formats.
Unlike most converters that simply act as wrappers around subprocess.run(["ffmpeg"]), Mooper interfaces directly with libavcodec and libavformat natively in Python memory via PyAV. This guarantees blazing fast performance, cross-platform compatibility, and an incredibly low resource footprint.
Features
- Interactive UI: Just point it at a file or folder. Mooper detects the media type and provides a beautiful interactive menu for conversion targets.
- Intelligent Batch Processing: Point it at a folder to automatically categorize, group, and convert mixed media files into organized subfolders.
- Mobile VFR Support: Advanced two-pass video engine specifically handles Variable Frame Rate (VFR) iPhone and Android footage without green frames or audio desync.
- Remux-First: Instantly remuxes container-compatible files (e.g. H.264 in
.mov→.mp4) without re-encoding to preserve 100% original quality. - Persistent Config: Use
mooper configto open a visual editor for default qualities, frame rates, and overwrite policies. - Live Progress: Granular, real-time
tqdmprogress bars for every frame and audio packet.
Installation
Mooper requires Python 3.8 or newer. Install it globally via pip:
pip install mooper
Quick Start
1. Interactive Conversion
The easiest way to use Mooper is to simply point it at a file. It will detect the format and ask you what to do.
mooper my_video.MOV
Detected video file (.mov).
? Select target format to convert to:
> .mp4
.mkv
.webm
2. Intelligent Batch Folders
Point Mooper at an entire directory of mixed media. It will scan the folder and let you map out conversions for each filetype.
mooper ./vacation_media
Scanning directory for formats...
Found 2 format(s):
.mov: 10 file(s)
.jpg: 5 file(s)
? Select target format for .mov (10 files): .mp4
? Select target format for .jpg (5 files): .webp
Mooper will automatically create vacation_media_converted/mov_to_mp4/ and process your files!
3. Explicit / Scripting Mode
You can bypass the interactive menus by specifying the input and output directly:
mooper input.png output.webp
mooper recording.mov clip.mp4
4. Advanced Extractions
Extract Audio from Video:
mooper video.mp4 audio.mp3
Extract a Single Frame as an Image:
mooper video.mp4 thumbnail.jpg --frame 150
Compile an Image Sequence into a Video:
mooper ./folder_of_frames output_video.mp4 --fps 30
CLI Commands Reference
Mooper can be run without any arguments to see the interactive landing screen, or run with arguments for precise control.
mooper [input] [output] [options]
Arguments
| Argument / Flag | Description |
|---|---|
input |
Path to input file or directory |
output |
Path to output file or directory (optional — triggers interactive mode if omitted) |
--quality [low|mid|high] |
Override quality for this specific conversion |
--low-resource |
Use lightweight encoding settings (single-threaded, ultrafast preset) |
--frame N |
Extract frame number N (only applies when converting video → image) |
--fps N |
Set framerate for image sequence encoding (default: 24) |
--format .ext |
Target extension for explicit CLI-driven batch conversion |
Configuration Commands
Mooper saves your preferences persistently to ~/.mooper_config.json.
| Command | Description |
|---|---|
mooper |
Show the landing screen containing your current global settings. |
mooper config |
Open the full Interactive Settings Editor to visually change defaults. |
mooper config set <key> <value> |
Scriptable command to update a setting directly (e.g. mooper config set quality high). |
Available Config Keys:
quality(low,mid,high)low_resource(on,off)default_video_format(e.g.,mp4)default_image_format(e.g.,png)default_fps(e.g.,30)recursive_batch(yes,no) — determines if batch processing looks inside subfolders.overwrite_policy(ask,overwrite,skip)
Supported Formats
- Video:
.mp4,.mov,.mkv,.avi,.webm,.flv,.wmv,.ts,.ogv - Audio:
.mp3,.aac,.wav,.flac,.ogg,.m4a - Images:
.png,.jpg,.jpeg,.webp,.bmp,.gif,.tiff,.ico
License
MIT License. See LICENSE for details.
Metadata
Release files for mooper 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mooper-0.1.1.tar.gz | 23.9 kB | Without provenance | Details for mooper-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mooper-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for mooper-0.1.1-py3-none-any.whl |
Total release size: 47.2 kB
Release files / mooper-0.1.1.tar.gz
| Download URL | mooper-0.1.1.tar.gz |
|---|---|
| Size | 23.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c81ade320b11ced4ca45043a6bfacfa7cb8564f936d7db99e8c021da1cffa1b
|
|
BLAKE2b-256 checksum How to use checksums |
fd69eedf71b8392abd2ce720a939e037c954464edd0ed8cc6e4e3f9c259a7b07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
Release files / mooper-0.1.1-py3-none-any.whl
| Download URL | mooper-0.1.1-py3-none-any.whl |
|---|---|
| Size | 23.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
42b4e97eed47d56c1a0874de903aada8ca6fef9586c502c8f8ec9bfd821b20a2
|
|
BLAKE2b-256 checksum How to use checksums |
e6c6187e952bf7c443495b398efd1aaa34778fa8783b0898a1a9f13d86f8dd67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
Security for mooper 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.