Fluxora CLI & Multi-Arch Docker Guide
Script repeatable offline file conversions in zsh, bash, or CI runners using the same 266-pair engine that powers the Fluxora macOS desktop app.
Command Syntax & Verified Flags
Every flag below maps directly to filetool/cli.py. When invoking from a source checkout without activating .venv, substitute .venv/bin/python -m filetool.cli.
# Convert an iPhone HEIC photo to JPG at quality 90
fluxora photo.heic --to jpg --quality 90 --out-dir ./converted
# Transcode QuickTime MOV video to 1080p MP4 with CRF 22
fluxora clip.mov --to mp4 --crf 22 --resolution 1080p
# List compatible outputs for a file and verify local tools
fluxora report.pdf --list-formats
# Print full local binary dependency health report
fluxora --check-deps| Flag | Default | Behavior |
|---|---|---|
--to FORMAT | required | Target output format extension (for example jpg, mp4, pdf, docx). |
--out-dir DIR | source folder | Write converted file into a specific output directory (created if missing). |
--overwrite | false | Overwrite existing destination instead of appending (1) numeric suffixes. |
--quality 1-100 | 85 | Output quality for lossy image conversions (JPEG, WebP, HEIC, AVIF). |
--dpi INT | 300 | Rasterization DPI for PDF or vector-to-image conversions. |
--bitrate RATE | 192k | Audio stream bitrate (128k, 192k, 256k, 320k). |
--crf 0-51 | 23 | Video Constant Rate Factor for FFmpeg transcoding (lower = higher quality). |
--resolution RES | original | Video resolution preset: original, 1080p, 720p, or 480p. |
--list-formats | false | List registered outputs for the input extension and check tool availability. |
--check-deps | false | Display external CLI tool availability across bundle, Homebrew, and system paths. |
Headless Multi-Arch Docker CLI (Linux amd64 & arm64)
Run the exact same 266-pair conversion engine inside CI pipelines, servers, or Linux workstations with FFmpeg, ImageMagick, Pandoc, Poppler, Ghostscript, 7-Zip, and LibreOffice pre-installed:
docker run --rm -v "$PWD:/work" ghcr.io/sahilmore06/fluxora:latest photo.png --to jpg --quality 90
# Verify all bundled engines inside the container
docker run --rm ghcr.io/sahilmore06/fluxora:latest --check-depsmacOS Desktop Launch Options
# Launch the desktop window
.venv/bin/python app.py
# Start minimized in the macOS menu bar
.venv/bin/python -m filetool.app --daemon
# Replay the onboarding sequence and haptic wheel sandbox
.venv/bin/python app.py --intro