xtc/screenshots/README.md

# xtc screenshots

All captures refreshed from the Phase 68 FLTK application on 2026-11-06.
These are actual rendered application windows and menus on a 1440 × 960 virtual
X11 screen, without mockups, compositing or image edits.

![Arrangement with named sections](overview.png)

The temporary demonstration project starts from
`examples/projects/modern-session.xtc`, adding Intro/Verse/Chorus/Outro markers,
a routed music bus and gain automation. Editing results use the real control
APIs and GUI history/preparation paths. Original projects, media and user
configuration are not overwritten. Black margins are the virtual desktop;
floating views show the actual detached windows together.

## New arrangement and composition workflows

| Phase | Feature | Captures |
| --- | --- | --- |
| 58 | Persistent named arrangement markers | [Ruler](arrangement-markers.png), [marker editor](marker-edit.png) |
| 59 | Section navigation and looping | [Current section loop](section-navigation.png) |
| 60 | Ripple time insertion/removal | [Controls](ripple-time.png), [inserted gap](ripple-result.png) |
| 61 | Complete track duplication | [Independent layered track](track-duplication.png) |
| 62 | Nondestructive MIDI splitting | [Split clip](midi-split.png) |
| 63 | MIDI clip consolidation | [Consolidated clip](midi-consolidation.png) |
| 64 | Seeded MIDI humanization | [Timing, velocity and seed](midi-humanize.png) |
| 65 | Chord construction | [Intervals](midi-chord-builder.png), [generated notes](midi-chords-result.png) |
| 66 | Offline arpeggio generation | [Step, gate and direction](midi-arpeggio.png), [written pattern](midi-arpeggio-result.png) |
| 67 | Audio peak normalization | [Target dBFS](audio-normalization.png), [normalized clip](audio-normalization-result.png) |
| 68 | Portable media collection | [New destination folder](project-collection.png) |

Collection is also executed by the capture tool into its temporary directory;
the screenshot shows its destination prompt, not a file browser or progress UI.
See [COMPOSITION_WORKFLOWS.md](../docs/COMPOSITION_WORKFLOWS.md) for precise
behavior, limits and commands. The screenshots illustrate implemented workflows;
they do not establish feature parity with other DAWs.

## Refreshed application views

All pre-existing images below were recaptured. Mixer playback meters come from
real JACK callbacks. The minimum-size capture uses a 1220 × 720 main window;
the scrolled view adds twelve tracks. Audio views import the repository's
`original-pluck.wav` and apply clip gain/fades. Plugin views use repository test
fixtures, not commercial plugins. Internal instrument menus and delay/reverb
editors show the real available devices and controls. The command palette uses
the current application action list.

- [Sequencer loop](sequencer-loop.png)
- [Mixer automation](mixer-automation.png)
- [Modular graph](modular-graph.png)
- [Piano roll velocity](piano-roll-velocity.png)
- [Sequencer audio waveform](sequencer-audio-waveform.png)
- [Preferences audio](preferences-audio.png)
- [Preferences plugins](preferences-plugins.png)
- [Preferences interface](preferences-interface.png)
- [Preferences editing](preferences-editing.png)
- [Preferences project defaults](preferences-project_defaults.png)
- [Preferences transport](preferences-transport.png)
- [Plugin library](plugin-library.png)
- [Plugin descriptors](plugin-descriptors.png)
- [Plugin controls](plugin-controls.png)
- [Midi controller mapping](midi-controller-mapping.png)
- [Loop range](loop-range.png)
- [About](about.png)
- [Audio clip properties](audio-clip-properties.png)
- [Clap instrument descriptors](clap-instrument-descriptors.png)
- [Vst2 instrument descriptors](vst2-instrument-descriptors.png)
- [Vst3 instrument descriptors](vst3-instrument-descriptors.png)
- [Mixer playing](mixer-playing.png)
- [Mixer minimum size](mixer-minimum-size.png)
- [Mixer scrolled session](mixer-scrolled-session.png)

- [Commands](commands.png)

- [Internal instruments](internal-instruments.png)
- [Internal delay](internal-delay.png)
- [Internal reverb](internal-reverb.png)

- [Detached transport with BPM and loop settings](transport-detached.png)
- [Detached mixer](mixer-detached.png)
- [Workspace with transport and mixer detached](workspace-detached.png)


- [Detached sequencer](sequencer-detached.png)
- [Detached modular graph](graph-detached.png)

Detach panels from the View menu; close a floating window or use its Dock button
to return it to the main window.

## Reproduce the gallery

From the repository root, run:

```sh
make BUILD_DIR=build/next-daw screenshots
```

This optional documentation target requires the existing FLTK/JACK build
prerequisites, a running JACK server, Xvfb (`xvfb-run`), ImageMagick (`import`) and
`xdotool`. It builds the repository plugin fixtures, runs
[the capture tool](../tools/capture_screenshots.cpp), and replaces the gallery
PNGs. All demonstration edits and collection outputs use an automatically removed
temporary directory; no preferences are saved. It neither installs dependencies
nor starts/reconfigures the audio server.