> For the complete documentation index, see [llms.txt](https://docs.viesus.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.viesus.com/configuration/presets-gallery.md).

# Presets Gallery

Each preset is a ready-to-use `viesusini.json` tuned for a specific workflow. Download the JSON, pass it to VIESUS with the `-p` flag (CLI), point your Folder Enhancer at it, or load it into the Node.js module.

{% hint style="success" %}
**Start with a preset, then customise.** The fastest way to get a working configuration is to take a preset close to your need and adjust the few parameters that matter for your case. The **VIESUS Viewer** lets you load a preset, preview its output, and tweak parameters interactively.
{% endhint %}

<button type="button" class="button secondary" data-action="ask" data-query="Which VIESUS preset should I start with for my workflow, and what would I change? Ask me about my images and goals." data-icon="gitbook-assistant">Which preset fits my workflow?</button>

***

## Available presets

<table data-view="cards"><thead><tr><th></th><th></th><th data-type="files"></th><th data-hidden data-card-cover data-type="image"></th></tr></thead><tbody><tr><td><h4>Default</h4></td><td><ul><li>Standard automatic enhancement (color, contrast, brightness, sharpening, noise reduction)</li><li>No AI upscaling</li><li>vScene mode OFF</li><li>CPU-only — no GPU required</li></ul></td><td><a href="/files/KcuBoWB0Kbma4PUf9tNv">/files/KcuBoWB0Kbma4PUf9tNv</a></td><td><a href="/files/E4JjOos7P7724jjCYkyn">/files/E4JjOos7P7724jjCYkyn</a></td></tr><tr><td><h4>vScene Enabled</h4></td><td><ul><li>Same as Default, plus scene-aware enhancement</li><li>Per-scene tuning: Landscape, People, Night, Black &#x26; White, Beach, Snow, Sunset, etc.</li><li>CPU-only</li></ul></td><td><a href="/files/NEJVgym1uFbp9jV3ejG8">/files/NEJVgym1uFbp9jV3ejG8</a></td><td><a href="/files/E4JjOos7P7724jjCYkyn">/files/E4JjOos7P7724jjCYkyn</a></td></tr><tr><td><h4>AI Upscaling (full)</h4></td><td><ul><li>4× AI upscaling</li><li>AI Artifacts Removal (JPEG compression cleanup)</li><li>AI Facial Reconstruction for natural high-res faces</li><li>vScene ON, full color correction</li><li>Requires GPU</li></ul></td><td><a href="/files/xGNawLFdQ0SrTaN4P8RX">/files/xGNawLFdQ0SrTaN4P8RX</a></td><td><a href="/files/E4JjOos7P7724jjCYkyn">/files/E4JjOos7P7724jjCYkyn</a></td></tr><tr><td><h4>AI Upscaling Only</h4></td><td><ul><li>4× upscaling without color correction</li><li>Use when input is already color-corrected upstream</li><li>Requires GPU</li></ul></td><td><a href="/files/WyZsB5kKV0oWQNPxUslB">/files/WyZsB5kKV0oWQNPxUslB</a></td><td><a href="/files/E4JjOos7P7724jjCYkyn">/files/E4JjOos7P7724jjCYkyn</a></td></tr><tr><td><h4>Background Removal</h4></td><td><ul><li>Removes background from portrait images</li><li>Saves as PNG with transparent alpha channel</li><li>No color correction or upscaling</li></ul></td><td><a href="/files/tt0gPF9k02U1ty1tJuJn">/files/tt0gPF9k02U1ty1tJuJn</a></td><td><a href="/files/E4JjOos7P7724jjCYkyn">/files/E4JjOos7P7724jjCYkyn</a></td></tr><tr><td><h4>Background Removal + Enhance</h4></td><td><ul><li>Background removal plus full color correction</li><li>Saves as PNG with transparent alpha channel</li><li>Best for product photography and ID workflows</li></ul></td><td><a href="/files/aFmulRuimP7zROSKXWuh">/files/aFmulRuimP7zROSKXWuh</a></td><td><a href="/files/E4JjOos7P7724jjCYkyn">/files/E4JjOos7P7724jjCYkyn</a></td></tr></tbody></table>

{% hint style="info" %}
Each preset is a complete `viesusini.json` — every parameter is present, so you can drop it in and run as-is, or open it and tune just the values you care about. The AI presets (upscaling, background removal) require an NVIDIA GPU; see the hardware notes below.
{% endhint %}

***

## Customise a preset

The fastest workflow:

{% stepper %}
{% step %}

### Pick the closest preset

Start with a preset that's already close to what you need. Don't start from scratch unless you have a specific reason.
{% endstep %}

{% step %}

### Open in the VIESUS Viewer

Load the JSON into the [VIESUS Viewer](/tools/viesus-viewer.md), open a representative image, and preview the output.
{% endstep %}

{% step %}

### Adjust the few parameters that matter

For most cases, only a handful of parameters need tuning. The Viewer shows immediate before/after previews so you can iterate fast.
{% endstep %}

{% step %}

### Save and use it

Save the customised JSON with a descriptive name (e.g. `photo-lab-workflow-xyz.json`) and use it.
{% endstep %}
{% endstepper %}

For the full parameter reference, see [Configuration → Parameters](/configuration/parameter-reference.md).

***

## How to use a preset

{% tabs %}
{% tab title="CLI" %}
Pass the preset path with `-p`:

```bash
viesus -p default.json -s -f input.jpg
```

This enhances `input.jpg` and saves the result alongside it with the `_viesus` suffix. See the [CLI Reference](/reference/cli-reference.md) for all flags.
{% endtab %}

{% tab title="Folder Enhancer" %}
Place the preset in your watched folder's config directory, or point the Folder Enhancer settings at it. See [PDF Enhancer Settings Reference](/configuration/pdf-settings.md) for the analogous PDF workflow.
{% endtab %}

{% tab title="Node.js Module" %}
Load the JSON and pass the parsed object to the module:

```javascript
const fs = require('fs');
const viesus = require('viesus');

const config = JSON.parse(fs.readFileSync('default.json', 'utf8'));
await viesus.enhance({ input: 'input.jpg', output: 'output.jpg', config });
```

See the [Node.js API Reference](/reference/node.js-module/api-reference.md) for the full signature.
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.viesus.com/configuration/presets-gallery.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.