Alchemist docs
Alchemist documentation

Find a page.

Type at least two characters.

    Docs menu

    Get Started

    Quick Start

    The essentials for getting Alchemist processing a media library — start the engine, monitor jobs, confirm hardware selection, and read skip reasons.

    Source revision aeebc48

    Assumes you’ve completed the setup wizard. If not, see First Run.

    Start the engine

    The engine starts paused after setup. Click Start in the header bar. If the header shows Stopping, the engine is draining; wait for active jobs to finish or use the Runtime controls to stop drain mode.

    Watch the queue

    Go to Jobs. Files move through: Queued → Analyzing → Encoding → Completed

    Skipped files appear in the Skipped tab with a plain-English reason. A high skip rate is normal — it means files are already efficiently compressed. See Skip Decisions.

    Check hardware detection

    Go to Settings → Hardware. Confirm your GPU is the active backend. If you see CPU (Software) with a supported GPU, open the probe log first, then see GPU Passthrough.

    On repeat boots, a valid cached hardware result may appear immediately while the full probe refreshes in the background.

    See your savings

    Once jobs complete, Statistics shows total space recovered, compression ratios, and a savings chart.

    Key controls

    ActionWhere
    Pause new job claimsSettings → Runtime → Pause
    Drain (finish active, stop new)Header → Stop
    Cancel a jobJobs → ⋯ → Cancel
    Boost priorityJobs → ⋯ → Boost
    Trigger manual scanSettings → Library → Scan
    Change engine modeSettings → Runtime

    See also

    Authoritative source

    This page is generated from the editable Markdown in the Alchemist repository.

    View docs/content/quick-start.md at aeebc48

    Documentation © Brooklyn Halmstad. Licensed under CC BY-SA 4.0.

    A Dead Signal Works project.