CLI & Docker Reference ยท v1.1.1

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.

Download Fluxora.dmg (macOS 13+) View MIT Source on GitHub Browse All 266 Pairs

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 FORMATrequiredTarget output format extension (for example jpg, mp4, pdf, docx).
--out-dir DIRsource folderWrite converted file into a specific output directory (created if missing).
--overwritefalseOverwrite existing destination instead of appending (1) numeric suffixes.
--quality 1-10085Output quality for lossy image conversions (JPEG, WebP, HEIC, AVIF).
--dpi INT300Rasterization DPI for PDF or vector-to-image conversions.
--bitrate RATE192kAudio stream bitrate (128k, 192k, 256k, 320k).
--crf 0-5123Video Constant Rate Factor for FFmpeg transcoding (lower = higher quality).
--resolution RESoriginalVideo resolution preset: original, 1080p, 720p, or 480p.
--list-formatsfalseList registered outputs for the input extension and check tool availability.
--check-depsfalseDisplay 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-deps

macOS 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