commands.md

Command Line Reference

Basic Usage

labelingo IMAGE [IMAGE...]           # Process one or more images
labelingo --help                     # Show help message

Arguments

IMAGE [IMAGE...] : One or more image files to process. Supports glob patterns (e.g., *.png).

Options

Output Control

-o, --output DIRECTORY : Save output files to specified directory. Directory will be created if it doesn't exist.

labelingo image.png -o outputs/      # Save to outputs/image-annotated.svg
labelingo *.png -o translated/       # Process multiple files to translated/ directory

-t, --type [svg|png|pdf] : Specify output format. Defaults to SVG if not specified.

labelingo image.png --type pdf       # Output as PDF
labelingo *.png -t png -o pngs/     # Convert all PNGs to annotated PNGs

Translation Options

-l, --language LANG : Target language for translations (e.g., 'fr' for French, 'ja' for Japanese). Defaults to system locale.

labelingo image.png -l fr           # Translate to French
labelingo *.png -l ja              # Translate multiple files to Japanese

--scene-analysis [claude|openai] : backend to use for overall image analysis. Defaults to OpenAI.

labelingo image.png --scene-analysis claude        # Use Claude Vision API
labelingo image.png --scene-analysis tesseract     # Use Tesseract OCR

--label-location [claude|tesseract|easyocr|paddleocr] : OCR backend to use for text detection. Defaults to easyocr.

labelingo image.png --label-location easyocr       # Use EasyOCR
labelingo image.png --label-location tesseract     # Use Tesseract OCR

Preview and Opening

--preview/--no-preview : Open result in web browser after processing.

labelingo image.png --preview       # View result in browser

--open : Open result with system default application.

labelingo image.png --open          # Open with default app

Cache Control

--no-cache : Skip using cached responses for this run.

labelingo image.png --no-cache      # Force fresh processing

--clear-cache : Clear all cached responses and exit.

labelingo --clear-cache             # Remove all cached responses

Debugging

--debug/--no-debug : Show debug information during processing.

labelingo image.png --debug         # Show detailed processing info

Examples

Basic Operations

Process a single image:

labelingo screenshot.png

Process multiple specific files:

labelingo login.png settings.png profile.png

Process all PNG files in current directory:

labelingo *.png

Output Management

Save all processed files to a specific directory:

labelingo screenshots/*.png -o translated/

Convert multiple files to PDF:

labelingo ui/*.png --type pdf -o pdfs/

Language and Backend Combinations

Process multiple files in Japanese using Claude backend:

labelingo *.png -l ja --backend claude

Use Tesseract OCR with French translation:

labelingo screenshot.png -l fr --backend tesseract

Debug and Testing

Process with debug output and preview:

labelingo image.png --debug --preview

Force fresh processing without cache:

labelingo image.png --no-cache --debug