Skip to main content

Mooper Logo

A lightning-fast, interactive command-line media conversion tool built in pure Python.

PyPI Version Python Versions License: MIT


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 config to open a visual editor for default qualities, frame rates, and overwrite policies.
  • Live Progress: Granular, real-time tqdm progress 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)

Source distribution for mooper 0.1.1
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)

Table of built distributions (wheels) for mooper 0.1.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

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