Getting Started

Get the CLI installed and running in a few minutes.

Installation

The CLI is bundled with the Derivv Pro desktop app. To install the derivv command, open the desktop app and go to Settings → CLI and click Install CLI.

This creates a symlink at /usr/local/bin/derivv that points to the binary bundled inside the app. On macOS you may be prompted for your password to write to /usr/local/bin.

Once installed, verify it's working:

derivv --version

Authentication

The CLI shares its session with the desktop app — there is no separate login. As long as you are signed into the desktop app with an active Derivv Pro subscription, the CLI will work.

To check your account status:

derivv status

This shows your version, account email, plan, and session status. If the session has expired, open the desktop app and sign in again.

Your first resize

Resize a single image to 800×600:

derivv resize photo.jpg -o resized.jpg -w 800 -H 600

Or use a saved preset to batch-process a directory:

derivv batch ./photos -o ./output -C "my-preset"

Presets created in the desktop app are immediately available in the CLI, and vice versa.

Loading images into the app

If you want to scrub through images in the desktop UI before processing — or use features that only run inside the app, like uploads to bound S3 / WordPress connections — use load:

derivv load ./photos -C "web-thumbnails"

The app opens (or focuses if it's already running), the images appear as originals, and the preset is preselected for you. Tweak anything you want and hit Process when you're ready.

Next steps

• See the command reference for the full list of commands and options
• Use derivv <command> --help for inline help on any command