mooper 0.1.0

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 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

Configuration Commands

Mooper saves your preferences persistently to ~/.mooper_config.json.

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.