# Label Tool

## Area

- Route: `/labels`
- Purpose: use finished label presets for preview, batch printing, export and printer profiles

## When you use this area

Use the Label Tool when:

- the layout already exists
- you must separate A4 sheet output from label printer output
- you want to print or export several spool labels in one run
- PNG, JPEG, SVG or PDF are required for a fixed output workflow
- a saved printer profile should be reused

## Important functions

- preset browser with quick preview
- printer assistant with saved output profile
- batch printing for selected or filtered spools
- separate handling for A4 jobs and label printer jobs
- export as PDF, SVG, PNG or JPEG
- stable job files and export packages for serial runs
- direct preview per spool

## Step-by-step guide

### Step 1: Open the Label Tool

1. Open `Labels`.
2. Wait until filters, spool list, preview and sidebar are ready.

### Step 2: Choose a preset

1. Open the preset browser.
2. Select a system, printer or custom preset.
3. Jump to the designer if the preset must be refined.

### Step 3: Configure the output profile

1. Open the printer assistant.
2. Choose between `A4 sheet` and `Label printer`.
3. Set format, connection type, printer, port, baud rate, scale and copies.
4. Save the profile for later runs.

### Step 4: Define the spool set

1. Mark the required spools or prepare a filtered list.
2. Open a row preview for a single quality check.

### Step 5: Check the preview

1. Review the right-hand preview.
2. Check values, barcode or QR code, text size and margins.
3. Return to the designer if the preset must change.

### Step 6: Start batch printing or export

1. Use `Batch Selected` for marked rows or `Batch Filtered` for the current list.
2. In `A4 sheet` mode, a grouped job is created.
3. In `Label printer` mode, per-spool files are created and can also be bundled.

## Example inputs

```text
Preset: custom
Mode: label_printer
Format: PNG
Connection: usb_serial
Port: COM7
Baudrate: 19200
Spools: 10027, 10031, 10044
```

## Typical pitfalls

- wrong preset for the target printer
- mixing A4 and label printer expectations
- starting a batch without saving the printer profile
- skipping the preview before a serial run
