diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index ba198dd7..4919d608 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -100,6 +100,8 @@ jobs:
sudo apt-get update
sudo apt-get install -y libpulse0 libarchive-tools
sudo apt-get install -y libasound2t64 || sudo apt-get install -y libasound2
+ # zsyncmake: AppImageUpdate'in parça parça indirme dosyası (#640)
+ sudo apt-get install -y zsync binutils
# ffmpeg-static kurulum sonrasi kendi ikilisini GitHub'dan indiriyor ve o
# uc ara sira 500 donuyor; npm ci o zaman dusuyor. v3.1.3 etiketinde tam
@@ -123,12 +125,22 @@ jobs:
# olmadan electron-builder anahtarlıkta olmayan bir sertifika arar.
CSC_IDENTITY_AUTO_DISCOVERY: false
+ # AppImageUpdate (#640): güncelleme bilgisi AppImage çalışma zamanının
+ # .upd_info ELF bölümüne yazılıyor ve yanına .zsync üretiliyor.
+ # appimagetool ile yeniden paketlemek yerine bölüme doğrudan yazılıyor:
+ # ikinci bir ikili indirilmiyor, electron-builder'ın çalışma zamanı
+ # değişmiyor. Bölüm yoksa ya da bilgi sığmıyorsa iş KIRMIZI olur.
+ - name: AppImage update information
+ if: runner.os == 'Linux'
+ shell: bash
+ run: bash scripts/appimage-update-info.sh
+
- name: Collect installers
shell: bash
run: |
mkdir -p out
find dist -maxdepth 1 -type f \
- \( -name '*.dmg' -o -name '*.zip' -o -name '*.AppImage' -o -name '*.deb' \) \
+ \( -name '*.dmg' -o -name '*.zip' -o -name '*.AppImage' -o -name '*.AppImage.zsync' -o -name '*.deb' \) \
-exec cp {} out/ \;
ls -la out
diff --git a/LICENSE b/LICENSE
index 1474d865..a432a623 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
MIT License
-Copyright (c) 2026 CaYaDev (https://cayadev.com)
+Copyright (c) 2026 Çağan Turgut (CaYatur) — CaYaDev, https://cayadev.com
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
diff --git a/README.md b/README.md
index a8272429..ce53d1f2 100644
--- a/README.md
+++ b/README.md
@@ -1,213 +1,1169 @@
-
+
# CAYADEV Visualizer
-### Audio-reactive visuals for every screen you own
+### Free, open-source music visualizer and VJ software for every screen you own
-**Windows** · **macOS** · **Linux** · Electron + WebGL2 · Native WASAPI / CoreAudio / PulseAudio capture
+Turn whatever your computer is playing — Spotify, YouTube, a DAW, a DJ set, a game — into
+audio-reactive visuals on one display or ten. A real **MilkDrop** engine, **60 visualizer modes**,
+layers and **40 GPU effects**, an **OBS overlay**, **Spout / Syphon**, **projection mapping**,
+**RGB lighting**, a **timeline and clip deck** for live shows, and **AI control over MCP**.
+**Windows** · **macOS** · **Linux** — no account, no telemetry, MIT licensed.
+
+[](https://github.com/CaYatur/SoundVisualizer/releases/latest)
+[](https://github.com/CaYatur/SoundVisualizer/releases)
[](LICENSE)
-[](#build--distribution)
+[](#download)
+[](#tests)
[](https://www.electronjs.org/)
-[](#tests)
-[](https://cayadev.com)
+
+
+
+
+
+**[Run from source](#run-from-source)** ·
+**[Features](#features-in-detail)** ·
+**[FAQ](#faq)** ·
+**[Türkçe](README.tr.md)**
+
+
+> **About the version labels.** The current release is **v3.1.4**. Everything on this page is in
+> the source on `main`; items marked 3.1.5 ship with the next release, v3.1.5, and are
+> not in the v3.1.4 download yet. Run from source to use them today.
+
---
-## In motion
+## Why CAYADEV Visualizer
+
+- **No Stereo Mix, no virtual cable on Windows.** System audio is captured straight from your
+ speakers or headphones (WASAPI loopback), alongside microphones and line inputs — or from **one
+ application only**, so the visuals follow Spotify and ignore the game and the voice chat.
+ [→ Audio](#audio-capture-and-analysis)
+- **Every screen, one engine.** Full-screen windows on every display you pick, a transparent
+ **OBS browser source**, **Spout / Syphon** for Resolume, TouchDesigner and MadMapper, and a
+ **phone remote** — all drawing the same picture. [→ Outputs](#outputs-screens-obs-spout-and-syphon)
+- **MilkDrop that really runs your presets.** Per-frame and per-pixel equations, the warp mesh,
+ HLSL shaders translated to GLSL, measured against **10,347 real presets** and frame by frame
+ against a reference MilkDrop 2 renderer. Import whole libraries, browse them as thumbnails, edit presets live,
+ or generate new ones 3.1.5. [→ MilkDrop](#milkdrop)
+- **A compositor, not a single effect.** Unlimited layers, 17 blend modes, masks, an A/B
+ crossfader, 40 GPU effects per layer or on the whole frame, and a modulation matrix that routes
+ LFOs, envelopes and live audio analysis to any setting. [→ Layers](#layers-masks-and-effects)
+- **Built for live shows.** A **timeline** with automation lanes, a **clip deck** with beat-quantised
+ launching, **Auto VJ** that changes scenes on the bar, tap tempo, **MIDI** and **OSC**.
+ [→ Show control](#show-control-timeline-clip-deck-auto-vj-midi-and-osc)
+- **Ready for the stage.** Projection mapping with corner pin, mesh warp and soft-edge blending
+ for multi-projector rigs, plus **aspect correction** for LED walls whose pixels are not square.
+ [→ Stage](#stage-projection-mapping-and-aspect-correction)
+- **Your lights follow the music.** **Windows Dynamic Lighting**, **OpenRGB** on every platform and
+ **Art-Net / DMX**, all fed by one renderer — they can even take their colours from the MilkDrop
+ picture 3.1.5. [→ Lighting](#rgb-lighting-dynamic-lighting-openrgb-and-art-net)
+- **For creators.** Frame-exact **offline video export** from an audio file, one-key recording,
+ music-video layouts, a **Now Playing** overlay with album art, and synced **lyrics** (LRC / SRT).
+ [→ Export](#recording-and-video-export)
+- **AI-ready.** A local **MCP server** with 96 tools lets Claude, Codex, Cursor and other agents
+ read the show, build scenes and run the outputs — behind five permission levels, on `127.0.0.1`
+ only 3.1.5. [→ MCP](#mcp--control-from-an-ai-agent)
+- **Private and offline.** No account, no telemetry, no cloud. The only call the application
+ makes on its own is GitHub's latest-release check, and you can switch it off.
+ [→ Privacy](#privacy-and-security)
+
+---
+
+## Gallery
-> Every image and clip on this page is generated by `npm start -- --shots`, driven by a synthetic
-> 120 BPM signal. With real audio they follow the music instead.
+### Classic looks
+
+The spectrum bars, waves and rings the application started with — still one click away, on
+fluid gradient backgrounds that move with the music.
+
+
+
+| Layered scene | Frequency bars | Circular |
+|:---:|:---:|:---:|
+|  |  |  |
+| **Mirrored bars** | **Wave** | **Sunset wave** |
+|  |  |  |
+
+
+
+> Every scene image and clip on this page is rendered by the application itself with
+> `npm start -- --shots`, driven by a synthetic 120 BPM signal. With real audio the visuals follow
+> the music instead.
---
-## Music video layouts
+## Quick start
+
+### Download
+
+Get the latest build from **[Releases](https://github.com/CaYatur/SoundVisualizer/releases/latest)**.
+
+| Platform | File | Notes |
+|---|---|---|
+| **Windows 10 / 11** | `…-windows-setup.exe` | Recommended. Registers the Dynamic Lighting identity so lights keep running in the background, and can update itself. |
+| Windows, portable | `…-windows-portable.exe` | No installation. Dynamic Lighting works only while the app is focused. |
+| **macOS** (Apple Silicon) | `…-macos-arm64.dmg` / `.zip` | Unsigned — see [macOS first launch](#macos-first-launch). System audio needs a virtual device such as BlackHole. |
+| **Linux** (x64) | `…-linux-x86_64.AppImage` / `…-linux-amd64.deb` | Needs PulseAudio or PipeWire. The AppImage can update itself 3.1.5. |
-Restrained layouts for release videos and official channels — deliberately separate from the club
-and VJ material.
+Nothing else needs to be installed: the audio helper runs on the application's own binary.
+
+### First run
+
+1. Pick one or **several** displays from the **Displays** menu at the top, then one or more
+ **audio sources** under **Audio**.
+2. Click **Open Visualizer**. The visual opens full-screen on every selected display.
+3. Change anything on the right — it applies immediately and saves itself.
+4. Or start from a finished look: **Library → Templates** has 81 of them.
+5. For streaming, turn on **Output → Streaming Output** and paste the address into an OBS
+ **Browser Source**.
+6. Press **ESC** on any visualization window to close them all.
+
+### Run from source
+
+You need **[Node.js](https://nodejs.org/) 20 or newer** (CI tests 20 and 22) and Git.
+
+```bash
+git clone https://github.com/CaYatur/SoundVisualizer.git
+cd SoundVisualizer
+npm install
+npm start
+```
+
+`npm install` rebuilds the native `audify` audio module for Electron automatically (`postinstall`).
+If the audio helper reports `INVALID_HELPER_OUTPUT`, run `npm run rebuild:audio`, then
+`npm run check:runtime`. Behind a corporate proxy that breaks certificates, set
+`NODE_OPTIONS=--use-system-ca` before `npm install`. Developer mode with DevTools: `npm run dev`.
+
+---
+
+## Who it is for
+
+| You are… | What you get |
+|---|---|
+| **A streamer** | A transparent overlay for OBS as a browser source, a Now Playing card with album art, lyrics, and a phone remote to change scenes mid-stream. Runs on one PC while OBS runs on another. |
+| **A VJ or live performer** | A timeline, a clip deck with beat-quantised launching, Auto VJ on the bar, MIDI and OSC control, blackout, Spout/Syphon into Resolume or TouchDesigner, and full-screen output on every projector. |
+| **A music producer or label** | Frame-exact video export from your track, eight restrained music-video layouts with your logo and the track title, and a recorder for the live output. |
+| **A venue, event or installation** | Projection mapping, edge blending, aspect correction for LED walls, accidental-close protection, crash recovery, and a display that never goes to sleep mid-show. |
+| **An RGB or ambient lighting fan** | Windows Dynamic Lighting, OpenRGB and Art-Net/DMX driven by the music, with a screen-saver-style template group for background visuals. |
+| **A MilkDrop fan** | A MilkDrop engine that loads `.milk` and `.milk2`, imports whole libraries, shows thumbnails, keeps favourites, ratings and tags, and lets you edit or generate presets. |
+| **A developer or AI tinkerer** | A GLSL editor with Shadertoy and ISF import, an MCP server with 96 tools, a documented config, and 2,700+ tests that check answers rather than lines. |
+
+---
+
+## Features in detail
+
+The sections above are the short version. Everything below is the full list, by category.
+
+- [Audio capture and analysis](#audio-capture-and-analysis)
+- [Visualizer modes and backgrounds](#visualizer-modes-and-backgrounds)
+- [MilkDrop](#milkdrop)
+- [Layers, masks and effects](#layers-masks-and-effects)
+- [Modulation](#modulation)
+- [3D geometry and formulas](#3d-geometry-and-formulas)
+- [Studio — write your own shader](#studio--write-your-own-shader)
+- [Scenes, templates, transitions and colour](#scenes-templates-transitions-and-colour)
+- [Text, lyrics and Now Playing](#text-lyrics-and-now-playing)
+- [Logo, images and the media layer](#logo-images-and-the-media-layer)
+- [Show control: timeline, clip deck, Auto VJ, MIDI and OSC](#show-control-timeline-clip-deck-auto-vj-midi-and-osc)
+- [Outputs: screens, OBS, Spout and Syphon](#outputs-screens-obs-spout-and-syphon)
+- [Stage: projection mapping and aspect correction](#stage-projection-mapping-and-aspect-correction)
+- [RGB lighting: Dynamic Lighting, OpenRGB and Art-Net](#rgb-lighting-dynamic-lighting-openrgb-and-art-net)
+- [Recording and video export](#recording-and-video-export)
+- [MCP — control from an AI agent](#mcp--control-from-an-ai-agent)
+- [The control panel](#the-control-panel)
+- [Reliability, power and updates](#reliability-power-and-updates)
+- [Privacy and security](#privacy-and-security)
+
+---
+
+### Audio capture and analysis
-- **Eight ready layouts** — Label Card, Artwork Card, Baseline Bars, Amber Room, Minimal White,
- Quiet Frame, Corner Meter, Centre Strip.
-- **Bar placement** — width, horizontal position, height and baseline, each as a fraction of the
- frame. Put the block in a corner, across the centre, or as a thin strip.
-- **Logo beside the bars**, not behind them, with the track and artist beside it.
-- **Track details** come from the now-playing fields; title and artist can be drawn as separate
- layers at their own size and weight.
-- **A still image or a calm video** behind, with the whole palette system available.
+**Sources**
+
+- **System output** — speaker or headphone loopback. No "Stereo Mix" needed.
+- **Microphones and line inputs**, captured the same way.
+- **Single applications** (Windows) — WASAPI process loopback. Capture only the chosen apps, or
+ everything *except* one. Targets are stored by executable name, so a restarted app reattaches by
+ itself, and an app that is not running yet is picked up when it starts. Needs Windows build
+ 20348 or newer. macOS and Linux report why it is not available there yet.
+- **Several sources at once**, mixed before analysis — "Spotify + microphone" is one selection.
+- **Both channels reach the visuals** 3.1.5. Each frame carries the left and right
+ channels next to the mono mix, so stereo width, correlation and the Goniometer measure the real
+ stereo image. Until v3.1.5 the capture helper averaged the two channels away: width sat at 0,
+ correlation at 1, and the Goniometer drew a vertical line for every song.
+- **Recovers by itself** 3.1.5. If the capture helper exits or its frames stop (sleep and
+ resume, a device unplugged), capture is rebuilt with a growing back-off, and the panel says
+ "reconnecting" instead of pretending to capture. A device that drops in and out is not retried in
+ a tight loop.
+- **Sensitivity, smoothing and bass emphasis**, a mains-hum guard for 50/60 Hz, and live meters for
+ overall, bass, mid and treble.
+
+**How capture works.** Capture runs in the **main process**, not in the browser window. A helper
+reads the device — WASAPI loopback on Windows, CoreAudio on macOS, PulseAudio or PipeWire on Linux
+— computes the FFT, and sends frames to every renderer.
+
+- On **macOS**, system audio needs a virtual device such as **BlackHole**; microphones work
+ directly. macOS has no loopback of its own, so there is no way around this.
+- On **Linux**, system audio is the PulseAudio or PipeWire **monitor** of your output device. It is
+ an *input* device; the application marks it as loopback and prefers it by default.
+
+**Spectrum metering.** Bars are measured, not guessed.
+
+- **Frequency scale** — logarithmic, linear, mel or bark.
+- **Amplitude scale** — linear or decibel, with a settable floor from −24 to −96 dB. dB is what
+ makes quiet detail visible instead of flattened against the baseline.
+- **Ballistics** — separate attack and release, so bars snap up and fall smoothly. Frame-rate
+ independent.
+- **Neighbour spread** (widens peaks without flattening them) and **profile smoothing** (a symmetric
+ neighbour average).
+- **Spectral tilt** in dB per octave, neutral at 1 kHz, so the top end is not permanently dead.
+- Bands narrower than one FFT bin are interpolated at the band's centre frequency, so neighbouring
+ bars read their own values instead of sharing one bin. 27 tests cover the engine, including one
+ that asserts the bar profile has no step in it.
+
+**Deep analysis.** Every measurement has a live meter and is available as a modulation source.
+
+- **Musical key and chord** from a constant-Q chroma vector — a Goertzel filterbank rather than FFT
+ bins, because at 2048 samples the bass register is not resolvable by bins — with
+ Krumhansl-Schmuckler key profiles and chord templates.
+- **Pitch tracking** with YIN.
+- **Harmonic / percussive separation**, and per-band onset detectors for kick, snare and hat.
+- **Spectral descriptors** — centroid, rolloff, flatness, crest.
+- **Loudness, dynamics, true peak, stereo width, correlation and mid/side bands.**
+- Silence detection, auto-gain, and a rolling spectral history buffer.
+
+**Tempo.** BPM is estimated from a period histogram (tested to ±0.5 BPM against 90, 120, 128, 140
+and 174 BPM signals), with tap tempo and a BPM lock shared by Auto VJ, the clip deck and MilkDrop.
---
-## Spectrum metering
+### Visualizer modes and backgrounds
+
+
+
+**All 60 visualizer modes**
+
+
-Bars are measured, not guessed. Four frequency scales, a decibel amplitude scale, and real
-ballistics.
+**All 43 backgrounds**
-- **Frequency scale** — logarithmic, linear, mel, or bark.
-- **Amplitude scale** — linear or decibel, with a settable floor. dB is what makes quiet detail
- visible instead of flattened against the baseline.
-- **Ballistics** — separate attack and release, so bars snap up and fall smoothly rather than
- following one constant in both directions. Frame-rate independent.
-- **Neighbour spread** — widens peaks without flattening them.
-- **Profile smoothing** — a symmetric neighbour average for a softer envelope.
-- **Spectral tilt** — dB per octave, so the top end is not permanently dead.
+
+
+
-Bands narrower than one FFT bin are interpolated at the band's centre frequency, so neighbouring
-bars read their own values instead of sharing one bin. 27 tests cover the engine, including one
-that asserts the bar profile has no step in it.
+These two sheets are generated from the mode catalogue itself, so a new mode appears in them the
+next time the screenshots are rendered. Any visualizer can sit on any background, and with layers
+you can stack as many of each as you like. Modes added since v3.1.4 are part of 3.1.5.
+
+**Visualizer modes — 60**
+
+- **Basic** — Bars · Center · Blocks (LED equaliser) · Dot Matrix · City Skyline (buildings with lit
+ windows)
+- **Waveform** — Wave (oscilloscope) · Ribbon (waveform history) · 3D Wave (history stacked in
+ perspective) · Lissajous (XY oscilloscope) · Strings (each string vibrates with its band) · Terrain
+ (perspective wireframe landscape) · Ridgelines · DJ Waveform
+- **Radial** — Circle · Radial Wave · Starburst · Arcs (one arc per band) · Pinwheel · Mandala (polar
+ rose curve) · Kaleidoscope · Vortex · Helix · Tunnel · Orb · Radar Chart
+- **Particles and events** — Particle · Fireworks (bursts on the beat) · Lightning (branching bolts
+ on bass) · Bubbles · Liquid Drop (metaballs) · Ripple Grid (rings spreading on the beat) ·
+ Spectrogram · Confetti · Beat Pads · Bouncing Balls · Stereo Trails (each band launched from its
+ place in the stereo image)
+- **Generative systems** — Flow Field (particles steered by a noise field) · Flock (boids driven by
+ the spectrum) · Voronoi · Truchet · Moiré · Wave Interference · Ropes (verlet physics kicked by
+ onsets) · Galaxy · DNA Helix · Isometric City · Attractor Field (discrete maps from the formula
+ library with two parameters bound to audio) · Pendulum Wave · Cardioid
+- **Text** — Text / Lyrics · Now Playing
+- **Metering** — Oscilloscope (XY) · Goniometer (stereo phase scope) · Chroma Wheel (pitch classes in
+ circle-of-fifths order, highlighting the detected chord root) · VU Meter · Level Meter (PPM)
+- **Advanced engines** — 3D Geometry · MilkDrop · Feedback (the classic infinite-tunnel feedback
+ look) · Studio (your own GLSL shader)
+
+Bar count, minimum and maximum frequency, gap, placement (bottom, centre or full), mirror, line
+width, amplitude, sensitivity and glow appear whenever they mean something for the selected mode.
+Colour comes from the scene palette, a custom colour pair, or **rainbow**.
+
+**Backgrounds — 43**
+
+- **Fluid** — Fluid Gradient (an audio-reactive mesh gradient with flow, wander, orbit, swirl, warp,
+ grain and audio hue shift) · Ink (liquid blobs that swirl as they flow) · Nebula (soft gas clouds)
+ · Wave Layers (crests that swell with the audio) · Northern Lights (undulating curtains) · Lava
+ Lamp · Underwater
+- **Geometric** — Retro Grid (a perspective grid to the horizon) · Honeycomb Grid (cells lit by a
+ wave from the centre and by the spectrum) · Mosaic (a cell per frequency band) · Corridor (rings
+ or polygons coming toward you) · Spiral · Pulse Rings (extra rings on bass hits) · Network
+ (drifting linked nodes) · Low Poly · Halftone · Isometric Cubes
+- **Atmosphere** — Starfield · Snow / Embers · Light Particles (bokeh) · Digital Rain · City (a
+ parallax skyline whose windows light up with the music) · Clouds · Stage Lights · Fireflies ·
+ Storm
+- **Generative grounds** — Liquid Metal · Plasma · Caustics · Ribbons · Contours · Wave Field ·
+ Embers · Sand · Stained Glass · Circuit Board · Prism · Globe Mesh · Wire Tunnel · Hex Pulse ·
+ Mirror Pattern
+- **Other** — Solid Colour · Studio (a GLSL shader you wrote yourself)
+
+**Transparent background.** Turn on **Background → Transparent Background** and the desktop shows
+through the visualizer window: a solid colour is not painted, and a background effect's dark parts
+turn transparent below a **Transparency Threshold**. Transparency survives the effect chain, so
+bloom and blur glow over empty pixels without turning the window into a black rectangle.
---
-## The control panel
+### MilkDrop
-- **Seven categories** — Scene, Audio, Lighting, Output, Control, Studio, Library.
-- **Live everywhere** — every change reaches the output windows immediately and saves itself.
-- **Modified badges** on each card and category, with a reset for the section or the whole
- category.
-- **Search** across every setting in every category.
-- **Turkish and English**, switchable at runtime; the self-test fails if any interface string is
- left untranslated.
+A MilkDrop engine written for this application — it does not embed projectM or MilkDrop's code.
+The preset language runs for real: a tokeniser, a parser and compilation to JavaScript closures;
+`per_frame` and `per_pixel` equations drive a warp mesh with feedback; the HLSL warp and composite
+shaders are translated to GLSL and run on the GPU.
+
+- **Measured, not claimed.** Over a 10,347-preset corpus from the projectM original and
+ cream-of-the-crop packs, every preset loads and runs, all 16,346 shader stages compile, and about
+ 98% produce a live image. Fidelity is checked frame by frame against a reference renderer built
+ from BeatDrop's MilkDrop 2 sources. Both harnesses are in `scripts/`, so the numbers can be reproduced.
+- **A MilkDrop Fidelity switch** follows MilkDrop 2's own rules — its compiler, its audio chain, its
+ mesh transform, its default values and its fixed-function pipeline. The details are in
+ [MilkDrop engine notes](#milkdrop-engine-notes) at the end of this page.
+- **Five presets of our own ship with the app** — *Aurora*, *Molten Gold*, *Still Rings*, *Endless
+ Tunnel* and *Pulse Weave* — so the engine shows what it does before you import anything. No
+ third-party preset pack is bundled.
+- **Import a whole library** 3.1.5 — from a ZIP pack, a folder, or by searching this
+ computer (Winamp, foobar2000 and projectM folders, Downloads, Desktop, Music, Documents). You see
+ what will be added before anything is copied; duplicates are skipped; textures come along; folder
+ names can become tags. A 9,795-preset folder imports in about six seconds.
+- **`.milk` and `.milk2`** 3.1.5 — MilkDrop 3's double presets load as a frozen blend of
+ their two presets, and a *Preset Format* setting reads files with MilkDrop 2 or MilkDrop 3 rules
+ (16 custom waves and shapes, `q1`–`q64`), or picks automatically.
+- **Thumbnails** 3.1.5 — a *Grid* layout shows each preset as a small picture, drawn once
+ in the background and redrawn only when the preset or a texture it uses changes.
+- **Favourites, tags, ratings and search by author** 3.1.5 — `author:geiss` finds Geiss's
+ presets, `#calm` finds a tag; random order is weighted by rating as MilkDrop weights it; Previous
+ and Next walk a 64-step history of what was actually shown.
+- **A live editor** 3.1.5 — frame and pixel equations, waves, shapes, warp and composite
+ shaders each have a tab; a change shows in the running picture a moment after you stop typing;
+ errors point at the preset's own line. The original is never changed.
+- **A preset generator and mash-ups** 3.1.5 — write an original preset from four sliders
+ (energy, warmth, density, motion) and a seed that brings the same preset back, or build one from
+ parts of the presets you already have. Generated presets never flash.
+- **Show control** 3.1.5 — auto advance by seconds or **on the bar**, hard cuts on loud
+ moments, *next preset on track change*, a lock, and MilkDrop actions on MIDI and OSC. Every screen
+ shows the same preset with the same random seed.
+- **User textures and sprites** 3.1.5 — point at a MilkDrop `textures` folder, and launch
+ `milk_img.ini` sprites with MilkDrop's own keys or from a controller.
+- **Safe to watch** 3.1.5 — flash limiting at WCAG 2.3.1's general-flash value, held per
+ second so a 144 Hz screen is as safe as a 30 fps one, and the system's *reduce motion* setting
+ is honoured.
+- **Survives a GPU reset** 3.1.5 — a lost WebGL context is rebuilt on the same canvas,
+ and the running preset carries on with the same equation state and clock.
+
+The **Feedback** engine is MilkDrop's family resemblance without presets: zoom, rotate, warp and
+decay sliders, four wave styles, and bass-driven zoom and rotation for the classic infinite tunnel.
---
-## Layers and effects
+### Layers, masks and effects
-- **Unlimited layers**, each with its own source, blend mode, opacity, transform and audio
- response. The layer at the top of the list is the topmost one in the output.
-- **17 blend modes**, groups with a single fader, solo, mute and lock.
-- **Masks** — alpha from another layer, plus shape and gradient masks.
-- **40 GPU effects**, orderable, audio-bindable, and available per layer as well as on the
- composite. An effect on a single layer keeps that layer's transparency, so the layers below stay
- visible; a bloom's glow that spreads into empty space still shows over them.
-- **A/B crossfader** between layer groups, on an equal-power curve.
-- **The whole stack switches off**, returning the scene to the plain Background plus Visualizer
- setup without losing the layer list.
+- **Unlimited layers**, each with its own source, blend mode, opacity, transform (scale, rotate,
+ X/Y, flip) and audio response (band, opacity, scale, rotate). The layer at the top of the list is
+ the topmost one in the output.
+- **17 blend modes** — Normal, Add, Screen, Multiply, Overlay, Darken, Lighten, Colour Dodge, Colour
+ Burn, Hard Light, Soft Light, Difference, Exclusion, Hue, Saturation, Colour, Luminosity.
+- **Masks** — alpha from another layer, plus rectangle, ellipse, linear and radial gradients, with
+ position, size, angle, feather and invert.
+- **Groups** with a single fader, and an **A/B crossfader** on an equal-power curve.
+- **Solo, mute and lock** — solo isolates a layer reversibly, mute hides one without losing its
+ settings, lock prevents accidental edits.
+- Copy, paste and duplicate layers across scenes. The whole stack can be switched off, returning
+ to the plain Background plus Visualizer setup without losing the list.
+- **One broken layer no longer takes the frame with it** 3.1.5, and layers hidden under
+ an opaque MilkDrop layer are not drawn at all.
+
+**Post-processing — 40 GPU effects**, orderable, each with its own opacity, toggleable, and
+available per layer as well as on the composite. An effect on a single layer keeps that layer's
+transparency, so the layers below stay visible.
+
+- **Composition** — Bloom · Vignette · Trails / Echo · Edge Highlight · Colour Grade
+- **Blur and focus** — Gaussian Blur · Radial Blur · Directional Blur · Zoom Blur · Tilt-Shift ·
+ Depth of Field (Bokeh) · Sharpen · Emboss
+- **Halftone and pattern** — Dither (Bayer) · Halftone · ASCII Mosaic · Cross-Hatch (Pen) · Oil Paint
+ (Kuwahara) · Pixelate · Posterize / Invert · Threshold · Solarize
+- **Analogue and damage** — Film Grain · CRT / Scanlines · VHS / Analogue Tape · Glitch (Slice Shift)
+ · Datamosh (Block Shift) · Bad Signal · Chromatic Aberration
+- **Distortion** — Lens Distortion · Twirl · Polar Transform · Ripple Distortion · Slit-Scan ·
+ Kaleidoscope · Mirror
+- **Colour and light** — Gradient Map · Levels & Curve · God Rays · Star Filter
+
+Any parameter of any effect can be driven by the modulation matrix.
---
-## Modulation
+### Modulation
-- **Any source to any setting** — LFOs, envelope followers, sample-and-hold and random, routed to
- any value in the configuration.
-- **Eight LFO shapes**, rate in Hz or in beat divisions locked to the detected tempo.
-- **Curve shaping** — exponent, S-curve, quantise, invert — plus per-route smoothing and slew
- limiting.
-- **Eight macro knobs**, assignable and exposed to MIDI and the remote.
-- **Deterministic under offline export**: LFO phase comes from the draw clock, so skipping frames
- cannot shift it.
+- **Any source to any setting** — routes go to any dotted configuration path, chosen from a live
+ tree of the current settings.
+- **Sources** — bass, mid, treble, level, onset envelope and onset trigger · eight spectrum bands ·
+ LFOs · envelope followers · sample-and-hold · random · the beat clock · macro knobs · and every
+ deep-analysis measurement (key, chord, pitch, loudness, drum bands…).
+- **Eight LFO shapes** — sine, triangle, saw up, saw down, square, pulse, random ramp and noise —
+ with rate in Hz or in beat divisions (1/16 up to 8 bars) locked to the detected tempo, plus phase
+ offset and pulse width.
+- **Per-route shaping** — minimum, maximum, amount, set or add, a curve (linear, exponent, S-curve,
+ quantise, invert), smoothing and slew limiting.
+- **Eight macro knobs**, exposed to MIDI learn.
+- Values are applied copy-on-write, so modulation never alters your saved settings, and LFO phase
+ comes from the draw clock, so offline export is frame-exact.
---
-## Deep audio analysis
+### 3D geometry and formulas
-- **Musical key and chord** from a constant-Q chroma vector — a Goertzel filterbank rather than FFT
- bins, because at 2048 samples the bass register is not resolvable by bins.
-- **Pitch tracking** with YIN.
-- **Harmonic / percussive separation**, and per-band onset detectors for kick, snare and hat.
-- **Spectral descriptors** — centroid, rolloff, flatness, crest.
-- **Loudness, dynamics, true peak, stereo width and correlation.**
-- Every measurement is available as a modulation source.
+- **Plane curves (30)** — rose curves, lemniscates, cardioids, epicycloids, hypocycloids, spirals,
+ roulettes, Lissajous figures, butterfly and superformula curves among them.
+- **Space curves (12)** — trefoil and torus knots, Viviani's curve, helices, conical spirals and
+ similar.
+- **Surfaces (29)** — torus, Klein bottle, Möbius strip, Boy's surface, Dini's surface, breather,
+ superellipsoid, Gielis supershapes, Chladni figures, trefoil tube and more.
+- **Strange attractors (27)** — Lorenz, Rössler, Chen, Halvorsen, Thomas, Aizawa, Chua, Dadras,
+ Sprott, Clifford, de Jong, Hénon and others, continuous and discrete.
+- **Solids (13)** — tetrahedron, cube, octahedron, dodecahedron, icosahedron, a geodesic sphere with
+ subdivision control, four L-systems (tree, fern, dragon curve, 3D Hilbert curve) and three iterated
+ function systems (Barnsley fern, Sierpinski tetrahedron, spiral).
+- Render as wireframe, points or shaded, with resolution, deformation, spin, colour mode and audio
+ binding on every parameter.
+- **Own matrix maths** — no third-party 3D library. **Framing is measured, not declared**: the first
+ iterations of an attractor are probed for their bounding box, and a test asserts every system
+ lands inside the view volume.
---
-## 3D geometry and formulas
+### Studio — write your own shader
+**Scenes** store the whole look — background, visualizer, layers, effects, logo, text, modulation,
+MilkDrop and visual objects — under a name. Restore with one click, update from the current look,
+export and import as JSON.
+
+**81 templates in ten groups.** One click, and your audio device, display selection, streaming
+and lighting settings are left alone — trying a template must not damage a working setup, and a
+test asserts it.
+
+- *Club (8)* — Strobe Wall, Hyper Tunnel, Laser Grid, Mandala Drop, Strobe Floor, Fireworks,
+ MilkDrop Flow, Strange Attractor
+- *Ambient (9)* — Aurora, Ink in Water, Topography, Underwater, Embers, Liquid Metal, Night Globe,
+ Flow Field, Interference
+- *Streaming (6)* — Corner Bars, Clean Wave, Ring Meter, Scope Overlay, Lower Third, Studio Meters
+- *Music Video (11)* — Label Card, Artwork Card, Baseline Bars, Amber Room, Minimal White, Quiet
+ Frame, Corner Meter, Centre Strip, Wave Card, Cover Ring, Stage Card. The cover, title and artist
+ come from one Now Playing layer, so the cover sits beside the text at the same gap in every
+ aspect ratio; in the admin preview the card shows placeholder text until a track plays.
+- *Music Backdrop (6)* — Aurora Backdrop, Flow Backdrop, Nebula Backdrop, MilkDrop Backdrop, Galaxy
+ Backdrop, Soft Glow: a plain, dimmed visualizer behind the track card while music plays
+- *Music (6)* — Chroma Wheel, Helix, Silk Ribbons, Strings, Spectrogram, Galaxy
+- *Screensaver (6)* — Plasma, Stained Glass, Circuit, Wire Tunnel, Dunes, Prism
+- *3D Geometry (8)* — Klein Bottle, Lorenz, Supershape, Trefoil Tube, Chladni, Rose Curve, Chua
+ Circuit, Möbius
+- *Genre (16)* — Techno, House, Drum & Bass, Hip-Hop, Lo-Fi, Synthwave, Rock, Metal, Jazz,
+ Classical, Ambient, Pop, Trance, Dubstep, Chiptune, Experimental
+- *Event (5)* — Minimal Line, Corporate, Gala, Festival, Projection Test
+
+**Music video layouts.** Restrained layouts for release videos and official channels, deliberately
+separate from the club material: bar placement as a fraction of the frame, a plain ground with no
+grain, and the cover, title and artist as one card. The cover sits beside the text at the same gap
+in every aspect ratio, and the bars share the card's margin.
+
+
+**Scene Generator.** Builds a scene from a description. It is **not** a neural network and is not
+presented as one: it reduces the text to four axes with a weighted keyword dictionary and seeds a
+deterministic generator from them. It runs entirely offline.
+
+**18 scene transitions** — Cut · Crossfade · Dissolve · Wipe · Radial · Clock · Barn · Blinds ·
+Stripes · Checker · Iris · Luma (keyed on the outgoing frame's own luminance) · Zoom · Push · Slide ·
+Flash · Glitch · Blur. Six easing curves, a duration in seconds or in beats, and a switch to turn
+them off. They fire on a change of *scene*, never on a slider, so dragging a control never starts
+one.
+
+**Colour.** Five colour stops, **58 built-in palettes** in seven groups (Classics, Warm, Cool, Neon &
+Cyber, Dark, Light, Monochrome Families) and your own saved palettes apply to every background, to
+Studio and to the 3D engine. Every visualizer can follow the palette (*theme* colour mode).
+
+**Dynamic colour theme (Windows).** The palette can follow the playing track: colours extracted
+from the album cover, a harmony style (analogous, complementary, triadic, cyberpunk, synthwave,
+aurora…), the mood of the title, or a cycle through presets — applied to the background, the
+visualizer, or both.
+
+---
+
+### Text, lyrics and Now Playing
+
+
+
+| Now Playing | Text |
+|:---:|:---:|
+|  |  |
+
+
+
+**Now Playing.** On Windows the application reads the system media session (SMTC), so the track
+from Spotify, YouTube Music, a browser or most players appears on screen by itself: title, artist,
+album, elapsed and remaining time, a progress bar and the album cover. It can stay on screen or
+appear only when the track changes, with seven animations and *Modern* and *OG* styles. On macOS
+and Linux the title, artist and cover are entered by hand. Now Playing also shows in the panel
+preview and in exported videos 3.1.5.
+
+**Text.** Audio-reactive typography with per-character response (scale, jitter, lift) · font,
+weight, size, alignment, position, opacity, outline and shadow · animation presets · marquee and
+ticker · karaoke highlighting.
+
+**Lyrics.**
+
+- **LRC and SRT import**, the format detected from the content, enhanced LRC word timings supported.
+- **A timing editor** with a sync offset that writes back to LRC.
+- **Play, pause and stop** for a loaded lyrics file while the screens are open; all screens and the
+ OBS overlay share one clock, corrected to the machine running the app.
+- **Lyrics library (Windows)** 3.1.5 — keep many LRC or SRT files, each with an artist and
+ a title. **Follow the Playing Track** finds the right file for the song from the system media
+ session and moves with seek and pause. **Exact Match** or **Partial Match** for small spelling
+ differences; timed lyrics from the player are used when the library has no match. Files open in a
+ tall editor with colouring for timestamps, word times and tags; removing one asks first. Nothing
+ is fetched from the network.
+
+---
+
+### Logo, images and the media layer
+
+- **Logo** — an image placed anywhere in the frame, automatically sized, with size, opacity, glow,
+ position and audio pulse; animated GIFs play. The logo can also show the **album cover of the
+ playing track**. Applying a template keeps your logo and only changes its placement.
+- **Logo and video libraries** 3.1.5 — imported files are copied into the app's own
+ folder and referenced by id, so the settings file stays small and a moved original does not break
+ a scene.
+- **Visual objects** — image sprites in front of or behind the visualizer, with count, size, drift,
+ rotation and audio response.
+- **Media layer** — a webcam or a video file, in front of or behind the visualizer, with fit (cover,
+ contain, stretch), mirror, kaleidoscope with 3–12 slices, hue shift, saturation, blend mode,
+ opacity, and audio-driven zoom and opacity. The same frame is readable inside Studio shaders as
+ `sv_media`.
+- **Smooth on every output** 3.1.5 — videos are decoded on the CPU by default, so they
+ play at full frame rate in full-screen windows and in the Spout/Syphon feed. With hardware
+ decoding, Chromium produced almost no frames there (0.3 per second, measured) and the clip froze
+ at its loop point. HEVC/H.265 videos need **Settings → Application → Hardware Video Decoding**
+ (applies after a restart); the panel says so when such a file will not open.
+
+---
+
+### Show control: timeline, clip deck, Auto VJ, MIDI and OSC
+
+
+
+**Timeline.** Lay scenes and setting changes out along time, aligned to the bar or to the second;
+one playhead drives every screen together, and offline export plays the same show.
+
+- Clip tracks for scenes, templates, palettes, video, images, shaders and actions; **automation
+ lanes** for any setting, with curves; markers and a loop.
+- **A full editor** 3.1.5, modelled on Ableton's Arrangement View: a toolbar with
+ transport, clock (time and bar.beat), tempo, snap, loop, follow and zoom; track headers with
+ colour, mute, solo and lock; split at the playhead, duplicate, copy and paste, nudge, 100-step
+ undo; multi-select with box selection; a draggable loop brace and marker flags; per-clip
+ transition handles; **tempo changes on the ruler**; adjustable lane height and a full-window mode;
+ and keyboard shortcuts that only act while the editor has focus.
+
+**Clip Deck.** Place scenes, templates, palettes and media on a grid and fire them on the beat.
+
+- **Beat-quantised launching** with a global quantise setting, **follow actions** (next, random,
+ go-to, loop, stop) and durations.
+- **Launch modes** 3.1.5 — trigger, toggle and **gate** (plays while held).
+- **Several decks** with tabs, named rows and columns, colours, progress bars, a blinking countdown
+ on queued cells, drag-and-drop to move or copy, and a **Performance View** for a second screen.
+- **Keyboard play** 3.1.5 — 1-9 or arrows pick the row, A-P fires a slot, Enter launches
+ the row.
+- **Media and action slots** 3.1.5 — video, image and shader slots apply to a chosen layer;
+ action slots run the same actions as MIDI and OSC mappings.
+- Fired slots can be **recorded to the timeline**, so an improvised set becomes an editable show.
+
+**Tempo and Auto VJ.** The track's tempo is detected and **Auto VJ** changes scenes, visualizer
+modes or colours by itself, aligned to the bar. Pick exactly which scenes, modes or palettes cycle
+(or leave it empty for all), give each visualizer layer its own mode, and read a status line that
+says what changed, what comes next, and why nothing can happen when a source is empty.
+
+**MIDI.** Learn a control, then map any CC or note to any setting or action — including MilkDrop's
+next, previous, random, cut, lock and rating.
+
+**OSC.** A UDP listener with a hand-written OSC 1.0 parser, for TouchOSC, Resolume, Ableton or QLab.
+
+
+
+
+
+
+
+**Phone remote.** A phone-sized page for scenes, colour palettes, Studio presets, visualizer and
+background modes, audio sensitivity, blackout and the now-playing card, served by the same server
+as the OBS overlay. Values sent from the phone are
+range-checked before they are applied 3.1.5.
+
+**Blackout** on Space or from any controller, with its own transition, leaving the stored
+scene untouched.
+
+---
+
+### Outputs: screens, OBS, Spout and Syphon
+
+
+
+
+
+
+
+**Multi-monitor.** A separate full-screen window on every display you select. The chosen displays
+are remembered by position and size, so a monitor that Windows renumbers after reconnecting is
+found again 3.1.5.
+
+**Floating window** 3.1.5. A picture-in-picture window with opacity, a 16:9 aspect lock,
+a position lock and **click-through**, for keeping the visuals over your desktop while you work.
+
+**Streaming output — OBS and the browser.** Turn on **Output → Streaming Output** and the
+application serves an overlay page.
+
+- Add it to OBS as a **Browser Source**. No plugin, and real transparency.
+- The overlay runs the **same engine** as the desktop window, so what you see is what streams —
+ MilkDrop presets and their textures included.
+- Works across the network, so the visualizer can run on one machine and OBS on another.
+- **Transparency is the app's own switch**; add `?transparent=0` or `?transparent=1` to one source's
+ address to force it either way.
+- **Lyrics follow the app**, and the browser corrects its clock to the machine running the app.
+- **A diagnostics card** 3.1.5 — add `?debug=1` to the address to see the connection,
+ configuration, audio frame rate, canvas size, transparency, app version and last error.
+- Access is protected by tokens; the overlay and the phone remote have separate ones.
+
+**GPU output — Spout and Syphon.** The picture can be handed to another application on the same
+machine over the GPU: no window capture, no CPU copy.
+
+- **Spout** on Windows, **Syphon** on macOS. Receivers include Resolume, OBS, TouchDesigner and
+ MadMapper — anything that speaks either protocol.
+- Pick the **source name**, resolution and frame rate.
+- It renders in its own hidden window, so the feed keeps running even when no visualization window
+ is open.
+- Spout and Syphon stay opaque: a shared GPU texture cannot carry alpha without dropping the sender.
+- **Not available on Linux**, which has no built-in equivalent. The panel says so and points at the
+ OBS browser source, which works everywhere.
+
+---
+
+### Stage: projection mapping and aspect correction
+
+
+
+**Projection mapping**
+
+- **Corner pin** as a true homography, with the denominator written into `gl_Position.w` so the
+ texture stays perspective-correct.
+- **Mesh warp** on a Catmull-Rom grid that passes through its control points.
+- **Soft edge blending** for multi-projector rigs; the curves are tested to sum to exactly 1 across
+ the overlap.
+- **Per-output crop, colour correction and Bézier polygon masks**, plus alignment grids, crosses,
+ colour bars and focus rings, with drag, arrow-key nudge and exact numeric entry.
+
+**Aspect correction.** A display's reported resolution does not always match its physical shape. A
+panel driven at 1920×1080 that is really about 3:1 — a stage LED wall, a bar display, an anamorphic
+projector, a TV forced into a stretched mode — draws every circle as an ellipse.
+
+- **The frame is never stretched.** The scene is drawn on a square-pixel canvas matching the panel's
+ real shape and squeezed linearly into the framebuffer, where the panel's own distortion undoes
+ the squeeze. Nothing is cropped and nothing is pushed off the edge.
+- **One setting corrects everything** — background, visualizer, logo, text and sprites together.
+- **Calibrated by eye** with a circle, square or grid, or from the panel size, the true aspect ratio
+ or the dimensions of an already-stretched image.
+- **Per screen or all screens**, composes with projection mapping without moving an existing corner
+ calibration, and leaves exported video, the stream and the web overlay alone.
+
+---
+
+### RGB lighting: Dynamic Lighting, OpenRGB and Art-Net
+
+**Windows Dynamic Lighting**
+
+- Off by default, and available only when compatible devices are detected.
+- Dynamic modes: visualizer colour flow, bar-spectrum mapping, bass/mid/treble zones,
+ background-light sync, synchronised beat flashes, frequency ripples, bar and background fusion,
+ cross-device colour flow, rainbow flow, and threshold-triggered bursts.
+- Manual modes: one colour, per-device colours, and per-LED or per-zone colours where the hardware
+ exposes them.
+- Brightness, audio reactivity, smoothing, update rate, LED layout, palette source, per-band colours
+ and sensitivity, flash threshold, strength and decay, ripple speed, direction and width, and
+ colour spread are all configurable.
+- The installer registers the Windows background-lighting identity, so lights keep running when the
+ app is not focused. Place the app near the top of **Dynamic Lighting → Background light control**.
+
+**OpenRGB — RGB everywhere else.** Talks to a running **OpenRGB** server over its own protocol (TCP,
+port 6742 by default) on Windows, macOS and Linux — no vendor software, and the server may sit on
+another machine. Every device OpenRGB exposes, per-LED where the hardware allows, with the **same
+modes and colour maths** as Dynamic Lighting.
+
+**Art-Net / DMX.** ArtDMX output to fixtures and lighting desks; the packet layout is tested byte by
+byte.
+
+**Colour sources.** The lights can follow the background, the theme, or the **live MilkDrop
+picture** 3.1.5 — sampled about 30 times a second into eight slices from left to right, so
+the fixtures on the left take the colours on the left of the screen.
+
+---
+
+### Recording and video export
+
+
+
+
-- **98 formulas** — 30 plane curves, 12 space curves, 29 surfaces, 27 strange attractors.
-- **13 solids** — the five platonic solids, geodesic spheres with subdivision control, four
- L-systems and three iterated function systems.
-- **Own matrix maths.** No third-party 3D library.
-- **Framing is measured, not declared.** The first iterations of an attractor are probed for their
- bounding box, and a test asserts every system lands inside the view volume.
+- **Offline video export (audio file → MP4).** Renders a track frame by frame — not a screen
+ recording — at 720p, 1080p, 1440p or 4K, 30 or 60 fps, with quality, a CPU or GPU encoder, progress,
+ cancellation and a GPU-to-CPU fallback. It is deterministic: the same job gives the same video, the
+ property the visual regression tests rely on. Title, artist, album and cover are read from the
+ file and feed Now Playing and text layers.
+- **Live recording** of the output exactly as it appears — with the live audio, modulation,
+ transitions and effects — to MP4 or WebM, on one key.
+- **GIF export** with two-pass palette generation, because one pass bands visibly.
+- **PNG snapshot** at up to 4×, on a shortcut.
+- **Export presets** for common aspect ratios.
---
-## MilkDrop
+### MCP — control from an AI agent
+
+3.1.5
+
+An agent drives the running application over the **Model Context Protocol**. The switch is on the
+**Control** card and is off by default. The application stays open while the switch is on. The
+setup dialog gives a stdio command for Claude Desktop, Codex, Cursor, Grok and Grok Bot. Ollama is
+a local model behind an MCP client and uses that same command.
+
+> **Needs Node.js.** The stdio command runs `node`, so the computer needs
+> [Node.js](https://nodejs.org/) LTS installed and on `PATH`. The application itself does not need
+> it. Without Node.js the MCP client reports that it cannot start `node`.
+
+The server speaks JSON-RPC `initialize`, `ping`, `tools/list` and `tools/call`. It accepts protocol
+versions `2024-11-05`, `2025-03-26` and `2025-06-18`, and answers `2024-11-05` for any other
+version. The server name is `soundvisualizer`. There are **96 tools**.
+
+The client spawns the stdio bridge. The bridge posts to `http://127.0.0.1:/mcp` with a bearer
+token. The socket binds `127.0.0.1` only. The port is **38471** unless you set another. Port
+**8722** is refused, because that port belongs to the stream. A busy port stays busy: the server
+does not move, and the card reports the failure. Each start writes a new token into
+`mcp-endpoint.json` in the application data folder, next to a copy of the bridge. On Linux and
+macOS those two files are readable by this user only. A connection from anywhere else is refused,
+and so is a missing or wrong token.
+
+`sv_get_config`, the output-status read and `sv_export_json` replace stream tokens with a
+redaction. `sv_set_stream` drops `token` and `remoteToken`.
+
+Every tool lists its parameters in `tools/list`, with types, ranges and allowed values. Values the
+panel cannot produce are refused or pulled into the panel's range: a layer position outside -1..1,
+a colour that is not `#rrggbb`, an unknown effect type, a modulation route to a setting that does
+not exist. `sv_patch_config` writes into a list only at an index that exists (`layers.0.opacity`)
+and does not create new top-level keys. A value must keep the type of the one it replaces, and a
+write under `layers` passes the same checks as `sv_update_layer`. Arguments a tool does not know
+are listed back as `ignored` in its reply.
+
+Five modes stack. The switch turns on in **Read**. A higher mode includes the ones below it. The
+agent cannot raise its own access: `sv_patch_config` refuses any `mcp.*` path. A blocked call names
+the mode it needs and tells the agent to leave the mode alone and leave the panel unclicked.
+`sv_list_permissions` and `mcp_permissions` report the active mode and, when you pass a tool name,
+the minimum that tool needs.
+
+A change the mode allows is saved and pushed the same way a click is. The admin panel, open
+visualizer windows and the stream all receive it. After every call, success or error, the preset
+folder is re-read and open windows receive the delta.
+
+#### Read
+
+The master switch is enough. These calls only read.
+
+- `sv_get_state` returns the show: active preset, scenes, layers, effects that are on, displays,
+ BPM and levels, now playing, the layer stack, stream status, Spout/Syphon status and the live
+ analysis from the panel preview (empty while the preview has no sound).
+- `sv_get_visual_state`, `sv_list_layers`, `sv_get_layer` and `sv_get_layer_stack` return layer
+ position, settings and per-layer effects.
+- `sv_get_preview` adds a JPEG of the picture on screen, at most 480 pixels wide. It uses an open
+ visualizer window, then the floating window, then the preview rectangle in the admin panel.
+- `sv_get_audio` returns level, bass, mid, treble, BPM and confidence from the same meter the panel
+ draws. `sv_get_now_playing` returns the current track. `sv_list_audio_sources` lists the
+ configured inputs.
+- `sv_list_scenes` and `sv_get_scene` read saved scenes. `sv_list_modes` lists every visualizer and
+ background id, layer kind and blend mode; the mode and layer tools reject an id it does not list.
+ `sv_list_effects` lists the global chain,
+ each layer's chain, and the 40 built-in effect types. `sv_list_presets` lists library presets
+ and user colour palettes. `sv_list_displays` lists screens.
+- `sv_get_output_status` reads which visualizer windows are open, the stream switch, port and LAN
+ flag, and the Spout/Syphon name. `sv_get_timeline`, `sv_get_clipdeck` and `sv_get_autovj` read
+ those panels. `sv_get_config` reads the whole configuration or one dotted path.
+
+#### Apply
+
+Uses what is already saved.
+
+- `sv_apply_scene` loads a saved scene by id, or by name when that name is unique. The snapshot
+ covers background, visualizer, layers, groups, crossfade, geometry, effects, logo, images, media,
+ text, modulation, transition, Studio, MilkDrop and feedback. Window transparency and taskbar
+ cover stay as they were.
+- `sv_apply_template` applies a built-in template by id or name. `sv_set_visualizer_type` and
+ `sv_set_background_type` switch to an existing mode id. A Studio shader is shown with type
+ `custom` and its `presetId`. `sv_set_layer_enabled` shows or hides a layer and turns the stack
+ on. `sv_set_crossfade` sets the A/B fader from 0 to 1.
+- `sv_trigger_clip` fires one clip-deck slot by row and column. `sv_stop_clips` stops every playing
+ slot. The grid stays as saved. Both need the admin window open.
+- `sv_set_effect_enabled` and `sv_set_effect_param` change a global effect already on the chain.
+ The layer pair does the same for one layer. `sv_set_modulation_enabled` turns the modulation
+ matrix on or off. `sv_set_macro` sets one existing macro fader.
+- `sv_load_preset` copies an existing library preset into the live MilkDrop source.
+ `sv_apply_color_preset` paints an existing user or built-in palette onto the background gradient.
+ `sv_set_milkdrop_cycle` sets how the library advances: auto next, order, source, tag, unit, bar
+ count, track advance and hard cut.
+
+#### Write
+
+Creates and edits.
+
+- Scenes: `sv_create_scene` stores the current look under a new name, `sv_update_scene` overwrites
+ one, `sv_rename_scene` gives a scene found by id or current name the `newName`,
+ `sv_delete_scene` removes.
+- Layers: `sv_add_layer`, `sv_update_layer`, `sv_set_layer_position`, `sv_set_layer_settings`,
+ `sv_remove_layer`, `sv_reorder_layers`. A layer carries kind, type, preset, opacity, blend,
+ transform (x, y, scale, rotate, flip), audio response, mask, solo, mute, lock and group. Effects
+ on a layer go through the effect tools. Adding or showing a layer turns the stack on.
+- `sv_set_text` edits the text overlay, including a lyrics or now-playing source. `sv_set_logo`,
+ `sv_set_media` and `sv_set_geometry` edit those blocks.
+- Effects: `sv_add_effect` and `sv_remove_effect` on the global chain, `sv_add_layer_effect` and
+ `sv_remove_layer_effect` on one layer. The built-in types are bloom, chroma, glitch, grain, crt,
+ pixelate, kaleido, mirror, grade, vignette, trails, edge, zoomblur, ripple, posterize, blur,
+ radialblur, motionblur, tiltshift, dof, sharpen, emboss, dither, halftone, ascii, hatch, paint,
+ vhs, datamosh, slitscan, lens, twirl, polar, gradientmap, levels, threshold, solarize, godrays,
+ badtv and starfilter. `sv_add_modulation_route` and `sv_remove_modulation_route` edit routes.
+- Presets: `sv_save_preset` writes a file in the preset store. Shader text with no kind is saved as
+ a Studio visualizer (`kind` `visualizer`, `engine` `shader`). Any other save with no kind is
+ MilkDrop. `engine` is `shader` or `variation`; `glsl`, `shadertoy`, `isf` and `frag` are read as
+ `shader`. `sv_delete_preset` removes a file and reports an id that does not exist. `sv_set_milkdrop_source` writes MilkDrop source into
+ the live show. `sv_create_color_preset` saves a user palette of two to five `#rrggbb` colours.
+ Like the panel, it stores five, repeating the last one.
+ `sv_delete_color_preset` removes a user palette.
+- Auto VJ: `sv_set_autovj` sets enabled, source, interval, unit, order, BPM lock, palette source
+ and per-layer visualizer targets.
+- Export and recording: `sv_start_export` renders an audio file that exists on disk to a video path
+ you name. Resolution, 30 or 60 frames per second, a CPU or GPU encoder, speed and quality are the
+ same options as the export panel. `sv_cancel_export` stops a running export. `sv_export_json`
+ writes the scene list, or the full settings, to a path, with no dialog. `sv_save_snapshot` writes
+ the live picture to a path as a JPEG. These three tools take only an absolute local path with
+ the matching extension: `.mp4` for the video, `.json` for the settings, `.jpg` or `.jpeg` for the
+ picture. Network paths and addresses such as `tcp://` are refused, and so are the app's own
+ folders. An existing file is replaced only with `overwrite: true`. `sv_record_start` and `sv_record_stop` drive the admin recorder.
+ Stopping opens the same save dialog as the Record card. The recorder needs the admin window open.
+
+#### Full
+
+Opens the live surfaces.
+
+- `sv_open_output` opens the visualizer on the chosen displays. Passing a display id replaces the
+ selected set. `sv_close_output` closes visualizer windows. `sv_set_displays` chooses displays and
+ leaves the windows as they are.
+- `sv_set_stream` changes the OBS and browser stream. `sv_set_texture_share` changes Spout and
+ Syphon. `sv_set_aspect` changes aspect correction. `sv_set_power` changes the frame-rate cap,
+ the render scale and `keepAwake`, which keeps the display awake while a visualizer window is open.
+- `sv_set_floating` changes floating-window preferences, including opacity and click-through.
+ `sv_set_floating_open` opens or closes that same picture-in-picture window.
+- `sv_set_window_mode` sets a transparent background, the transparency threshold and taskbar cover.
+- `sv_set_lighting` changes Windows Dynamic Lighting. `sv_set_openrgb` changes OpenRGB.
+ `sv_set_artnet` changes Art-Net. `sv_set_audio_sources` replaces the input mix.
+- `sv_set_mapping` writes one display's projection map: enable, corners, crop, edge blend, masks,
+ mesh, colour and test pattern, and turns mapping on. It binds no new network port.
+- `sv_timeline_transport` plays, pauses, stops or seeks the timeline through the admin transport.
+ The admin window has to be open.
+- `sv_set_blackout` takes `on`, `off` or `toggle` and leaves the stored scene in place.
+ `sv_set_blackout_transition` sets the blackout transition type and duration.
+
+#### Everything, and the general patch
+
+`sv_patch_config` sets any other dotted path. The mode follows the path: scene content, effects
+and presets need **Write**; export paths need **Write**; displays, stream, lighting, mapping,
+windows and the timeline need **Full**; `control.*` (MIDI and OSC bindings) needs **Everything**.
+A path that holds a stricter one needs that mode too: the whole `stream` object needs
+**Everything** because it holds the tokens, and the whole `power`, `audio`, `background` and
+`transition` objects need **Full**. A path the table does not know needs **Everything**. The paths
+`mcp.*`, `version`, `__proto__`, `prototype` and `constructor` are refused.
+
+`sv_updates_download` and `sv_updates_install` download and install an update the app has found.
+`sv_rotate_stream_token` replaces the OBS or remote token. `sv_repair_audio` restarts capture when
+the audio component is healthy; when it is missing it says so, because installing it needs the
+user's consent. All four need **Everything**. The reads `sv_diagnose_audio` and `sv_get_analysis`
+return the capture diagnosis and the live analysis (key, chord, pitch, loudness, drum bands).
+
+---
+
+### The control panel
+- **Eight categories** — Scene, Audio, Lighting, Output, Control, Studio, Library and Settings.
+- **Live everywhere** — every change reaches the output windows immediately and saves itself.
+- **A live preview** with its own demo signal, audio meters and saved scenes beside every page.
+- **Modified badges** on each card and category, with a reset for the section or the whole category.
+- **Search** across every setting in every category (Ctrl + K).
+- **Advanced** toggles hide rarely used controls until you want them; **extended ranges** raise the
+ slider limits 5×.
+- **Turkish and English**, switchable at runtime; the self-test fails if any interface string is
+ left untranslated.
+
+---
+
+### Reliability, power and updates
+
+- **Accidental-close protection** — a visualizer window that closes unexpectedly (a crash, Alt+F4)
+ reopens at once; *Prevent accidental quit* asks before the app closes during a show; an optional
+ ESC lock, with Ctrl + Shift + Q as the way out.
+- **Keeps the display awake** 3.1.5 — on by default while a visualizer window is open and
+ not minimised, on Windows, macOS and Linux; minimising or closing hands control back to your power
+ settings.
+- **Every GPU surface recovers from a lost context** 3.1.5 — a driver reset no longer
+ leaves black layers until a restart.
+- **Main-process faults are contained** 3.1.5 — an unexpected error is logged and shown in
+ the panel instead of freezing the app behind an error dialog.
+- **Two copies at once** 3.1.5 — a second copy names the one already running and offers to
+ switch to it; a copy never silently writes over settings someone else changed.
+- **Updates** 3.1.5 — *Library → Updates* checks GitHub Releases, shows the notes, and
+ lets you skip a version. The Windows installer and the AppImage download and install in place;
+ nothing runs unless the size and the SHA-256 match exactly. Off, notify (default) or automatic.
+- **Settings backup and restore** — every setting in one JSON file; palettes and scenes have their
+ own export and survive an import. Files written by 1.3 and 2.0 load without losing a value.
+- **Power and performance** — *Match Display* frame rate or a cap of 120, 60 or 30 FPS, background
+ resolution scale, pause on silence, hide cursor, always on top, and cover the taskbar.
+
+---
+
+### Privacy and security
+
+- **No account, no telemetry, no analytics.** Settings live in your user folder.
+- **One network call of its own**: GitHub's latest-release API for the update check, with no
+ identifiers. Set updates to *Off* and there are none.
+- **Everything else is opt-in and local**: the stream server (LAN, token-protected; it refuses
+ pages from other origins and host names it does not know 3.1.5), OSC, OpenRGB, Art-Net
+ and MCP (bound to `127.0.0.1` only, with a bearer token).
+- **Converters and generators run offline** — Shadertoy and ISF import, the scene generator, the
+ MilkDrop preset generator, lyrics.
+- **The camera is never opened by automation**, and a fuzzing test asserts that no MilkDrop preset can
+ smuggle JavaScript into the engine.
+
+---
+
+## FAQ
+
+**Is it free?**
+Yes. CAYADEV Visualizer is open source under the MIT licence. There is no paid tier, no account and
+no watermark.
+
+**Do I need Stereo Mix or a virtual audio cable?**
+Not on Windows: system audio is captured straight from the output device. On macOS, system audio
+needs a virtual device such as BlackHole (microphones work directly). On Linux, the PulseAudio or
+PipeWire monitor source is used automatically.
+
+**Does it work with Spotify, YouTube, Apple Music or a DAW?**
+Yes — it visualizes whatever your computer plays. On Windows you can capture one application only
+(say, Spotify) and ignore everything else, and Now Playing reads the track title and cover from the
+system media session.
+
+**Can I use it as an OBS overlay?**
+Yes. Turn on Streaming Output and add the address as a Browser Source. Transparency works, and OBS
+can run on a different computer on the same network. Spout (Windows) and Syphon (macOS) are there for
+GPU sharing as well.
+
+**Can it load my MilkDrop presets?**
+Yes: single `.milk` files, MilkDrop 3 `.milk2` double presets 3.1.5, ZIP packs, folders, or
+a search of your computer. Point the app at a MilkDrop `textures` folder for presets that use images.
+No third-party preset pack is bundled; five original presets are.
+
+**Is it a Winamp or projectM plugin?**
+No. It is a standalone application with its own MilkDrop-compatible engine in WebGL2. It does not
+embed projectM or MilkDrop.
+
+**Does it support several monitors and projectors?**
+Yes — a full-screen window on every selected display, plus projection mapping, edge blending and
+aspect correction for projectors and LED walls.
+
+**Can I make a music video from a track?**
+Yes. Video Export renders an audio file to MP4 frame by frame, up to 4K at 60 fps, using the current
+scene. It is not a screen recording, so the result does not depend on how fast your computer is.
+
+**Can AI agents control it?**
+Yes 3.1.5. Turn on MCP on the Control page and connect Claude Desktop, Codex, Cursor or any
+MCP client with the command the setup dialog gives you. Access starts at read-only. The command needs
+[Node.js](https://nodejs.org/) LTS on the computer.
+
+**Will it slow my computer down?**
+It needs a GPU with WebGL2. Use the frame-rate cap, the background resolution scale and pause on
+silence on laptops; the MilkDrop panel shows mesh density and internal resolution.
+
+**Can it be a screen saver?**
+There is a Screensaver template group, and the display is kept awake while the visuals run, but the
+application does not register itself as an operating-system screen saver.
+
+**How well are macOS and Linux supported?**
+Both are built on CI runners and the audio engine loads there, but neither build has yet been run on
+real hardware by the project. Windows is where everything is measured. Reports from Mac and Linux
+users are very welcome.
+
+**My video freezes in full screen or in Spout, or an iPhone video will not play.**
+Videos are decoded on the CPU by default, which keeps them smooth in full screen and in the
+Spout/Syphon feed 3.1.5. HEVC/H.265 files (common from phones) can only be decoded in
+hardware: turn on Settings → Application → Hardware Video Decoding and restart the app.
+
+**Is my data sent anywhere?**
+No. See [Privacy and security](#privacy-and-security).
+
+---
+
+## MilkDrop engine notes
+
+The engine's fidelity work, measured preset by preset. MilkDrop Fidelity is on by default; switching
+it off restores the engine's earlier look.
+
- **The preset language actually runs** — tokeniser, parser, and compilation to JavaScript
closures. `per_frame` and `per_pixel` equations drive a real warp mesh with feedback, including
`megabuf`/`gmegabuf`, `loop`, `while`, `exec2`/`exec3` and compound assignment.
@@ -244,6 +1200,41 @@ that asserts the bar profile has no step in it.
correcting for a wide screen corrected the wrong axis. The blurred copy is darkened at its edges
(`b1ed`, 68.6% ask for it), and a custom wave is drawn at MilkDrop's amplitude and reads the
spectrum when it asks for the spectrum (23.2% do).
+- **Presets without a shader of their own look as they do in MilkDrop 2.** MilkDrop picks a preset's
+ warp and composite shaders by the file's version, not by whether shader text is present, and
+ draws the rest with a fixed pipeline built from blend passes. Checked against MilkDrop 2's source
+ and the original D3D9 code: brighten there is `1−(1−c)²` and solarize `2c(1−c)`, not the
+ `sqrt(c)` and `4c(1−c)` the engine used (410 and 83 presets of a 10,332-preset corpus turn them
+ on); echo orientation is `(int)x % 4`; gamma below 1 is ignored while echo is on; and when two
+ presets whose echoes point different ways blend, the echo fades out and back in instead of
+ flipping. A preset that leaves out its decay or gamma gets MilkDrop's 0.98 and 2.0 instead of 0,
+ and so do the other values it leaves out — down to MilkDrop's quirk of reading a missing wave
+ colour as 0; a rotation centre of 0 stays in the corner. The values MilkDrop keeps out of the
+ equations (wave scale and smoothing, the volume fade, warp speed and scale) come from the file as
+ they do there, so a wave scale of 0 flattens the wave (102 presets of the corpus). Rendered
+ through the engine, every case matches MilkDrop's formula within 2/255.
+- **Preset files are read the way MilkDrop reads them.** With fidelity on, keys are case-sensitive,
+ a key written twice takes the value MilkDrop finds (usually the first), numbered code ends at the
+ first missing number, integer settings drop their fractions, and equation lines are glued the way
+ MilkDrop glues them, `\\` comments included. 32 presets of the corpus read differently; with
+ fidelity off the old parser stays.
+- **Equations run by MilkDrop 2's compiler rules.** With fidelity on, truth and equality tests use
+ its 0.00001 tolerance, `%` works on whole numbers without sign, `&` and `|` on 64-bit integers,
+ `megabuf` and `gmegabuf` indices are rounded and bounded the way it does, `rand(n)` returns a
+ real number (5,361 corpus presets call it), and the compiler's internal names such as `_aboeq`
+ run. With fidelity off nothing changes.
+- **Each block keeps MilkDrop's own variables.** With fidelity on, per-pixel code and a wave's
+ per-point code run in their own variable space the way MilkDrop's separate machines do: they see
+ only what MilkDrop hands them (time, audio, the mesh size, q1..q32 and for waves t1..t8), keep
+ their own variables and `megabuf`, and nothing they write leaks back. `reg00`..`reg99` are
+ shared by every block and preset, so shapes now see the random values init leaves there, and
+ `loop`/`while` stop at MilkDrop's 1,048,576 turns a call.
+- **Composite shaders get the hue colour MilkDrop gives them.** MilkDrop passes every composite
+ shader four slowly drifting corner colours as `hue_shader`, whatever the preset's `fShader`
+ says; `fShader` only scales them on the fixed pipeline. The engine applied `fShader` to shaders
+ too, so about 950 presets of the corpus drew without their colour or with part of it, and the
+ corners were mirrored top to bottom. On the fixed pipeline the colour now goes through MilkDrop's
+ own draw passes, the wraparound of out-of-range colours included.
- **Textured shapes, motion vectors, rotation matrices, mesh density, internal resolution scale,
mouse input and preset transitions** are all implemented, and each sampler is read with the
filtering and wrapping its name asks for (`sampler_pw_main` is point-sampled, `sampler_fc_main` is
@@ -263,6 +1254,36 @@ that asserts the bar profile has no step in it.
times a second, the swing per cycle was 0.714 in the panel's 45 fps preview but 1.000 on a 74 Hz
display, the flash untouched. It is now held per second: 0.43–0.49 in the preview, in 60 Hz and
74 Hz windows, in a 35 fps window and on the web overlay alike.
+- **MilkDrop follows the system's reduce-motion setting.** When the operating system asks for
+ reduced motion (on Windows, *Animation effects* turned off under Accessibility › Visual effects),
+ the flash limiter stays on even if it was turned off, loud moments no longer hard-cut, and every
+ change blends over 5 seconds. Auto advance plans with that longer blend, so a preset is still
+ shown in full for the time you set. A manual *Cut now* still cuts. The MilkDrop panel says
+ whether it is on and why, and *Reduce Motion* overrides it either way: *Always*, or *Off* even
+ when the system asks. Each screen reads its own system — a web overlay on another machine follows
+ that machine — and video export follows only *Always*, so a video never depends on the machine
+ that made it. Checked in an isolated copy with the setting emulated in the browser engine; the
+ system's own setting was left alone.
+- **A lost GPU context comes back.** A driver reset or a GPU process crash takes every WebGL object
+ with it, and MilkDrop stayed black until the application was restarted: nothing in the code
+ listened for it. The engine now holds the loss, asks the browser for the context back and rebuilds
+ its programs, textures and buffers on the same canvas when it arrives; if it does not arrive
+ within three seconds — a browser that gave up, or a context lost by hand — it starts again on a
+ fresh canvas. The running preset survives either way: the same object, the same equation state and
+ the same clock, so it carries on from where it stopped instead of restarting. What cannot come
+ back is the feedback buffer's content, which lived in GPU memory, so the picture flows again from
+ black. Chromium's habit of blocking 3D for a page whose GPU process crashed is turned off, because
+ that block would leave the recovery with nowhere to go. The GPU self-test loses the context on the
+ running engine both ways and checks that frames, pixels and the preset's own state come back.
+- **So does every other GPU surface.** A real GPU reset takes every context at once, so MilkDrop
+ coming back was not enough while the gradient background, the 3D geometry mode, the shader modes,
+ the effect chains and projection mapping stayed black. None of them carries feedback or built-up
+ state, so each now reports a lost context and its owner builds a fresh one with the same settings:
+ a layer is rebuilt in place, in the same position and with the same blend, opacity and z-order;
+ the effect chain keeps its effects. A surface is rebuilt at most every two seconds, so a GPU that
+ is still restarting does not get a new canvas every frame. The GPU self-test loses the context of
+ a gradient background and of the effect chain on the running stage and checks both come back with
+ a picture (brightest sample 175 and 206 of 255, the same as before the loss).
- **Preset transitions are MilkDrop's dual pipeline.** The previous preset does not stop when a new
one loads: it keeps its own object, its own compiled shaders and its own clock, and both presets
run their frame and vertex equations every frame. The two warp meshes are blended per node along a
@@ -281,6 +1302,110 @@ that asserts the bar profile has no step in it.
mesh 64 with a hard cut, 12.10 ms with a transition; at mesh 96 that one frame goes 12.00 → 18.00
ms and drops a frame. So the default is 1.7s, MilkDrop's own `fBlendTimeUser`, and automatic
preset advance stays off by default, which means a transition only ever runs when you ask for one.
+- **A preset change no longer stalls the frame.** Measured across 900 presets at 1280×720, the
+ frame that loaded a preset ran a median 17 ms and at worst ~119 ms over its neighbours, and six
+ changes in ten dropped a frame that would otherwise have held — nine tenths of it the GPU compiling
+ the new shaders while the frame waited. Where the driver offers `KHR_parallel_shader_compile` the
+ compile now runs in the background and the running preset keeps drawing; the change, transition
+ included, starts once the new programs are ready, a median two or three frames later. With auto
+ advance the next preset is chosen a second early and compiled in advance, so the change still
+ lands on time — on the bar in bar mode — and the other screens prepare the same one. At the
+ default mesh the changes that drop a frame fell from 61.9% to 4.9% with a hard cut and from 61.7%
+ to 8.1% with a transition. Video export still waits for each compile, so the frame a preset
+ appears on never depends on the machine.
+- **A new track can bring the next preset.** Next to auto advance, *On Track Change* moves to the
+ next preset — in the chosen order, random included — when Now Playing sees a new track. It works
+ with the timer off, the lock stops it too, and only the leading screen picks, so every screen
+ changes together. The track already playing when the app opens does not count, nor does the gap
+ between two tracks.
+- **Favourites, tags and search by author.** Star presets in the MilkDrop panel's list, or the one
+ on screen with *Favourite* (also from a MIDI or OSC mapping), and give them tags of your own.
+ Search matches the name, the author and the tags. MilkDrop names are mostly "Author - Title", so
+ `author:geiss` (or `yazar:`) finds Geiss's presets but not a title that mentions him, and `#calm`
+ finds a tag. *Show* narrows the list to favourites or one tag, *Author* to one author. *Pool*
+ limits auto advance — the timer, hard cuts and track changes — to favourites or one tag, while Previous,
+ Next, Random and the list still reach every preset. Favourites and tags live in the settings next to
+ your ratings, not in the preset files, and a pack carries all three: *Pack What Is Shown* writes
+ the presets in view with them, and importing the pack attaches them to the new copies. Checked in
+ an isolated copy: with the pool set to three favourites, the visualizer window went round those
+ three and nothing else.
+- **Large preset libraries stay light.** Every save or delete used to re-read every preset file
+ and send the whole list, sources included, to the panel, each window and every web client. With
+ the 10,347 presets of a full MilkDrop library (116 MB) one delete held the app for about 2.4
+ seconds and the panel used 631 MB. Presets are now read once and kept; a change sends only what
+ changed. At the same size a save now takes 91 ms and the panel uses 273 MB. Deleting or adding
+ MilkDrop presets no longer restarts the MilkDrop picture on screen. Web clients get MilkDrop
+ presets without their sources (271 KB instead of about 30 MB for 2,000 presets), and the web
+ overlay fetches the source of a preset only when it is about to draw it.
+- **Import a whole MilkDrop library.** *Import from ZIP Pack*, *Import from Folder* and *Search This
+ Computer* in the MilkDrop panel bring in a library in one go: nested folders, the pack's
+ textures, and — if you want — the pack's category folders as tags. Nothing is copied until you
+ have seen what will be added (presets, textures, MB, and what will be skipped: MilkDrop 3's
+ `.milk2` double presets, oversized files, encrypted ZIP entries) and confirmed. Presets with the
+ same name and content are skipped, so importing a pack twice adds nothing. Textures go into the
+ app's own folder and are looked up after the texture folder you chose, so a pack's
+ `sampler_worms` works without choosing a folder. The search looks in the usual Winamp,
+ foobar2000 and projectM folders and in Downloads, Desktop, Music and Documents, wherever the
+ system keeps them, and stops after a few seconds; a library it could not finish counting is
+ scanned in full before you are asked. No preset pack ships with the app. Measured with real
+ packs: a 9,795-preset folder was scanned in 1.1 s and imported in 6.2 s, and importing it again
+ added nothing.
+- **Preset thumbnails.** The MilkDrop panel's list has a *Grid* layout: every preset shows a small
+ picture of itself, so a preset can be found by its look. Each thumbnail is drawn once in the
+ background — the first two seconds of the preset with the demo sound, from a black screen — kept
+ in the app's data, and drawn again when the preset or a texture it uses changes. Only the
+ presets you scroll to are drawn. A visualizer window drawing MilkDrop at the same time barely
+ noticed: none of its frames took longer than 27 ms. Found while building this: when another
+ MilkDrop window was drawing and the computer was busy, a MilkDrop picture that had just set up its
+ buffers (a new window, a resize, a thumbnail, a video export) could start from the other window's
+ picture. Buffers now start from zeros.
+- **A preset generator of our own.** *Studio → MilkDrop Preset Generator* writes an original
+ MilkDrop preset from four sliders — energy, warmth, density and motion — and a seed. It runs
+ offline, and every motion, wave, shape and shader pattern it uses was written for this app: no
+ line of it longer than 30 characters appears in a 10,332-preset corpus. The preset loads straight
+ away as a preview without being saved; *Save to Library* keeps it. Moving a slider keeps the
+ seed, so you get the same preset with more energy or warmer colours rather than a different one,
+ and a code such as `72-15-60-88-2n9c` brings the same preset back. Nothing in a generated preset
+ flashes: its colours stay in range at any volume, and invert, solarize and brighten are never
+ used. Measured on 200 generated presets with silence, the demo sound and a loud bass line: every
+ shader compiled, and none went black, washed out to white, flashed more than twice a second or
+ froze.
+- **Mash-ups from your library.** The same card builds a preset out of pieces of the presets you
+ already have: the look (decay, echo, gamma, the main wave), the motion equations, the custom
+ waves, the custom shapes, the warp shader and the composite shader — each taken whole from one
+ preset and copied line for line. *New Mash-up* draws every part at random from the presets the
+ MilkDrop panel's list shows, so its search and filter apply, and only from presets that have that
+ part. A single part can be drawn again, or all six can start from the preset on screen; the arrows step
+ back through earlier mash-ups, and *Save to Library* keeps one. A mash-up inherits its donors'
+ looks, so it can come out brighter or darker than any of them. Checked on a 10,332-preset corpus:
+ a mash-up of one preset is that preset again, and in 5,000 random mash-ups every part was
+ exactly its donor's. 300 random mash-ups ran in the engine without a single shader failure.
+- **An editor for presets.** *Studio → MilkDrop Preset Editor* opens the preset on screen: frame and
+ pixel equations, custom waves and shapes, the warp and composite shaders and the main values each
+ have a tab, and a change shows in the running picture a moment after you stop typing. Errors point
+ at the preset's own line (`per_frame_14`) with its own text, not at generated code; shaders are
+ compiled as you type. Sliders for zoom, warp, rotation, decay and echo say when the preset's
+ equations rewrite the value every frame. The original is never changed: *Save as a New Preset*
+ keeps your version, and only what you changed is written — the rest of the file keeps its bytes.
+- **MilkDrop 2 and MilkDrop 3 rules.** A *Preset Format* setting — Automatic, MilkDrop 2 or
+ MilkDrop 3 — picks whose file rules a preset is read with: MilkDrop 3's 16 custom waves and shapes
+ and q1–q64, or MilkDrop 2's four and q1–q32. Automatic reads a preset with MilkDrop 3 rules when
+ it uses those extensions, and the panel names them. MilkDrop 3's hard-cut modes 1–6 are offered
+ with its thresholds and delays. Its `.milk2` double presets load as a frozen blend of their two
+ presets. Its new waveforms, new transitions and `get_fft` in shaders are not here yet: nothing
+ describes how they behave.
+- **Sprites from `milk_img.ini`.** MilkDrop 2 draws images of your own over the picture during a
+ show: each one is defined in `milk_img.ini` with an image, code that runs once and code that
+ runs every frame, and launched by number. Choose the file in the MilkDrop panel and launch from
+ its list, from a MIDI or OSC mapping, or with MilkDrop's own keys in the visualizer window — K
+ and two digits launch, SHIFT+K and two digits remove that number, DELETE removes the newest. Up
+ to 16 run at once; the five blend modes, the colour key, tiling, flipping and `burn` (the sprite
+ leaves its image in the feedback and flows with the preset) follow MilkDrop 2's source. Every
+ screen shows the same sprite, `rand` included: the launch carries its seed. Measured in an
+ isolated copy with three displays, the web output, Spout and the panel preview: all six drew the
+ probe image at every sample point, a sprite placed with `rand` sat at the same x/y on all of
+ them, and a burnt sprite's image stayed where the sprite was after it died. Sprites are a live
+ tool and are not part of video export.
- **Auto advance advances.** The panel's Auto Advance slider had been there since the engine landed
and nothing ever read it: set to two seconds, the same preset stayed on screen (measured in the
running app — nine seconds, no change). It now moves on every *n* seconds, in order or at random,
@@ -310,7 +1435,7 @@ that asserts the bar profile has no step in it.
MilkDrop, with a switch — and the panel shows the rating you gave the preset on screen as stars you
can change; a preset you have not rated shows none, while random order keeps weighting it by its
own file's rating. Your rating goes into the settings rather than into the preset, because saving a preset
- re-sends the whole library, sources included, to every window. ◀ and ▶ now walk the history of
+ re-sends the whole library, sources included, to every window. Previous and Next now walk the history of
what was actually shown, including what auto advance and hard cuts picked, instead of stepping
through the list from the preset you last clicked; the history keeps MilkDrop's 64 steps. One
difference is deliberate: after going back, a new preset drops the forward part, as a browser
@@ -417,671 +1542,7 @@ that asserts the bar profile has no step in it.
---
-## Studio — write your own shader
-
-
-
-- **GLSL editor** with live preview, error line reporting and your own sliders.
-- **42 built-in shaders**, all compiled on a real GPU by the self-test.
-- **Shadertoy and ISF import** through local converters. No service is contacted.
-
----
-
-## Aspect correction
-
-A display's reported resolution does not always match its physical shape. A panel driven at
-1920x1080 that is really about 3:1 — a stage LED wall, a bar display, an anamorphic projector, a TV
-forced into a stretched mode — draws every circle as an ellipse. Logos come out squashed, and so
-does everything else: text, effects, the background.
-
-- **The frame is never stretched.** Scaling a finished frame up crops it and scaling it down leaves
- bars. Instead the scene is drawn on a square-pixel canvas matching the panel's real shape and
- squeezed linearly into the framebuffer, where the panel's own distortion undoes the squeeze.
- Nothing is cropped and nothing is pushed off the edge.
-- **One setting corrects everything** — background, visualizer, logo, text and sprites share the
- same logical space, so pre-stretching each image by hand stops being necessary.
-- **Calibrated by eye.** Nobody can measure the LED wall behind the stage, but anyone can see
- whether a circle is round: turn on a circle, square or grid and move the slider until it looks
- right. Panel size, true aspect ratio and the dimensions of an already-stretched image are
- secondary paths to the same number.
-- **Per screen or all screens**, and it composes with projection mapping without moving an existing
- corner calibration.
-- **A property of the physical output, not of the scene** — exported video, the stream and the web
- overlay are left alone.
-
----
-
-## Projection mapping
-
-
-
-- **Corner pin** as a true homography, with the denominator written into `gl_Position.w` so the
- texture stays perspective-correct.
-- **Mesh warp** on a Catmull-Rom grid that passes through its control points.
-- **Soft edge blending** for multi-projector rigs; the curves are tested to sum to exactly 1
- across the overlap.
-- **Per-output crop, colour correction and polygon masks**, plus alignment grids and test patterns.
-
----
-
-## Scene transitions
-
-
-
-- **18 transitions** — crossfade, dissolve, wipes, slides, luma wipe, glitch, zoom, blur, flash.
-- **Switchable off** if you want scenes to cut.
-- Triggered by a change of *scene*, not by a change of any setting, so dragging a slider never
- starts one.
-
----
-
-## Templates
-
-
-
-- **72 finished scenes** in nine groups: Club, Ambient, Streaming, Music Video, Music, Screensaver,
- 3D Geometry, Genre and Event.
-- **One click**, and your audio device, display selection, streaming and lighting settings are left
- alone — trying a template must not damage a working setup. A test asserts it.
-
-
-
-- **Audio-reactive typography** with per-character response.
-- **LRC and SRT import**, format detected from the content, enhanced LRC word timings supported.
-- **Timing editor** with a sync offset that writes back to LRC.
-- **Now-playing metadata**, editable, and bindable as separate title and artist layers.
-
----
-
-## Recording and export
-
-
-
-- **One-key capture** of the live output, exactly as it appears — with the live audio, modulation,
- transitions and effects.
-- **MP4, WebM, GIF and PNG.** GIF uses two-pass palette generation, because one pass bands
- visibly.
-- **PNG snapshot** at up to 4×.
-- **Export presets** for common aspect ratios.
-- **Offline video export** renders an audio file frame by frame, deterministically — the same
- property the visual regression tests rely on.
-
----
-
-## Streaming output — OBS and the browser
-
-Turn on **Output → Streaming Output** and the application serves an overlay page.
-
-- Add it to OBS as a **Browser Source**. No plugin, and real transparency.
-- The overlay runs the **same engine** as the desktop window, so what you see is what streams.
-- Works across the network, so the visualizer can run on one machine and OBS on another.
-- **Transparency is the app's own switch.** With **Background → Transparent Background** on, the
- overlay is transparent in OBS just as the window is on the desktop; with it off, the scene streams
- as you see it. Add `?transparent=0` or `?transparent=1` to one source's address to force it either
- way. Spout and Syphon stay opaque: a shared GPU texture cannot carry alpha without dropping the
- sender.
-- **When the overlay cannot start, it says so.** In v3.1.3 the overlay page crashed on load — it
- never loaded `aspect.js` — and the error sat in a hidden box, so OBS and the browser showed an
- empty page with nothing in the console (#563). The page now shows the error and logs it, and the
- self-test loads the overlay from the real stream server on every run, packaged builds included.
-- **A diagnostics card for when something is wrong.** Add `?debug=1` to the overlay address and a
- card in the corner shows whether the page is connected and how many attempts it took, whether and
- when the configuration arrived, audio frames per second and the age of the last one, the page's
- own frame rate and canvas size, the transparency in use, the version of the application that
- served the page, and the last error — a script that failed to load included. It is translated
- like the rest of the page and stays off unless asked for; the self-test opens the overlay with
- it on every run (#565).
-- **The visualizer window itself can be the overlay.** Turn on **Background → Transparent
- Background** and the desktop shows through the window: a solid colour is not painted, and a
- background effect's dark parts turn transparent below the **Transparency Threshold** — black
- always, brighter areas stay. Until v3.1.4 the switch did nothing visible: the window was created
- transparent, but the page painted its own background colour inline on top of it. Switching it
- re-creates an open visualizer window, because a window's transparency is fixed when it is created.
-- **Transparency survives post-processing.** Every post-FX pass wrote an opaque alpha, so one
- enabled effect turned the transparent overlay — and the transparent window — into a black
- rectangle. In transparent mode the scene now goes through the effect chain premultiplied, and
- coverage comes from the scene's own alpha, so dark text, outlines and shadows stay solid. Effects
- that spread light — bloom, blur — add their glow over empty pixels; when the chain also moves the
- image (glitch, chromatic aberration, mirror), coverage stays the scene's own, so a shifted copy
- never lands as a ghost in empty space.
-
-### Mobile remote
-
-
-
-The same server hosts a phone-sized remote for scenes, templates and Studio presets, plus MIDI and
-OSC control surfaces.
-
----
-
-## GPU output — Spout and Syphon
-
-The picture can be handed to another application on the same machine **over the GPU**: no window
-capture, no plugin, no CPU copy.
-
-- **Spout** on Windows, **Syphon** on macOS. Receivers include Resolume, OBS, TouchDesigner,
- MadMapper — anything that speaks either protocol.
-- Pick the **source name** receivers will look for, plus resolution and frame rate.
-- It renders into its own hidden window, so the feed keeps running even when no visualization
- window is open on any display.
-- **Not available on Linux.** Spout is a Windows technology and Syphon a macOS one, and Linux has
- no built-in equivalent. The panel says so and points at the OBS browser source, which works
- everywhere.
-
----
-
-## The classic looks
-
-The styles the application shipped with, still one click away.
-
-
-
-| All visualizer modes | All backgrounds |
-|:---:|:---:|
-|  |  |
-
-
-
----
-
-## Everything, in detail
-
-The sections above show what the application looks like. This one lists what is
-actually in it, by name.
-
-### Backgrounds — 31 types
-
-**Fluid** — **Fluid Gradient** (an audio-reactive mesh gradient in a WebGL shader, in *Soft* and
-*Plasma* styles, with flow speed, wander, orbit, swirl, warp, scale, grain, vignette, audio burst
-brightness and audio hue shift) · **Ink** (liquid blobs that swirl as they flow: blob count,
-viscosity, swirl, spread) · **Nebula** (overlapping soft gas clouds: layer count, size, softness,
-density) · **Wave Layers** (crests that swell with the audio: layer count, crest height, wave
-frequency, spacing, opacity) · **Aurora** (undulating light curtains: curtain count, thickness,
-undulation, edge softness, vertical position)
-
-**Geometric** — **Retro Grid** (a perspective grid receding to the horizon: horizon height, row and
-column counts, line width, horizon glow, sky intensity, spectrum response) · **Hex Grid**
-(hexagonal cells lit by a wave spreading from the centre and by the spectrum) · **Mosaic** (a
-jittered cell grid where each cell follows a frequency band) · **Corridor** (rings or polygons
-coming toward the viewer: ring count, speed, sides, twist) · **Helix** (a rotating multi-armed
-spiral: arms, turns, taper) · **Pulse Rings** (rings expanding from the centre, with extra rings
-spawned on bass hits: rate, expansion speed, thickness, fade) · **Network** (drifting nodes linked
-to their close neighbours: node count and size, link distance, line width, speed)
-
-**Atmosphere** — **Starfield** (stars streaming out from the centre: count, size, motion trail,
-depth, twinkle) · **Snow / Embers** (swaying particles falling with depth) · **Bokeh Lights** (soft
-out-of-focus orbs: count, size, size variation, drift, bass pulse) · **Digital Rain** (falling
-luminous streaks: columns, fall speed, trail length, density, thickness) · **City** (a two-layer
-parallax skyline whose windows light up with the music)
-
-**Generative** — **Liquid Metal** · **Plasma** · **Caustics** · **Ribbons** · **Contours** ·
-**Wave Field** · **Embers** · **Sand** · **Stained Glass** · **Circuit Board** · **Prism** ·
-**Globe Mesh** · **Wire Tunnel** · **Hex Pulse**
-
-**Other** — **Studio Preset** (a GLSL shader you wrote yourself) · **Solid Colour**
-
-Five colour stops, **58 built-in palettes** in seven groups (Classics, Warm, Cool, Neon & Cyber,
-Dark, Light, Monochrome Families) and your own saved palettes apply to every background type, to the
-Studio engine and to the 3D engine.
-
-### Visualizer — 48 modes
-
-**Basic** — **Bars** · **Center** · **Segments** (LED equaliser) · **Dot Matrix** · **Skyline**
-(buildings with lit windows)
-
-**Waveform** — **Wave** (oscilloscope) · **Ribbon** (waveform history) · **3D Wave** (history
-stacked in perspective) · **Lissajous** (XY oscilloscope) · **Strings** (each string vibrates with
-its band) · **Terrain** (perspective wireframe landscape)
-
-**Radial** — **Circle** · **Radial Wave** · **Rays** · **Arcs** (one arc per band) · **Pinwheel** ·
-**Mandala** (polar rose curve) · **Kaleidoscope** · **Swirl** · **Helix** · **Tunnel** · **Orb**
-
-**Particles and events** — **Particles** · **Fireworks** (bursts on the beat) · **Lightning**
-(branching bolts on bass) · **Bubbles** · **Liquid Blobs** (metaballs) · **Ripple Grid** (rings
-spreading on the beat) · **Spectrogram**
-
-**Generative** — **Flow Field** (particles steered by a noise field) · **Flock** (boids driven by
-the spectrum) · **Voronoi** · **Truchet** · **Moiré** · **Wave Interference** · **Ropes** (verlet
-physics kicked by onsets) · **Galaxy** · **DNA Helix** · **Isometric City** · **Attractor Field**
-(discrete maps from the formula library with two parameters bound to audio)
-
-**Measurement** — **Oscilloscope (XY)** · **Goniometer** (stereo phase scope) · **Chroma Wheel**
-(pitch classes in circle-of-fifths order, highlighting the detected chord root)
-
-**Engines** — **3D Geometry** · **MilkDrop** · **Feedback** · **Text / Lyrics** · **Studio Preset**
-
-Bar count, min and max frequency, gap, position, mirror, line width, amplitude, sensitivity and
-glow appear whenever they are meaningful for the selected mode. **Rainbow** can be turned off to
-pick a single or dual colour.
-
-### Spectrum metering
-
-- **Frequency scale** — logarithmic, linear, mel or bark.
-- **Amplitude scale** — linear or decibel, with a settable floor from −24 to −96 dB.
-- **Attack and release** as separate time constants, frame-rate independent.
-- **Neighbour spread** (widens peaks without flattening them) and **profile smoothing** (a
- symmetric neighbour average).
-- **Spectral tilt** in dB per octave, neutral at 1 kHz.
-- **Bar placement** — width, horizontal position, height and baseline, each a fraction of the
- frame.
-
-### Layers, masks and groups
-
-- Unlimited layers, each with its own source, blend mode, opacity, transform (scale, rotate, X/Y,
- flip) and audio response (band, opacity, scale, rotate).
-- **17 blend modes** — Normal, Add, Screen, Multiply, Overlay, Darken, Lighten, Colour Dodge,
- Colour Burn, Hard Light, Soft Light, Difference, Exclusion, Hue, Saturation, Colour, Luminosity.
-- **Masks** — alpha from another layer, plus rectangle, ellipse, linear and radial gradients, with
- position, size, angle, feather and invert.
-- **Groups** with a single fader, and an **A/B crossfader** on an equal-power curve.
-- **Solo, mute and lock** — solo isolates a layer reversibly, mute hides one without losing its
- settings, lock prevents accidental edits.
-- **Per-layer effect chains** in addition to the composite chain.
-- Copy, paste and duplicate layers across scenes.
-- The whole stack can be switched off, returning to the plain Background plus Visualizer setup
- without losing the list.
-
-### Post-processing — 40 effects
-
-**Composition** — Bloom · Glow · Vignette · Trails / Echo · Edge Highlight · Colour Grade
-
-**Blur and focus** — Gaussian Blur · Radial Blur · Directional Blur · Zoom Blur · Tilt-Shift ·
-Depth of Field (Bokeh) · Sharpen · Emboss
-
-**Halftone and pattern** — Dither (Bayer) · Halftone · ASCII Mosaic · Cross-Hatch (Pen) ·
-Oil Paint (Kuwahara) · Pixelate · Posterize / Invert · Threshold · Solarize
-
-**Analogue and damage** — Film Grain · CRT / Scanlines · VHS / Analogue Tape · Glitch (Slice
-Shift) · Datamosh (Block Shift) · Bad Signal · Chromatic Aberration
-
-**Distortion** — Lens Distortion · Twirl · Polar Transform · Ripple Distortion · Slit-Scan ·
-Kaleidoscope · Mirror
-
-**Colour and light** — Gradient Map · Levels & Curve · God Rays · Star Filter
-
-Each is orderable, has its own opacity, can be toggled, and any of its parameters can be driven by
-the modulation matrix.
-
-### Scene transitions — 18
-
-**Cut** · **Crossfade** · **Dissolve** · **Wipe** · **Radial** · **Clock** · **Barn** · **Blinds** ·
-**Stripes** · **Checker** · **Iris** · **Luma** (keyed on the outgoing frame's own luminance,
-normalised to its range) · **Zoom** · **Push** · **Slide** · **Flash** · **Glitch** · **Blur**
-
-Six easing curves — linear, smooth, ease-in, ease-out, ease-in-out and snap — plus a duration in
-seconds or in beats. Transitions can be switched off entirely, and they fire on a change of *scene*
-rather than on a change of any setting, so dragging a slider never starts one.
-
-### Modulation
-
-**Sources** — bass, mid, treble, level, onset envelope and onset trigger · eight spectrum bands ·
-four or more LFOs · two or more envelope followers · sample-and-hold · random · the beat clock ·
-macro knobs · and every deep-analysis measurement.
-
-**LFO shapes** — sine, triangle, saw up, saw down, square, pulse, random ramp and noise, with rate
-in Hz or in beat divisions (1/16 up to 8 bars) locked to the detected tempo, plus phase offset and
-pulse width.
-
-**Routing** — any source to any dotted configuration path, chosen from a live tree of the current
-settings. Each route has a minimum, maximum, an amount, a mode (set or add), a curve (linear,
-exponent, S-curve, quantise, invert), and its own smoothing and slew limiting.
-
-**Macros** — eight assignable knobs, exposed to MIDI learn and to the mobile remote.
-
-Values are applied copy-on-write, so modulation never alters your saved settings, and LFO phase is
-computed from the draw clock rather than accumulated, so offline export is frame-exact.
-
-### Deep audio analysis
-
-Chroma vector (constant-Q Goertzel filterbank), musical key (Krumhansl-Schmuckler profiles), chord
-from templates, harmonic/percussive separation, per-band onsets for kick, snare and hat, spectral
-centroid, rolloff, flatness and crest, loudness, dynamics, true peak, stereo width, correlation,
-mid/side bands, fundamental pitch (YIN), silence detection and auto-gain, plus a rolling spectral
-history buffer. Everything has a live meter and is available as a modulation source.
-
-### 3D geometry — 98 formulas and 13 solids
-
-**Plane curves (30)** — rose curves, lemniscates, cardioids, epicycloids, hypocycloids, spirals,
-roulettes, Lissajous figures, butterfly and superformula curves among them.
-
-**Space curves (12)** — trefoil and torus knots, Viviani's curve, helices, conical spirals and
-similar.
-
-**Surfaces (29)** — torus, Klein bottle, Möbius strip, Boy's surface, Dini's surface, breather,
-superellipsoid, Gielis supershapes, Chladni figures, trefoil tube and more.
-
-**Attractors (27)** — Lorenz, Rössler, Chen, Halvorsen, Thomas, Aizawa, Chua, Dadras, Sprott,
-Clifford, de Jong, Hénon and others, both continuous and discrete.
-
-**Solids (13)** — tetrahedron, cube, octahedron, dodecahedron, icosahedron, a geodesic sphere with
-subdivision control, four L-systems (tree, fern, dragon curve, 3D Hilbert curve) and three iterated
-function systems (Barnsley fern, Sierpinski tetrahedron, spiral).
-
-Render as wireframe, points or shaded, with resolution, deformation, spin, colour mode and audio
-binding on every parameter. The maths is the project's own — no third-party 3D library — and
-framing is measured from each system's real bounding box rather than declared by hand.
-
-### Studio — 42 built-in shaders
-
-**Backgrounds (25)** — Cloud Layers · Curl Flow · Lava Lamp · Ink Bleed · Smoke Rings · Hex Flow ·
-Warped Grid · Truchet Weave · Moiré Interference · Crystal Cave · Mandelbrot Zoom · Julia Set ·
-Burning Ship · Apollonian Gasket · Kaleidoscopic IFS · Menger Sponge · Mandelbulb · Light Tunnel ·
-Star Warp · Aurora Curtain · Liquid Metal · Neon Rain · Reaction Pattern · Water Caustics ·
-Prism Glow
-
-**Visualizers (11)** — Glowing Bars · Spectrum Ring · Wave Field · Beat Burst · Glowing
-Oscilloscope · Frequency Mesh · Note Ring · Particle Flow · Kaleidoscope Spectrum · Pulse Grid ·
-Liquid Bars
-
-**Plus six earlier presets** — Plasma Sea, Frequency Rings, Liquid Metal, Star Gate, Wave Curtain,
-Bass Sphere.
-
-The editor gives you live preview, error line reporting and sliders you declare yourself. Shaders
-receive `sv_resolution`, `sv_time`, `sv_level`, `sv_bass`, `sv_mid`, `sv_treble`, `sv_beat`,
-`sv_spec(x)`, `sv_waveAt(x)`, `sv_col(x)` for the user's palette, and `sv_media` for the camera or
-video layer. Shadertoy and ISF presets import through local converters.
-
-### MilkDrop
-
-The preset language runs for real: a tokeniser, a parser to an AST, compilation to JavaScript
-closures, the variable pool (`q1`–`q32`, `t1`–`t8`, `regNN`), the built-in function library — every
-built-in returns a finite number, including `log(0)` and division by zero — per-frame equations,
-per-pixel equations across the warp mesh, and the feedback renderer. `.milk` files import
-individually or as packs, with compile errors reported per file.
-
-### Text and lyrics
-
-Font, weight, size, alignment, X/Y position, opacity, outline and shadow · animation presets with a
-duration · per-character audio response with scale, jitter and lift · marquee and ticker · karaoke
-highlighting · LRC and SRT import with the format detected from the content and enhanced LRC word
-timings supported · a sync offset that writes back to LRC · now-playing metadata, bindable as a
-combined line or as separate title and artist layers.
-
-### Media layer
-
-Webcam or video file, placed in front of or behind the visualizer, with fit (cover, contain,
-stretch), mirror, kaleidoscope with 3–12 slices, hue shift, saturation, blend mode, opacity, and
-audio-driven zoom and opacity. The same frame is readable inside Studio shaders as `sv_media`.
-
-### Scenes, templates and the scene generator
-
-- **Scenes** store the whole look — background, visualizer, layers, logo and visual objects — under
- a name. Restore with one click, update from the current look, export and import as JSON.
-- **72 templates** in nine groups:
- - *Club (8)* — Strobe Wall, Hyper Tunnel, Laser Grid, Mandala Drop, Strobe Floor, Fireworks,
- MilkDrop Flow, Strange Attractor
- - *Ambient (9)* — Aurora, Ink in Water, Topography, Underwater, Embers, Liquid Metal, Night
- Globe, Flow Field, Interference
- - *Streaming (6)* — Corner Bars, Clean Wave, Ring Meter, Scope Overlay, Lower Third, Studio
- Meters
- - *Music Video (8)* — Label Card, Artwork Card, Baseline Bars, Amber Room, Minimal White, Quiet
- Frame, Corner Meter, Centre Strip
- - *Music (6)* — Chroma Wheel, Helix, Silk Ribbons, Strings, Spectrogram, Galaxy
- - *Screensaver (6)* — Plasma, Stained Glass, Circuit, Wire Tunnel, Dunes, Prism
- - *3D Geometry (8)* — Klein Bottle, Lorenz, Supershape, Trefoil Tube, Chladni, Rose Curve, Chua
- Circuit, Möbius
- - *Genre (16)* — Techno, House, Drum & Bass, Hip-Hop, Lo-Fi, Synthwave, Rock, Metal, Jazz,
- Classical, Ambient, Pop, Trance, Dubstep, Chiptune, Experimental
- - *Event (5)* — Minimal Line, Corporate, Gala, Festival, Projection Test
-- **Scene Generator** builds a scene from a description. It is **not** a neural network and is not
- presented as one: it reduces the text to four axes with a weighted keyword dictionary and seeds a
- deterministic generator from them. It runs entirely offline.
-- Scenes and colour palettes are **excluded** from the general settings backup and survive a backup
- import; each has its own export and import.
-
-### Logo, image and visual objects
-
-- **Logo** — an image placed anywhere in the frame, automatically sized, with size, opacity, glow,
- X/Y position and audio pulse. The logo file survives applying a template; only its placement
- changes.
-- **Visual objects** — image sprites in front of or behind the visualizer, with count, size, drift,
- rotation and audio response.
-
-### Audio
-
-- Capture **system output** (loopback), **microphones and input devices**, or several sources at
- once, mixed before analysis.
-- Output devices use WASAPI loopback on Windows and CoreAudio on macOS; on Linux the PulseAudio
- or PipeWire **monitor** source carries the same signal. Input devices are captured directly
- through the native `audify` module.
-- Sensitivity, smoothing and bass emphasis, with live meters for overall, bass, mid and treble.
-
-### Recording and video export
-
-- **Live recording** of the output exactly as it appears — with the live audio, modulation,
- transitions and effects — to MP4 or WebM.
-- **GIF export** with two-pass palette generation, because one pass bands visibly.
-- **PNG snapshot** at up to 4×, on a shortcut.
-- **Aspect-ratio presets** for common targets.
-- **Offline export** renders a selected audio file to MP4 with configurable resolution, frame rate,
- quality and encoder, with progress, cancellation and a GPU-to-CPU fallback. It is frame-exact and
- deterministic — the same property the visual regression tests rely on.
-
-### Aspect correction
-
-Corrects displays whose pixels are not square · draws the scene at the panel's real proportions
-instead of stretching the finished frame, so nothing is cropped or letterboxed · corrects
-background, visualizer, logo and text together · calibrated by eye with a circle, square or grid ·
-per screen or all screens · Windows, macOS and Linux.
-
-### Projection mapping
-
-Corner pin as a true homography · Catmull-Rom mesh warp · per-output crop · per-output colour
-correction · Bézier polygon masks · soft edge blending for multi-projector rigs · alignment grids,
-crosses, colour bars and focus rings · drag, arrow-key nudge and exact numeric entry.
-
-### Control surfaces
-
-- **MIDI** — learn a control, then map any CC or note to any setting or action.
-- **OSC** — a UDP listener with a hand-written OSC 1.0 parser.
-- **Art-Net / DMX** — ArtDMX output, packet layout tested byte by byte.
-- **Mobile remote** — scenes, templates and Studio presets from a phone, over the same server that
- hosts the OBS overlay.
-- **Tempo** — BPM estimation from a period histogram, tap tempo and a BPM lock.
-- **Auto VJ** — bar-aligned changes of scene, visualizer or palette. Pick exactly which ones
- cycle, or leave it empty for all; limit colour presets to built-in or your own; give each
- visualizer layer its own mode. A status line says what changed, what is next, and why nothing
- can happen when a source is empty.
-
-### Windows Dynamic Lighting
-
-- Off by default, and available only when compatible devices are detected.
-- Dynamic modes: visualizer colour flow, bar-spectrum mapping, advanced bass/mid/treble zones,
- background-light sync, synchronised beat flashes, frequency ripples, bar and background fusion,
- cross-device colour flow, rainbow flow, and threshold-triggered background bursts.
-- Threshold bursts watch exactly one chosen source (bass, mid, treble, overall level or the
- strongest band) and fire only after its threshold is crossed. Brightness scales with the amount
- above the threshold; the colour comes from the real current background pixels.
-- Band response can be instant/hard, punchy/hard or smooth/fluid, with configurable threshold,
- hardness, attack, release and band separation. Rainbow can run sequentially across LEDs or as one
- shared tone, and can react in brightness to a chosen band.
-- Manual modes: one colour across all devices, per-device colours, and per-LED or per-zone colours
- where the hardware exposes them.
-- Brightness, audio reactivity, smoothing, update rate, LED layout, palette source, per-band colours
- and sensitivity, flash threshold, strength and decay, ripple speed, direction and width, and
- colour spread are all independently configurable.
-- The installer registers the Windows background-lighting identity automatically. The portable build
- does not, and controls lighting only while the application is focused — use the installer when
- lighting must continue in the background, and place the application near the top of Windows
- **Dynamic Lighting → Background light control**.
-
-### RGB lighting everywhere else — OpenRGB
-
-Dynamic Lighting is a Windows service, so on macOS and Linux that card is replaced by a note saying
-as much. **OpenRGB** is the answer on those platforms, and an extra option on Windows:
-
-- Talks to a running **OpenRGB** server over its own protocol (TCP, port 6742 by default) — no
- vendor software, no driver, and the server may sit on another machine.
-- Drives every device OpenRGB exposes, per-LED where the hardware allows, using the **same modes and
- the same colour maths** as Windows Dynamic Lighting. Both paths share one renderer, so a scene
- looks the same through either.
-- Devices are listed with their LED counts, and one that will not take direct control says so
- instead of silently swallowing the colours.
-- Off by default, and only useful while the OpenRGB server is running — the panel reports the
- connection state rather than failing quietly.
-
-### Settings backup and restore
-
-- Export every application setting to a single JSON file: audio, visuals, Dynamic Lighting,
- performance, logo, visual objects, display selection and video export.
-- User-created **colour palettes and scenes** are deliberately excluded and survive an import; each
- has its own export and import.
-- Imported settings are merged with the current defaults, so newer fields stay valid. Files written
- by 1.3 and 2.0 load without losing a value, and a test proves it.
-
-### Two copies at once
-
-The development, installed and portable builds all keep their settings in one folder. Running two
-of them used to mean that whichever saved last silently replaced the other's settings.
-
-- **A second copy asks at start-up.** It names the copy that is already running — installed,
- portable or development, its version, when it started and where it lives — and offers to switch
- to it, which brings that copy's panel to the front, or to open anyway.
-- **While more than one copy runs, every copy's panel says so**, and the warning goes away when
- the other copy closes. A self-test running against the same folder is shown as a self-test.
-- **A copy never silently writes over settings someone else changed.** If `settings.json` no longer
- matches what this copy last read or wrote, it stops saving and asks: load the settings from disk,
- or save its own over them. That also covers older versions, which take no part in the start-up
- check, and hand edits of the file. Touching the file without changing it — a backup tool, or
- the self-test putting the same content back — does not count as a change.
-
-### Power and performance
-
-- **Frame rate** — *Match Display* (one frame per refresh, the smoothest) or a cap of 120, 60 or 30
- FPS. When a cap is not an exact divisor of the refresh rate — 60 on a 75 Hz screen, say — the
- long-run average stays correct but the intervals become uneven, so *Match Display* is
- recommended.
-- Background resolution scale, pause on silence, hide cursor.
-
-### Application settings (⚙ menu)
-
-- **Language** — automatic (system), Turkish or English.
-- **Keep visualization always on top** *(off by default)* — the visualization window re-raises
- itself whenever it loses focus.
-- **Extended setting ranges** *(off by default)* — raises the upper limit of the sliders 5×. A few
- settings genuinely bounded by the algorithm (smoothing, background resolution) are excluded.
- Turning it off again keeps any high values already entered.
-
----
-
-## What it is
-
-Four output paths, one engine:
-
-- **Admin panel** — the control screen where every setting is adjusted live.
-- **Visualization windows** — full-screen on *every* display you select.
-- **Streaming page** — a transparent overlay for OBS, plus a remote for your phone.
-- **Spout / Syphon** — the frame handed straight to another application on the GPU
- (Windows and macOS).
-
-Audio comes from **system output devices** (speaker or headphone loopback), **microphones and input
-devices**, or several sources at once, mixed before FFT analysis through the native `audify`
-module.
-
----
-
-## How audio capture works
-
-Capture runs in the **main process**, not in the browser window. The native module reads the chosen
-device — WASAPI loopback on Windows, CoreAudio on macOS, PulseAudio or PipeWire on Linux —
-computes the FFT, and sends frames to the renderer.
-
-- **System audio** is captured from the output device directly — no "stereo mix" required.
-- **Microphones and line inputs** are captured the same way.
-- **Several sources at once** are mixed before analysis.
-- **Both channels reach the visuals.** Each frame carries the left and right channels next to the
- mono mix the spectrum is computed from, so stereo width, correlation and the Goniometer measure the
- real stereo image. Until v3.1.5 the capture helper averaged the two channels away before anything
- else saw them: width sat at 0, correlation at 1, and the Goniometer drew a vertical line for every
- song. A mono device gives the same sample on both sides, which reads correctly as width 0.
-- On **macOS**, capturing system audio needs a virtual device such as **BlackHole**; microphones
- work directly. macOS has no loopback of its own, so there is no way around this.
-- On **Linux**, system audio is the PulseAudio or PipeWire **monitor** of your output device.
- It is an *input* device; the application marks it as loopback and prefers it by default.
-
----
-
-## Running in development
-
-```bash
-npm install
-```
-
-```bash
-npm start
-```
-
-Developer mode with DevTools open:
-
-```bash
-npm run dev
-```
-
-> If `npm install` fails with a certificate error behind a corporate proxy, try again with
-> `$env:NODE_OPTIONS="--use-system-ca"` in PowerShell.
-
-> **Node.js** is needed to run from **source**. Release packages are not: the audio helper runs
-> under Electron's own binary (`ELECTRON_RUN_AS_NODE`), so nothing has to be installed alongside
-> them on any of the three platforms.
-
----
-
-## Build / distribution
+## Building and distribution
```bash
npm run icons
@@ -1105,12 +1566,14 @@ npm run dist:linux
| macOS | `….dmg` and `….zip` (the `.app` inside) — Apple Silicon | macOS |
| Linux | `….AppImage` and `….deb` — x64 | Linux |
-**Every platform builds on itself.** `audify` is a native module and **cannot be cross-compiled**:
-a macOS package produced on Windows shows the interface but captures no audio. The GitHub Actions
+**Every platform builds on itself.** `audify` is a native module and **cannot be cross-compiled**: a
+macOS package produced on Windows shows the interface but captures no audio. The GitHub Actions
workflow therefore builds macOS on `macos-latest` and Linux on `ubuntu-latest`. Windows is built
locally instead of in CI, because the installer registers the Dynamic Lighting identity and that
needs a certificate the runner does not have — a CI-built installer would be a different product.
+### macOS first launch
+
**macOS packages are unsigned** and not notarised. macOS quarantines unsigned downloads and reports
them as *damaged and can’t be opened*; right-clicking and choosing **Open** does not clear that on
macOS 15 or later. Drag the app to Applications and remove the flag once:
@@ -1119,42 +1582,36 @@ macOS 15 or later. Drag the app to Applications and remove the flag once:
xattr -dr com.apple.quarantine "/Applications/CAYADEV Visualizer.app"
```
-It then opens normally every time. Capturing system audio there also needs a virtual device such
-as **BlackHole**.
+It then opens normally every time. Capturing system audio there also needs a virtual device such as
+**BlackHole**.
**Linux** needs PulseAudio or PipeWire. The `.deb` declares `libpulse0` among its dependencies; the
AppImage expects the same library to already be present.
### Publishing the files to a release
-The description next to each file in a release's asset list (`(Windows — installer)` and so on) is
-written by hand with `gh release upload file#label`, and in v3.1.3 it was forgotten — all six files
-went out unlabelled. The table now lives in a script:
+The description next to each file in a release's asset list is written with
+`gh release upload file#label`. The table lives in a script:
```bash
npm run release:assets -- v3.1.3 --dir=
```
-It looks for every expected file in `dist/` and in the folders given with `--dir` (nested one level,
-which is how `gh run download` lays artifacts out), refuses to upload anything unless all six are
-present, and re-reads the release afterwards to confirm each label was actually written. Add
-`--dry-run` to see what would be uploaded, `--check` to audit a release that is already published,
+It looks for every expected file in `dist/` and in the folders given with `--dir`, refuses to upload
+anything unless all of them are present, and re-reads the release afterwards to confirm each label
+was written. Add `--dry-run` to see what would be uploaded, `--check` to audit a published release,
and `--partial` when a partial upload really is intended.
----
+### Regenerating the screenshots
-## Usage
+```bash
+npm start -- --shots
+```
-1. Pick one or **several** displays from the **Displays** menu, then one or more **audio sources**.
-2. Click **▶ Open Visualizer** to start the full-screen visual on every selected display.
-3. Change anything on the right — it applies immediately and saves itself.
-4. For streaming, turn on **Output → Streaming Output** and paste the address into an OBS
- **Browser Source**.
-5. Go to **Studio** to write your own effect, or **Library → Templates** to start from a finished
- scene.
-6. Use **Video Export** to render an audio file to MP4 at a chosen resolution, frame rate and
- quality.
-7. Press **ESC** on any visualization window to close them all.
+Renders every panel, scene, clip and mode sheet on this page into `docs/screenshots/`, in English,
+from a synthetic signal. It never captures real audio, never opens the camera, never writes your
+settings, and uses typed-in track details rather than whatever is playing. `--only=` limits it
+to matching files.
---
@@ -1168,11 +1625,11 @@ npm test
npm start -- --smoke
```
-**1881 unit tests, all passing.** They are written to check answers, not to exercise lines:
+**2942 unit tests, all passing.** They are written to check answers, not to exercise lines:
- **Formulas** are checked against values derived by hand from their definitions — Viviani's curve
- staying on its sphere, the torus tube radius, Chladni's m↔n antisymmetry, every attractor
- staying bounded and landing inside the view volume.
+ staying on its sphere, the torus tube radius, Chladni's m↔n antisymmetry, every attractor staying
+ bounded and landing inside the view volume.
- **Tempo** is measured against synthetic signals of known BPM (90/120/128/140/174 →
89.8/120.4/127.9/140.0/173.7).
- **Analysis** is tested against signals with known answers: a known chord must come back as that
@@ -1180,10 +1637,31 @@ npm start -- --smoke
- **Art-Net** is verified byte by byte against the ArtDMX header.
- **Config migration** loads 1.3 and 2.0 settings files without losing a value.
- **Fuzzing** the preset and pack loaders asserts no MilkDrop preset can smuggle JavaScript.
+- **MCP coverage** fails when a new setting or feature is added without a matching tool or path rule.
+
+**The GPU self-test** runs the real application on a real GPU. It draws every registered visualizer
+mode and background and checks that each one builds its canvas and that shader-based modes compiled;
+measures that every effect and every 3D formula leaves a non-blank picture; compiles every built-in
+Studio shader; loses and restores the WebGL context of MilkDrop, the gradient background and the
+effect chain; loads the OBS overlay from the real stream server; switches the interface to English
+and scans for untranslated strings; and asserts that automation never opens the camera.
-**The GPU self-test** draws every registered mode, background, effect, shader, formula and
-transition on a real GPU and measures that the result is not blank. It then switches the interface
-to English and scans for untranslated strings, and asserts that automation never opens the camera.
+CI runs the unit tests on Windows and Ubuntu with Node 20 and 22 on every pull request.
+
+### Performance benchmark
+
+```bash
+npm run bench
+```
+
+The benchmark measures the frame time of every visualizer, background and post effect in the real
+visualizer page, with vsync on as in the app and the same synthetic audio every time. It never
+touches your settings or lights. `--soak=` adds a long switching run that samples the frame
+rate and the JavaScript heap each minute. On the reference laptop (Ryzen 9 8940HX, RTX 5070 Laptop,
+75 Hz), 136 of the 139 scenes that draw without user content hold the refresh rate (95% of 75 Hz)
+at 1920×1080; Wave Field (39 fps), Voronoi (63) and Wave Interference (71) do not. A 10-minute
+switching run stayed at 73–75 fps with a flat 6–8 MB heap. How it works, its options and the full
+tables are in [docs/BENCHMARKS.md](docs/BENCHMARKS.md).
---
@@ -1191,15 +1669,17 @@ to English and scans for untranslated strings, and asserts that automation never
```
src/
- main/ Electron main process: windows, audio capture, IPC, streaming server
+ main/ Electron main process: windows, audio capture, IPC, stream and MCP servers
admin/ Control panel
visualizer/ Output window: layer stack, modes, effects
exporter/ Offline, deterministic video export
shared/ Engines with no DOM: spectrum, modulation, analysis, formulas,
- transitions, warp, MilkDrop, templates, lyrics, solids
- web/ OBS overlay and the mobile remote
+ transitions, warp, MilkDrop, templates, lyrics, timeline, clip deck
+ web/ OBS overlay and the phone remote
+native/ Audio helpers (per-application capture, Dynamic Lighting identity)
+scripts/ Build, release, benchmark, MilkDrop corpus and render harnesses
tests/ Unit tests, run by `npm test`
-docs/ Roadmap, plan and screenshots
+docs/ Screenshots and benchmark results
```
Shared engines are plain arithmetic with no DOM, GPU or audio device, so their tests run in Node.
@@ -1215,27 +1695,34 @@ Shared engines are plain arithmetic with no DOM, GPU or audio device, so their t
| `Space` | Blackout |
| `Ctrl` + `S` | PNG snapshot |
| `Ctrl` + `R` | Start / stop recording |
+| `Ctrl` + `K` | Search all settings (panel) |
+| `Ctrl` + `Shift` + `Q` | Close the visualizer when the ESC lock is on |
+| `K` + two digits | Launch a MilkDrop sprite (visualizer window) |
+
+The timeline editor and the clip deck have their own shortcuts, listed in their panels.
---
## Roadmap
[ROADMAP.md](ROADMAP.md) records what has actually shipped and what each planned release is for —
-Timeline and Clip Deck in v3.1.0, cross-platform builds with OpenRGB and Spout/Syphon in v3.1.1,
-the MilkDrop shader engine in v3.1.2, per-application audio capture and aspect correction in
-v3.1.3, and the streaming overlay and transparency fixes with MilkDrop fidelity in v3.1.4. Next are
-MilkDrop and streaming refinements in v3.1.5, a far broader and much faster video export in v3.1.6,
-the broadcast layout editor in v3.1.7 and redundancy with frame sync in v3.2.0. It also keeps an
-honest list of what is *not* done, and why.
+Timeline and Clip Deck in v3.1.0, cross-platform builds with OpenRGB and Spout/Syphon in v3.1.1, the
+MilkDrop shader engine in v3.1.2, per-application audio capture and aspect correction in v3.1.3, and
+the streaming overlay and transparency fixes with MilkDrop fidelity in v3.1.4. Next are MilkDrop and
+streaming refinements in v3.1.5, a far broader and much faster video export in v3.1.6, the broadcast
+layout editor in v3.1.7 and redundancy with frame sync in v3.2.0. It also keeps an honest list of
+what is *not* done, and why.
---
## License
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](LICENSE). Copyright (c) 2026 Çağan Turgut ([CaYatur](https://github.com/CaYatur)) — CaYaDev.
-
+
# CAYADEV Visualizer
-### Sahip olduğunuz her ekran için sese tepki veren görseller
+### Sahip olduğunuz her ekran için ücretsiz, açık kaynak müzik görselleştirici ve VJ yazılımı
-**Windows** · **macOS** · **Linux** · Electron + WebGL2 · Yerel WASAPI / CoreAudio / PulseAudio yakalama
+Bilgisayarınızda ne çalıyorsa — Spotify, YouTube, bir DAW, bir DJ seti, bir oyun — bir ekranda ya
+da on ekranda sese tepki veren görsellere dönüştürür. Gerçek bir **MilkDrop** motoru, **60
+görselleştirici modu**, katmanlar ve **40 GPU efekti**, bir **OBS katmanı**, **Spout / Syphon**,
+**projeksiyon haritalama**, **RGB aydınlatma**, canlı gösteriler için **zaman çizelgesi ve klip
+destesi**, ve **MCP üzerinden yapay zekâ kontrolü**.
+**Windows** · **macOS** · **Linux** — hesap yok, telemetri yok, MIT lisanslı.
+
+[](https://github.com/CaYatur/SoundVisualizer/releases/latest)
+[](https://github.com/CaYatur/SoundVisualizer/releases)
[](LICENSE)
-[](#paketleme--dağıtım)
+[](#hızlı-başlangıç)
+[](#testler)
[](https://www.electronjs.org/)
-[](#testler)
-[](https://cayadev.com)
+
+
+
+
+
+**[Kaynaktan çalıştır](#kaynaktan-çalıştırma)** ·
+**[Özellikler](#tüm-özellikler-ayrıntısıyla)** ·
+**[SSS](#sss)** ·
+**[English](README.md)**
+
+
+---
+
+## Bir bakışta
+
-| | |
-|:---:|:---:|
-|  |  |
-|  |  |
-|  |  |
+| **60** görselleştirici modu | **43** arkaplan | **40** GPU efekti | **18** sahne geçişi |
+|:---:|:---:|:---:|:---:|
+| **81** hazır sahne | **98** formül + **13** 3B katı cisim | **42** yerleşik GLSL shader | **58** renk paleti |
+| **10.347** MilkDrop presetiyle sınandı | Yapay zekâ ajanları için **96** MCP aracı | **17** katman karışım kipi | **2** dil (TR / EN) |
+> **Sürüm etiketleri hakkında.** Güncel sürüm **v3.1.4**. Bu sayfadaki her şey `main` dalındaki
+> kaynakta var; 3.1.5 ile işaretlenenler bir sonraki sürümle, v3.1.5 ile geliyor ve
+> v3.1.4 indirmesinde henüz yok. Bugün kullanmak için kaynaktan çalıştırın.
+
+---
+
+## Neden CAYADEV Visualizer
+
+- **Windows'ta Stereo Mix yok, sanal kablo yok.** Sistem sesi doğrudan hoparlörden ya da
+ kulaklıktan yakalanıyor (WASAPI loopback), mikrofon ve hat girişleriyle birlikte — ya da **tek bir
+ uygulamadan**: görseller Spotify'ı izler, oyunu ve sesli sohbeti duymaz.
+ [→ Ses](#ses-yakalama-ve-çözümleme)
+- **Her ekran, tek motor.** Seçtiğiniz her ekranda tam ekran pencere, saydam bir **OBS tarayıcı
+ kaynağı**, Resolume, TouchDesigner ve MadMapper için **Spout / Syphon**, ve bir **telefon
+ kumandası** — hepsi aynı görüntüyü çiziyor. [→ Çıkışlar](#çıkışlar-ekranlar-obs-spout-ve-syphon)
+- **Presetlerinizi gerçekten çalıştıran MilkDrop.** Kare ve piksel denklemleri, warp ağı, GLSL'e
+ çevrilen HLSL shader'lar; **10.347 gerçek presetle** ve kare kare bir MilkDrop 2 başvuru
+ çizicisiyle ölçüldü. Bütün kütüphaneleri içe aktarın, küçük resimlerle gezin, presetleri canlı
+ düzenleyin ya da yenilerini üretin 3.1.5. [→ MilkDrop](#milkdrop)
+- **Tek bir efekt değil, bir birleştirici.** Sınırsız katman, 17 karışım kipi, maskeler, A/B
+ geçiş sürgüsü, katman başına ya da tüm kareye 40 GPU efekti, ve LFO'ları, zarfları ve canlı ses
+ çözümlemesini herhangi bir ayara yönlendiren bir modülasyon matrisi.
+ [→ Katmanlar](#katmanlar-maskeler-ve-efektler)
+- **Canlı gösteri için yapıldı.** Otomasyon şeritli bir **zaman çizelgesi**, vuruşa hizalı
+ ateşlenen bir **klip destesi**, sahneleri ölçüde değiştiren **Otomatik VJ**, tap tempo, **MIDI** ve
+ **OSC**. [→ Gösteri kontrolü](#gösteri-kontrolü-zaman-çizelgesi-klip-destesi-otomatik-vj-midi-ve-osc)
+- **Sahneye hazır.** Köşe sabitleme, ağ bükme ve çok projektörlü kurulumlar için yumuşak kenar
+ harmanlamalı projeksiyon haritalama; pikselleri kare olmayan LED duvarlar için **basıklık
+ düzeltme**. [→ Sahne](#sahne-projeksiyon-haritalama-ve-basıklık-düzeltme)
+- **Işıklarınız müziği izler.** **Windows Dynamic Lighting**, her platformda **OpenRGB** ve **Art-Net /
+ DMX**, hepsi tek bir çiziciyle — renklerini MilkDrop görüntüsünden bile alabilirler
+ 3.1.5. [→ Aydınlatma](#rgb-aydınlatma-dynamic-lighting-openrgb-ve-art-net)
+- **İçerik üreticileri için.** Bir ses dosyasından kare kare **çevrimdışı video dışa aktarma**, tek
+ tuşla kayıt, müzik videosu düzenleri, albüm kapaklı bir **Çalan Parça** katmanı ve zamanlı **şarkı
+ sözleri** (LRC / SRT). [→ Dışa aktarma](#kayıt-ve-video-dışa-aktarma)
+- **Yapay zekâya hazır.** 96 araçlı yerel bir **MCP sunucusu**; Claude, Codex, Cursor ve diğer
+ ajanlar gösteriyi okur, sahne kurar ve çıkışları yönetir — beş izin düzeyinin ardında, yalnız
+ `127.0.0.1` üzerinde 3.1.5. [→ MCP](#mcp--bir-yapay-zekâ-ajanıyla-kontrol)
+- **Gizli ve çevrimdışı.** Hesap yok, telemetri yok, bulut yok. Uygulamanın kendiliğinden yaptığı
+ tek çağrı GitHub'ın son sürüm denetimi; onu da kapatabilirsiniz.
+ [→ Gizlilik](#gizlilik-ve-güvenlik)
+
---
-## Hareket halinde
+## Galeri
+
+### Klasik görünüşler
+
+Uygulamanın ilk günden beri sunduğu tayf barları, dalgalar ve halkalar — müzikle akan degrade
+arkaplanlar üzerinde, hâlâ tek tıkla.
+
+
+
+| Katmanlı sahne | Frekans barları | Çember |
+|:---:|:---:|:---:|
+|  |  |  |
+| **Aynalı barlar** | **Dalga** | **Gün batımı dalgası** |
+|  |  |  |
-> Bu sayfadaki her görsel ve klip `npm start -- --shots` ile, 120 BPM'lik sentetik bir sinyalle
-> üretiliyor. Gerçek seste müziği takip ederler.
+> Bu sayfadaki her görüntü ve klip uygulamanın kendisi tarafından `npm start -- --shots` ile, 120
+> BPM'lik sentetik bir sinyalle çiziliyor. Gerçek seste görseller müziği izler.
---
-## Müzik videosu düzenleri
+## Hızlı başlangıç
+
+### İndir
-Şarkı videoları ve resmî kanallar için sade düzenler — kulüp ve VJ malzemesinden bilinçli olarak
-ayrı tutuldu.
+Son derlemeyi **[Sürümler](https://github.com/CaYatur/SoundVisualizer/releases/latest)** sayfasından alın.
+
+| Platform | Dosya | Not |
+|---|---|---|
+| **Windows 10 / 11** | `…-windows-setup.exe` | Önerilen. Işıklar arka planda da çalışsın diye Dynamic Lighting kimliğini kaydeder ve kendini güncelleyebilir. |
+| Windows, taşınabilir | `…-windows-portable.exe` | Kurulum yok. Dynamic Lighting yalnız uygulama odaktayken çalışır. |
+| **macOS** (Apple Silicon) | `…-macos-arm64.dmg` / `.zip` | İmzasız — bkz. [macOS'ta ilk açılış](#macosta-ilk-açılış). Sistem sesi için BlackHole gibi sanal bir aygıt gerekir. |
+| **Linux** (x64) | `…-linux-x86_64.AppImage` / `…-linux-amd64.deb` | PulseAudio ya da PipeWire gerekir. AppImage kendini güncelleyebilir 3.1.5. |
+
+Başka hiçbir şey kurmanız gerekmiyor: ses yardımcısı uygulamanın kendi ikili dosyasıyla çalışıyor.
+
+### İlk çalıştırma
+
+1. Üstteki **Ekranlar** menüsünden bir ya da **birkaç** ekran, sonra **Ses** altında bir ya da daha
+ fazla **ses kaynağı** seçin.
+2. **Görselleştirmeyi Aç**'a tıklayın. Görüntü seçili her ekranda tam ekran açılır.
+3. Sağdaki her şeyi değiştirin — anında uygulanır ve kendini kaydeder.
+4. Ya da hazır bir görünümden başlayın: **Kitaplık → Hazır Şablonlar**'da 81 tane var.
+5. Yayın için **Çıkış → Yayın Çıkışı**'nı açın ve adresi bir OBS **Tarayıcı Kaynağı**na yapıştırın.
+6. Tüm pencereleri kapatmak için herhangi bir görselleştirme penceresinde **ESC**'ye basın.
+
+### Kaynaktan çalıştırma
+
+**[Node.js](https://nodejs.org/) 20 ya da üstü** (CI 20 ve 22'yi sınıyor) ve Git gerekir.
+
+```bash
+git clone https://github.com/CaYatur/SoundVisualizer.git
+cd SoundVisualizer
+npm install
+npm start
+```
+
+`npm install`, yerel `audify` ses modülünü Electron için kendiliğinden yeniden derler
+(`postinstall`). Ses yardımcısı `INVALID_HELPER_OUTPUT` derse `npm run rebuild:audio`, ardından
+`npm run check:runtime` çalıştırın. Sertifikaları bozan bir kurumsal vekil sunucunun arkasındaysanız
+`npm install`'dan önce `NODE_OPTIONS=--use-system-ca` verin. DevTools açık geliştirici kipi:
+`npm run dev`.
+
+---
+
+## Kimin için
+
+| Siz… | Elde ettiğiniz |
+|---|---|
+| **Yayıncıysanız** | OBS'e tarayıcı kaynağı olarak saydam bir katman, albüm kapaklı Çalan Parça kartı, şarkı sözleri ve yayının ortasında sahne değiştirmek için bir telefon kumandası. OBS başka bir bilgisayardayken de çalışır. |
+| **VJ ya da sahne sanatçısıysanız** | Zaman çizelgesi, vuruşa hizalı ateşlenen klip destesi, ölçüde Otomatik VJ, MIDI ve OSC kontrolü, karartma, Resolume ya da TouchDesigner'a Spout/Syphon, ve her projektörde tam ekran çıkış. |
+| **Müzik yapımcısı ya da plak şirketiyseniz** | Parçanızdan kare kare video dışa aktarma, logonuz ve parça adıyla sekiz sade müzik videosu düzeni, ve canlı çıkış için bir kayıt aracı. |
+| **Mekân, etkinlik ya da enstalasyonsanız** | Projeksiyon haritalama, kenar harmanlama, LED duvarlar için basıklık düzeltme, kaza koruması, çökme kurtarma ve gösterinin ortasında asla uyumayan bir ekran. |
+| **RGB ya da ortam ışığı meraklısıysanız** | Müzikle sürülen Windows Dynamic Lighting, OpenRGB ve Art-Net/DMX; arka plan görselleri için ekran koruyucu tadında bir şablon grubu. |
+| **MilkDrop hayranıysanız** | `.milk` ve `.milk2` yükleyen, bütün kütüphaneleri içe aktaran, küçük resim gösteren, favori, puan ve etiket tutan, presetleri düzenleyip üretmenizi sağlayan bir MilkDrop motoru. |
+| **Geliştirici ya da yapay zekâ meraklısıysanız** | Shadertoy ve ISF içe aktarmalı bir GLSL düzenleyici, 96 araçlı bir MCP sunucusu, belgelenmiş bir yapılandırma ve satır değil cevap denetleyen 2.700'ü aşkın test. |
+
+---
+
+## Tüm özellikler, ayrıntısıyla
+
+Yukarısı kısa sürümdü. Aşağısı, kategori kategori tam liste.
+
+- [Ses yakalama ve çözümleme](#ses-yakalama-ve-çözümleme)
+- [Görselleştirici modları ve arkaplanlar](#görselleştirici-modları-ve-arkaplanlar)
+- [MilkDrop](#milkdrop)
+- [Katmanlar, maskeler ve efektler](#katmanlar-maskeler-ve-efektler)
+- [Modülasyon](#modülasyon)
+- [3B geometri ve formüller](#3b-geometri-ve-formüller)
+- [Studio — kendi shader'ınızı yazın](#studio--kendi-shaderınızı-yazın)
+- [Sahneler, şablonlar, geçişler ve renk](#sahneler-şablonlar-geçişler-ve-renk)
+- [Metin, şarkı sözü ve Çalan Parça](#metin-şarkı-sözü-ve-çalan-parça)
+- [Logo, görseller ve medya katmanı](#logo-görseller-ve-medya-katmanı)
+- [Gösteri kontrolü: zaman çizelgesi, klip destesi, Otomatik VJ, MIDI ve OSC](#gösteri-kontrolü-zaman-çizelgesi-klip-destesi-otomatik-vj-midi-ve-osc)
+- [Çıkışlar: ekranlar, OBS, Spout ve Syphon](#çıkışlar-ekranlar-obs-spout-ve-syphon)
+- [Sahne: projeksiyon haritalama ve basıklık düzeltme](#sahne-projeksiyon-haritalama-ve-basıklık-düzeltme)
+- [RGB aydınlatma: Dynamic Lighting, OpenRGB ve Art-Net](#rgb-aydınlatma-dynamic-lighting-openrgb-ve-art-net)
+- [Kayıt ve video dışa aktarma](#kayıt-ve-video-dışa-aktarma)
+- [MCP — bir yapay zekâ ajanıyla kontrol](#mcp--bir-yapay-zekâ-ajanıyla-kontrol)
+- [Yönetici paneli](#yönetici-paneli)
+- [Güvenilirlik, güç ve güncellemeler](#güvenilirlik-güç-ve-güncellemeler)
+- [Gizlilik ve güvenlik](#gizlilik-ve-güvenlik)
+
+---
+
+### Ses yakalama ve çözümleme
-- **Sekiz hazır düzen** — Label Card, Artwork Card, Baseline Bars, Amber Room, Minimal White,
- Quiet Frame, Corner Meter, Centre Strip.
-- **Bar yerleşimi** — genişlik, yatay konum, yükseklik ve taban çizgisi; her biri kadranın oranı
- olarak. Bloğu köşeye, ortaya ya da ince bir şerit olarak koyun.
-- **Logo barların arkasında değil yanında**, hemen yanında parça ve sanatçı adı.
-- **Parça bilgisi** çalan parça alanlarından gelir; başlık ve sanatçı ayrı katmanlar olarak, kendi
- boyut ve kalınlıklarıyla çizilebilir.
-- **Arkada sabit bir görsel ya da sakin bir video**, palet sisteminin tamamı kullanılabilir.
+**Kaynaklar**
+
+- **Sistem çıkışı** — hoparlör ya da kulaklık loopback'i. "Stereo Mix" gerekmez.
+- **Mikrofonlar ve hat girişleri**, aynı yoldan yakalanır.
+- **Tek tek uygulamalar** (Windows) — WASAPI süreç loopback'i. Yalnız seçilen uygulamaları ya da bir
+ uygulama *dışındaki* her şeyi yakalayın. Hedefler çalıştırılabilir dosya adıyla saklanır: yeniden
+ başlayan bir uygulama kendiliğinden yeniden bağlanır, henüz açılmamış bir uygulama açılınca
+ yakalanır. Windows 20348 ya da üstü gerekir. macOS ve Linux burada neden henüz olmadığını söyler.
+- **Aynı anda birkaç kaynak**, çözümlemeden önce karıştırılır — "Spotify + mikrofon" tek bir seçimdir.
+- **İki kanal da görsellere ulaşıyor** 3.1.5. Her kare tek kanallı karışımın yanında sol ve
+ sağ kanalı da taşıyor; stereo genişlik, korelasyon ve Gonyometre gerçek stereo görüntüyü ölçüyor.
+ v3.1.5'e kadar yakalama yardımcısı iki kanalın ortalamasını alıyordu: genişlik 0'da, korelasyon
+ 1'de kalıyor, Gonyometre her şarkıda dikey bir çizgi çiziyordu.
+- **Kendini toparlıyor** 3.1.5. Yakalama yardımcısı kapanırsa ya da kareleri durursa
+ (uykudan dönüş, çıkarılan bir aygıt) yakalama giderek uzayan aralıklarla yeniden kurulur ve panel
+ yakalıyormuş gibi yapmak yerine "yeniden bağlanıyor" der. Takılıp çıkan bir aygıt sıkı bir döngüde
+ denenmez.
+- **Hassasiyet, yumuşatma ve bas vurgusu**, 50/60 Hz şebeke uğultusu koruması, ve genel, bas, orta ve
+ tiz için canlı ölçerler.
+
+**Yakalama nasıl çalışıyor.** Yakalama tarayıcı penceresinde değil **ana süreçte** çalışıyor. Bir
+yardımcı aygıtı okuyor — Windows'ta WASAPI loopback, macOS'ta CoreAudio, Linux'ta PulseAudio ya da
+PipeWire — FFT'yi hesaplıyor ve kareleri her çiziciye gönderiyor.
+
+- **macOS**'ta sistem sesi için **BlackHole** gibi sanal bir aygıt gerekir; mikrofonlar doğrudan
+ çalışır. macOS'un kendi loopback'i yok, dolayısıyla başka yolu da yok.
+- **Linux**'ta sistem sesi, çıkış aygıtınızın PulseAudio ya da PipeWire **monitor** kaynağıdır. Bu bir
+ *giriş* aygıtıdır; uygulama onu loopback olarak işaretler ve varsayılan olarak tercih eder.
+
+**Tayf ölçümü.** Barlar tahmin edilmiyor, ölçülüyor.
+
+- **Frekans ölçeği** — logaritmik, doğrusal, mel ya da bark.
+- **Genlik ölçeği** — doğrusal ya da desibel; taban −24 ile −96 dB arasında ayarlanabilir. Sessiz
+ ayrıntıyı tabana yapışık değil görünür kılan dB'dir.
+- **Balistik** — ayrı yükselme ve bırakma; barlar hızla çıkar, yumuşakça iner. Kare hızından bağımsız.
+- **Komşu yayılması** (tepeleri düzleştirmeden genişletir) ve **profil yumuşatma** (simetrik komşu
+ ortalaması).
+- Oktav başına dB cinsinden **tayf eğimi**, 1 kHz'de nötr; üst uç hep ölü kalmasın diye.
+- Bir FFT kutusundan dar bantlar bandın merkez frekansında ara değerlendiriliyor; komşu barlar tek bir
+ kutuyu paylaşmak yerine kendi değerlerini okuyor. Motoru 27 test kapsıyor, bar profilinde basamak
+ olmadığını doğrulayan bir test dahil.
+
+**Derin çözümleme.** Her ölçümün canlı bir ölçeri var ve her biri modülasyon kaynağı olarak
+kullanılabiliyor.
+
+- Sabit-Q kroma vektöründen **müzikal ton ve akor** — FFT kutuları yerine bir Goertzel filtre
+ bankası, çünkü 2048 örnekte bas bölgesi kutularla ayrıştırılamıyor — Krumhansl-Schmuckler ton
+ profilleri ve akor şablonlarıyla.
+- YIN ile **perde izleme**.
+- **Harmonik / vurmalı ayrıştırma**, ve kick, snare ve hi-hat için bant başına vuruş algılayıcıları.
+- **Tayf tanımlayıcıları** — ağırlık merkezi, rolloff, düzlük, crest.
+- **Ses yüksekliği, dinamik, gerçek tepe, stereo genişlik, korelasyon ve orta/yan bantlar.**
+- Sessizlik algılama, otomatik kazanç ve kayan bir tayf geçmişi tamponu.
+
+**Tempo.** BPM bir periyot histogramından tahmin ediliyor (90, 120, 128, 140 ve 174 BPM'lik
+sinyallere karşı ±0,5 BPM'e kadar sınandı); tap tempo ve Otomatik VJ, klip destesi ve MilkDrop'un
+paylaştığı bir BPM kilidiyle.
---
-## Tayf ölçümü
+### Görselleştirici modları ve arkaplanlar
-Barlar tahmin edilmiyor, ölçülüyor. Dört frekans ölçeği, desibel genlik ölçeği ve gerçek balistik.
+
-- **Frekans ölçeği** — logaritmik, doğrusal, mel ya da bark.
-- **Genlik ölçeği** — doğrusal ya da desibel, ayarlanabilir tabanla. Müziğin sessiz ayrıntısını
- taban çizgisine yapışmaktan kurtaran şey dB'dir.
-- **Balistik** — ayrı atak ve bırakma; barlar hızlı fırlar, yavaş iner. Kare hızından bağımsız.
-- **Komşu yayılımı** — tepeleri ezmeden genişletir.
-- **Profil yumuşatma** — daha yumuşak bir zarf için simetrik komşu ortalaması.
-- **Eğim** — oktav başına dB, böylece tiz uç kalıcı olarak ezik kalmaz.
+**60 görselleştirici modunun hepsi**
-Bir FFT kutusundan dar olan bantlar, bandın merkez frekansında interpole edilir; böylece komşu
-barlar aynı kutuyu paylaşmak yerine kendi değerlerini okur. Motoru 27 test kapsıyor; biri bar
-profilinde basamak olmadığını doğruluyor.
+
+
+**43 arkaplanın hepsi**
+
+
+
+
+
+Bu iki pafta doğrudan mod kataloğundan üretiliyor; yeni bir mod, ekran görüntüleri bir sonraki
+çizilişinde kendiliğinden içlerine giriyor. (Paftalar uluslararası okuyucu için İngilizce adlarla.)
+Her görselleştirici her arkaplanın üzerinde durabilir; katmanlarla her birinden istediğiniz kadar
+üst üste koyabilirsiniz. v3.1.4'ten sonra eklenen modlar 3.1.5'in parçası.
+
+**Görselleştirici modları — 60**
+
+- **Temel** — Barlar · Merkez · Segment (LED ekolayzer) · Nokta Matris · Şehir Silüeti (pencereleri
+ yanan binalar)
+- **Dalga formu** — Dalga (osiloskop) · Şerit (dalga geçmişi) · 3B Dalga (perspektifte yığılmış geçmiş)
+ · Lissajous (XY osiloskop) · Teller (her tel kendi bandıyla titrer) · Arazi (perspektif tel kafes
+ manzara) · Sırt Çizgileri · DJ Dalga Formu
+- **Dairesel** — Çember · Dairesel Dalga · Işın · Yaylar (bant başına bir yay) · Fırıldak · Mandala
+ (kutupsal gül eğrisi) · Kaleydoskop · Girdap · Helis · Tünel · Küre · Radar Grafiği
+- **Parçacık ve olay** — Parçacık · Havai Fişek (vuruşta patlamalar) · Şimşek (basta dallanan
+ yıldırımlar) · Baloncuk · Sıvı Damla (metatoplar) · Dalgalı Izgara (vuruşta yayılan halkalar) ·
+ Spektrogram · Konfeti · Vuruş Pedleri · Zıplayan Toplar · Stereo İzler (her bant stereo görüntüdeki
+ yerinden fırlar)
+- **Üretken sistemler** — Akış Alanı (gürültü alanının yönlendirdiği parçacıklar) · Sürü (tayfın sürdüğü
+ boid'ler) · Voronoi · Truchet · Moiré · Dalga Girişimi · İpler (vuruşlarla itilen verlet fiziği) ·
+ Galaksi · DNA Sarmalı · İzometrik Şehir · Çekici Alanı (formül kitaplığından iki parametresi sese
+ bağlı ayrık haritalar) · Sarkaç Dalgası · Kardioid
+- **Metin** — Metin / Şarkı Sözü · Çalan Parça
+- **Ölçüm** — Osiloskop (XY) · Gonyometre (stereo faz ölçer) · Kroma Çemberi (beşli çember sırasında
+ perde sınıfları, algılanan akorun kökü vurgulu) · VU Metre · Seviye Ölçer (PPM)
+- **Gelişmiş motorlar** — 3B Geometri · MilkDrop · Geri Besleme (klasik sonsuz tünel görünümü) · Studio
+ (kendi GLSL shader'ınız)
+
+Bar sayısı, en düşük ve en yüksek frekans, aralık, yerleşim (alt, orta ya da tam), ayna, çizgi
+kalınlığı, genlik, hassasiyet ve parlama, seçili mod için anlamlı olduklarında görünüyor. Renk sahne
+paletinden, özel bir renk çiftinden ya da **gökkuşağından** geliyor.
+
+**Arkaplanlar — 43**
+
+- **Akışkan** — Akışkan Gradyan (akış, dolanma, yörünge, girdap, bükülme, gren ve ses tonu kaymasıyla
+ sese tepki veren bir ağ degradesi) · Mürekkep (aktıkça dönen sıvı lekeler) · Bulutsu (yumuşak gaz
+ bulutları) · Dalga Katmanları (sesle kabaran dalga tepeleri) · Kutup Işıkları (dalgalanan perdeler)
+ · Lav Lambası · Su Altı
+- **Geometrik** — Retro Izgara (ufka uzanan perspektif ızgara) · Petek Izgara (merkezden yayılan bir
+ dalga ve tayfla yanan hücreler) · Mozaik (frekans bandı başına bir hücre) · Koridor (size doğru
+ gelen halkalar ya da çokgenler) · Sarmal · Nabız Halkaları (bas vuruşlarında ek halkalar) · Ağ
+ (sürüklenen bağlı düğümler) · Alçak Poligon · Yarım Ton · İzometrik Küpler
+- **Atmosfer** — Yıldız Alanı · Kar / Kor · Işık Parçacıkları (bokeh) · Dijital Yağmur · Şehir
+ (pencereleri müzikle yanan paralaks silüet) · Bulutlar · Sahne Işıkları · Ateş Böcekleri · Fırtına
+- **Üretken zeminler** — Sıvı Metal · Plazma · Su Yüzeyi · Şeritler · Eşyükselti · Dalga Alanı ·
+ Kıvılcım · Kum · Vitray · Devre Kartı · Prizma · Küre Ağı · Tel Tüneli · Petek Nabzı · Ayna Deseni
+- **Diğer** — Düz Renk · Studio (kendi yazdığınız GLSL shader)
+
+**Şeffaf arkaplan.** **Arkaplan → Şeffaf Arkaplan**'ı açın; masaüstü görselleştirici penceresinin
+arkasından görünür: düz renk boyanmaz, bir arkaplan efektinin karanlık kısımları **Saydamlık Eşiği**
+altında saydamlaşır. Saydamlık efekt zincirinden de geçer: bloom ve bulanıklık, pencereyi siyah bir
+dikdörtgene çevirmeden boş piksellerin üzerinde parlar.
---
-## Yönetici paneli
+### MilkDrop
-- **Yedi kategori** — Sahne, Ses, Işık, Çıkış, Kontrol, Studio, Kitaplık.
-- **Her şey canlı** — her değişiklik çıkış pencerelerine anında gider ve kendini kaydeder.
-- **Değişiklik rozetleri** her kartta ve kategoride; bölümü ya da kategorinin tamamını varsayılana
- döndürme düğmesiyle.
-- **Arama** her kategorideki her ayarda.
-- **Türkçe ve İngilizce**, çalışırken değişir; arayüzde çevrilmemiş tek bir metin kalırsa öz test
- başarısız olur.
+Bu uygulama için yazılmış bir MilkDrop motoru — projectM'in ya da MilkDrop'un kodunu içermiyor. Preset
+dili gerçekten çalışıyor: bir sözcük çözümleyici, bir ayrıştırıcı ve JavaScript kapanışlarına
+derleme; `per_frame` ve `per_pixel` denklemleri geri beslemeli bir warp ağını sürüyor; HLSL warp ve
+composite shader'ları GLSL'e çevrilip GPU'da çalışıyor.
+
+- **İddia değil, ölçüm.** projectM'in özgün ve cream-of-the-crop paketlerinden 10.347 presetlik bir
+ derlemde her preset yükleniyor ve çalışıyor, 16.346 shader aşamasının hepsi derleniyor ve yaklaşık
+ %98'i canlı bir görüntü veriyor. Uyum, BeatDrop'un MilkDrop 2 kaynaklarından kurulmuş bir başvuru
+ çiziciye karşı kare kare denetleniyor. İki ölçüm aracı da `scripts/` altında; sayılar yeniden
+ üretilebilir.
+- **MilkDrop Uyumu anahtarı** MilkDrop 2'nin kendi kurallarını izliyor — derleyicisini, ses zincirini,
+ ağ dönüşümünü, varsayılan değerlerini ve sabit işlevli boru hattını. Ayrıntılar bu sayfanın sonundaki
+ [MilkDrop motoru notları](#milkdrop-motoru-notları) bölümünde.
+- **Uygulama kendi beş presetiyle geliyor** — *Kutup Işığı*, *Erimiş Altın*, *Dingin Halkalar*,
+ *Sonsuz Tünel* ve *Nabız Örgüsü* — böylece motor, siz hiçbir şey içe aktarmadan ne yaptığını
+ gösteriyor. Üçüncü taraf preset paketi gelmiyor.
+- **Bütün bir kütüphaneyi içe aktarın** 3.1.5 — bir ZIP paketinden, bir klasörden ya da bu
+ bilgisayarı arayarak (Winamp, foobar2000 ve projectM klasörleri, İndirilenler, Masaüstü, Müzik,
+ Belgeler). Bir şey kopyalanmadan önce ne ekleneceğini görüyorsunuz; aynıları atlanıyor; dokular da
+ geliyor; klasör adları etikete dönüşebiliyor. 9.795 presetlik bir klasör yaklaşık altı saniyede içe
+ aktarılıyor.
+- **`.milk` ve `.milk2`** 3.1.5 — MilkDrop 3'ün çift presetleri iki presetlerinin donmuş bir
+ karışımı olarak yükleniyor; *Preset Biçimi* ayarı dosyaları MilkDrop 2 ya da MilkDrop 3 kurallarıyla
+ (16 özel dalga ve şekil, `q1`–`q64`) okuyor ya da kendisi seçiyor.
+- **Küçük resimler** 3.1.5 — *Izgara* düzeninde her preset küçük bir resim olarak görünüyor;
+ arka planda bir kez çiziliyor, yalnız preset ya da kullandığı bir doku değişince yeniden çiziliyor.
+- **Favoriler, etiketler, puanlar ve yazara göre arama** 3.1.5 — `yazar:geiss` Geiss'in
+ presetlerini, `#sakin` bir etiketi buluyor; rastgele sıra MilkDrop'un yaptığı gibi puana göre
+ ağırlıklanıyor; Önceki ve Sonraki gerçekten gösterilenlerin 64 adımlık geçmişinde yürüyor.
+- **Canlı düzenleyici** 3.1.5 — kare ve piksel denklemleri, dalgalar, şekiller, warp ve
+ composite shader'ları ayrı sekmelerde; yazmayı bıraktıktan bir an sonra değişiklik çalışan görüntüde;
+ hatalar presetin kendi satırını gösteriyor. Özgün dosya hiç değişmiyor.
+- **Preset üretici ve karışımlar** 3.1.5 — dört sürgüden (enerji, sıcaklık, yoğunluk,
+ hareket) ve aynı preseti geri getiren bir tohumdan özgün bir preset yazın, ya da elinizdeki
+ presetlerin parçalarından bir tane kurun. Üretilen presetler asla çakmıyor.
+- **Gösteri kontrolü** 3.1.5 — saniyeyle ya da **ölçüde** otomatik geçiş, yüksek anlarda sert
+ geçiş, *parça değişince sıradaki preset*, bir kilit, ve MIDI ile OSC'de MilkDrop eylemleri. Her ekran
+ aynı tohumla aynı preseti gösteriyor.
+- **Kullanıcı dokuları ve sprite'lar** 3.1.5 — bir MilkDrop `textures` klasörünü gösterin;
+ `milk_img.ini` sprite'larını MilkDrop'un kendi tuşlarıyla ya da bir denetleyiciden başlatın.
+- **İzlemesi güvenli** 3.1.5 — WCAG 2.3.1'in genel flaş değerinde flaş sınırlama, saniye
+ başına tutuluyor, yani 144 Hz bir ekran 30 fps'lik bir ekran kadar güvenli; sistemin *hareketi
+ azalt* ayarına uyuluyor.
+- **GPU sıfırlamasından sağ çıkıyor** 3.1.5 — kaybolan bir WebGL bağlamı aynı tuvalde
+ yeniden kuruluyor ve çalışan preset aynı denklem durumu ve saatle kaldığı yerden devam ediyor.
+
+**Geri Besleme** motoru, MilkDrop'un presetsiz akrabası: yakınlaşma, dönüş, bükülme ve sönme
+sürgüleri, dört dalga biçimi, ve klasik sonsuz tünel için basla sürülen yakınlaşma ve dönüş.
---
-## Katmanlar ve efektler
+### Katmanlar, maskeler ve efektler
+
+- **Sınırsız katman**; her birinin kendi kaynağı, karışım kipi, opaklığı, dönüşümü (ölçek, döndürme,
+ X/Y, çevirme) ve ses tepkisi (bant, opaklık, ölçek, döndürme) var. Listenin en üstündeki katman
+ çıkışta en üstte.
+- **17 karışım kipi** — Normal, Ekle, Ekran, Çarp, Bindirme, Koyulaştır, Açıklaştır, Renk Soldurma,
+ Renk Yakma, Sert Işık, Yumuşak Işık, Fark, Dışlama, Ton, Doygunluk, Renk, Parlaklık.
+- **Maskeler** — başka bir katmandan alfa, artı dikdörtgen, elips, doğrusal ve dairesel degradeler;
+ konum, boyut, açı, yumuşatma ve ters çevirmeyle.
+- Tek sürgülü **gruplar**, ve eşit güç eğrisinde bir **A/B geçiş sürgüsü**.
+- **Solo, sessiz ve kilit** — solo bir katmanı geri alınabilir biçimde yalnız bırakır, sessiz
+ ayarlarını kaybetmeden gizler, kilit kazara düzenlemeyi önler.
+- Katmanları sahneler arasında kopyalayın, yapıştırın, çoğaltın. Bütün yığın kapatılabilir; liste
+ kaybolmadan düz Arkaplan + Görselleştirici kurulumuna dönülür.
+- **Bozuk bir katman artık bütün kareyi götürmüyor** 3.1.5, ve opak bir MilkDrop katmanının
+ altında kalan katmanlar hiç çizilmiyor.
+
+**Son işlem — 40 GPU efekti**; sıralanabilir, her birinin kendi opaklığı var, açılıp kapanabilir, hem
+katman başına hem de birleştirilmiş görüntüde kullanılabilir. Tek bir katmandaki efekt o katmanın
+saydamlığını koruyor; alttaki katmanlar görünür kalıyor.
+
+- **Kompozisyon** — Bloom · Vinyet · İz / Yankı · Kenar Vurgusu · Renk Düzeltme
+- **Bulanıklık ve odak** — Bulanıklık (Gauss) · Işınsal Bulanıklık · Yönlü Bulanıklık · Merkezden
+ Bulanıklık · Tilt-Shift · Alan Derinliği (Bokeh) · Keskinleştirme · Kabartma
+- **Yarım ton ve desen** — Dither (Bayer) · Yarım Ton · ASCII Mozaik · Tarama Çizgisi (Kalem) · Yağlı
+ Boya (Kuwahara) · Pikselleştir · Posterize / Ters Çevir · Eşikleme · Solarizasyon
+- **Analog ve hasar** — Film Greni · CRT / Tarama Çizgileri · VHS / Analog Bant · Glitch (Dilim Kayması)
+ · Datamosh (Blok Kayması) · Bozuk Sinyal · Renk Sapması (Kromatik)
+- **Bozulma** — Lens Bozunumu · Burgu · Kutupsal Dönüşüm · Dalga Bozulması · Yarık Tarama ·
+ Kaleydoskop · Ayna
+- **Renk ve ışık** — Gradyan Eşleme · Seviyeler ve Eğri · Işık Huzmeleri · Yıldız Süzgeci
+
+Her efektin her parametresi modülasyon matrisiyle sürülebiliyor.
+
+---
+
+### Modülasyon
+
+
-- **Sınırsız katman**; her birinin kendi kaynağı, karışım modu, saydamlığı, dönüşümü ve ses
- tepkisi var. Listede en üstteki katman görüntüde de en üsttedir.
-- **17 karışım modu**, tek fader'lı gruplar, solo, sessiz ve kilit.
-- **Maskeler** — başka bir katmandan alfa, ayrıca şekil ve gradyan maskeleri.
-- **40 GPU efekti**; sıralanabilir, sese bağlanabilir ve bileşiğin yanı sıra katman başına da
- kullanılabilir. Tek bir katmana verilen efekt o katmanın saydamlığını koruyor, yani alttaki
- katmanlar görünür kalıyor; parlamanın boş alana taşan ışığı yine onların üstünde görünüyor.
-- **A/B çapraz geçişi** katman grupları arasında, eşit güç eğrisiyle.
-- **Yığının tamamı kapatılabilir**; sahne katman listesini kaybetmeden yalın Arkaplan +
- Görselleştirici kurulumuna döner.
+- **Her kaynaktan her ayara** — yönlendirmeler, güncel ayarların canlı bir ağacından seçilen herhangi
+ bir noktalı yapılandırma yoluna gidiyor.
+- **Kaynaklar** — bas, orta, tiz, seviye, vuruş zarfı ve vuruş tetiği · sekiz tayf bandı · LFO'lar ·
+ zarf izleyiciler · örnekle-ve-tut · rastgele · vuruş saati · makro düğmeleri · ve her derin çözümleme
+ ölçümü (ton, akor, perde, ses yüksekliği, davul bantları…).
+- **Sekiz LFO biçimi** — sinüs, üçgen, yükselen testere, alçalan testere, kare, darbe, rastgele rampa ve
+ gürültü — hızı Hz cinsinden ya da algılanan tempoya kilitli vuruş bölümleriyle (1/16'dan 8 ölçüye),
+ artı faz kayması ve darbe genişliği.
+- **Yönlendirme başına biçimlendirme** — en az, en çok, miktar, ata ya da ekle, bir eğri (doğrusal, üs,
+ S-eğrisi, nicemleme, ters), yumuşatma ve değişim hızı sınırı.
+- MIDI öğrenmeye açık **sekiz makro düğmesi**.
+- Değerler yazınca-kopyala ile uygulanıyor, modülasyon kayıtlı ayarlarınızı hiç değiştirmiyor; LFO fazı
+ çizim saatinden geliyor, çevrimdışı dışa aktarma kareye kadar tam.
---
-## Modülasyon
+### 3B geometri ve formüller
-- **Her kaynaktan her ayara** — LFO'lar, zarf takipçileri, örnekle-ve-tut ve rastgele; yapılandırmadaki
- herhangi bir değere yönlendirilir.
-- **Sekiz LFO şekli**, hız Hz cinsinden ya da algılanan tempoya kilitli vuruş bölmeleriyle.
-- **Eğri şekillendirme** — üs, S eğrisi, kuantalama, ters çevirme — artı yönlendirme başına
- yumuşatma ve eğim sınırlama.
-- **Sekiz makro düğmesi**, atanabilir; MIDI ve uzaktan kumandaya açık.
-- **Çevrimdışı dışa aktarımda deterministik**: LFO fazı çizim saatinden geliyor, kare atlamak onu
- kaydıramaz.
+- **Düzlem eğrileri (30)** — gül eğrileri, lemniskatlar, kardioidler, episikloidler, hiposikloidler,
+ spiraller, ruletler, Lissajous figürleri, kelebek ve süper formül eğrileri bunların arasında.
+- **Uzay eğrileri (12)** — yonca ve simit düğümleri, Viviani eğrisi, helisler, konik spiraller ve
+ benzerleri.
+- **Yüzeyler (29)** — simit, Klein şişesi, Möbius şeridi, Boy yüzeyi, Dini yüzeyi, breather, süper
+ elipsoid, Gielis süper şekilleri, Chladni figürleri, yonca tüp ve daha fazlası.
+- **Garip çekiciler (27)** — Lorenz, Rössler, Chen, Halvorsen, Thomas, Aizawa, Chua, Dadras, Sprott,
+ Clifford, de Jong, Hénon ve diğerleri; sürekli ve ayrık.
+- **Katı cisimler (13)** — dörtyüzlü, küp, sekizyüzlü, onikiyüzlü, yirmiyüzlü, alt bölme denetimli bir
+ jeodezik küre, dört L-sistemi (ağaç, eğrelti, ejderha eğrisi, 3B Hilbert eğrisi) ve üç yinelemeli
+ işlev sistemi (Barnsley eğreltisi, Sierpinski dörtyüzlüsü, spiral).
+- Tel kafes, nokta ya da gölgeli çizim; çözünürlük, deformasyon, dönme, renk kipi ve her parametrede ses
+ bağlama.
+- **Kendi matris matematiği** — üçüncü taraf 3B kitaplığı yok. **Çerçeveleme bildirilmiyor,
+ ölçülüyor**: bir çekicinin ilk yinelemeleri sınır kutusu için yoklanıyor ve bir test her sistemin
+ görüş hacminin içine düştüğünü doğruluyor.
---
-## Derin ses çözümlemesi
+### Studio — kendi shader'ınızı yazın
-| Canlı ölçümler | Kroma çemberi |
+| Studio | Yerleşik shader'lar |
|:---:|:---:|
-|  |  |
+|  |  |
-- **Tonalite ve akor**, sabit-Q kroma vektöründen — FFT kutuları yerine Goertzel filtre bankasıyla,
- çünkü 2048 örnekte bas bölgesi kutularla ayrılamıyor.
-- **Perde takibi** YIN ile.
-- **Armonik / vurmalı ayrıştırması** ve bant başına vuruş algılayıcıları (kick, snare, hat).
-- **Tınısal betimleyiciler** — merkez, dönüm, düzlük, tepe faktörü.
-- **Gürlük, dinamik, gerçek tepe, stereo genişlik ve korelasyon.**
-- Ölçümlerin hepsi modülasyon kaynağı olarak kullanılabilir.
+- Canlı önizlemeli, hata satırını bildiren ve sürgülerini sizin tanımladığınız bir **GLSL düzenleyici**.
+- Yerel çeviricilerle **Shadertoy ve ISF içe aktarma**. Hiçbir hizmete bağlanılmıyor.
+- Shader'lar `sv_resolution`, `sv_time`, `sv_level`, `sv_bass`, `sv_mid`, `sv_treble`, `sv_beat`,
+ `sv_spec(x)`, `sv_waveAt(x)`, sahne paleti için `sv_col(x)`, kamera ya da video katmanı için
+ `sv_media` alıyor.
+- **42 yerleşik shader**, hepsi öz testte gerçek GPU'da derleniyor:
+ - **Arkaplanlar (25)** — Bulut Katmanları · Kıvrım Akışı · Lav Lambası · Mürekkep Yayılması · Duman
+ Halkaları · Petek Akışı · Bükülmüş Izgara · Truchet Örgü · Moiré Girişimi · Kristal Mağara ·
+ Mandelbrot Yakınlaşması · Julia Kümesi · Yanan Gemi · Apollonius Çemberleri · Kaleydoskopik IFS ·
+ Menger Süngeri · Mandelbulb · Işık Tüneli · Yıldız Sıçraması · Kutup Perdesi · Sıvı Metal · Neon
+ Yağmur · Reaksiyon Deseni · Su Kostikleri · Prizma Işıması
+ - **Görselleştiriciler (11)** — Işıyan Barlar · Spektrum Halkası · Dalga Alanı · Vuruş Patlaması ·
+ Parlayan Osiloskop · Frekans Ağı · Nota Çemberi · Parçacık Akışı · Kaleydoskop Spektrum · Nabız
+ Izgarası · Sıvı Barlar
+ - **Altı eski preset** — Plazma Deniz, Frekans Halkaları, Sıvı Metal, Yıldız Geçidi, Dalga Perdesi,
+ Bas Küresi
+- **MilkDrop Preset Üretici ve Düzenleyici** de burada — bkz. [MilkDrop](#milkdrop).
---
-## 3B geometri ve formüller
+### Sahneler, şablonlar, geçişler ve renk
+**Sahneler** bütün görünümü — arkaplan, görselleştirici, katmanlar, efektler, logo, metin,
+modülasyon, MilkDrop ve görsel nesneler — bir ad altında saklıyor. Tek tıkla geri yükleyin, güncel
+görünümden güncelleyin, JSON olarak dışa ve içe aktarın.
+
+**On grupta 81 hazır şablon.** Tek tık; ses aygıtınız, ekran seçiminiz, yayın ve aydınlatma
+ayarlarınız olduğu gibi kalıyor — bir şablonu denemek çalışan bir kurulumu bozmamalı, bunu bir test
+doğruluyor.
+
+- *Kulüp (8)* — Strobe Wall, Hyper Tunnel, Laser Grid, Mandala Drop, Strobe Floor, Fireworks, MilkDrop
+ Flow, Strange Attractor
+- *Ambiyans (9)* — Aurora, Ink in Water, Topography, Underwater, Embers, Liquid Metal, Night Globe,
+ Flow Field, Interference
+- *Yayın (6)* — Corner Bars, Clean Wave, Ring Meter, Scope Overlay, Lower Third, Studio Meters
+- *Müzik Videosu (11)* — Label Card, Artwork Card, Baseline Bars, Amber Room, Minimal White, Quiet
+ Frame, Corner Meter, Centre Strip, Wave Card, Cover Ring, Stage Card. Kapak, parça adı ve sanatçı
+ tek bir Çalan Parça katmanından geliyor; kapak her en-boy oranında yazının yanında aynı boşlukla
+ duruyor. Panel önizlemesinde parça çalmıyorken kartta yer tutucu yazı görünür.
+- *Müzik Arka Planı (6)* — Aurora Backdrop, Flow Backdrop, Nebula Backdrop, MilkDrop Backdrop, Galaxy
+ Backdrop, Soft Glow: müzik çalarken arkada sade, kısık bir görselleştirici, önde parça kartı
+- *Müzik (6)* — Chroma Wheel, Helix, Silk Ribbons, Strings, Spectrogram, Galaxy
+- *Ekran Koruyucu (6)* — Plasma, Stained Glass, Circuit, Wire Tunnel, Dunes, Prism
+- *3B Geometri (8)* — Klein Bottle, Lorenz, Supershape, Trefoil Tube, Chladni, Rose Curve, Chua
+ Circuit, Möbius
+- *Tür (16)* — Techno, House, Drum & Bass, Hip-Hop, Lo-Fi, Synthwave, Rock, Metal, Jazz, Classical,
+ Ambient, Pop, Trance, Dubstep, Chiptune, Experimental
+- *Etkinlik (5)* — Minimal Line, Corporate, Gala, Festival, Projection Test
+
+**Müzik videosu düzenleri.** Yayın videoları ve resmî kanallar için sade düzenler, kulüp
+malzemesinden bilerek ayrı: karenin oranı olarak bar yerleşimi, grensiz düz bir zemin, ve kapak,
+parça adı ile sanatçı tek bir kart olarak. Kapak her en-boy oranında yazının yanında aynı boşlukla
+duruyor; barlar kartla aynı kenar boşluğunda.
+
+
+**Sahne Üretici.** Bir tariften sahne kuruyor. Bir sinir ağı **değil** ve öyle sunulmuyor: metni
+ağırlıklı bir anahtar sözcük sözlüğüyle dört eksene indiriyor ve onlardan deterministik bir üreticiye
+tohum veriyor. Tamamen çevrimdışı çalışıyor.
+
+**18 sahne geçişi** — Kesme · Çapraz Geçiş · Erime · Silme · Dairesel Silme · Saat Silme · Ahır Kapısı ·
+Jaluzi · Kayan Şeritler · Dama · İris · Parlaklık Silme (giden karenin kendi parlaklığına göre) · Zum
+Darbesi · İtme · Kaydırma · Parlama · Glitch · Bulanık Geçiş. Altı yumuşatma eğrisi, saniye ya da
+vuruş cinsinden süre, ve kapatma anahtarı. Bir *sahne* değişiminde tetikleniyorlar, sürgüde asla;
+bir denetimi sürüklemek geçiş başlatmıyor.
+
+**Renk.** Beş renk noktası, yedi grupta **58 yerleşik palet** (Klasikler, Sıcak, Soğuk, Neon ve Siber,
+Karanlık, Aydınlık, Tek Renk Aileleri) ve kendi kayıtlı paletleriniz her arkaplana, Studio'ya ve 3B
+motora uygulanıyor. Her görselleştirici paleti izleyebiliyor (*tema* renk kipi).
+
+**Dinamik renk teması (Windows).** Palet çalan parçayı izleyebiliyor: albüm kapağından çıkarılan
+renkler, bir uyum biçimi (analog, tümler, üçlü, siberpunk, synthwave, kutup ışığı…), parça adının
+havası ya da presetler arasında bir döngü — arkaplana, görselleştiriciye ya da ikisine birden.
+
+---
+
+### Metin, şarkı sözü ve Çalan Parça
+
+
+
+| Çalan Parça | Metin |
+|:---:|:---:|
+|  |  |
-- **98 formül** — 30 düzlem eğrisi, 12 uzay eğrisi, 29 yüzey, 27 garip çekici.
-- **13 katı cisim** — beş platonik katı, alt bölme denetimli jeodezik küreler, dört L-sistemi ve üç
- yinelemeli fonksiyon sistemi.
-- **Kendi matris matematiği.** Üçüncü parti 3B kütüphanesi yok.
-- **Kadraj bildirilmiyor, ölçülüyor.** Bir çekicinin ilk yinelemeleri sınırlayıcı kutusu için
- taranıyor ve bir test her sistemin görüş hacminin içine düştüğünü doğruluyor.
+**Çalan Parça.** Windows'ta uygulama sistem medya oturumunu (SMTC) okuyor; Spotify'dan, YouTube
+Music'ten, bir tarayıcıdan ya da çoğu oynatıcıdan gelen parça ekrana kendiliğinden geliyor: ad,
+sanatçı, albüm, geçen ve kalan süre, ilerleme çubuğu ve albüm kapağı. Sürekli görünebiliyor ya da
+yalnız parça değişince beliriyor; yedi canlandırma ve *Modern* ile *OG* biçimleriyle. macOS ve
+Linux'ta ad, sanatçı ve kapak elle giriliyor. Çalan Parça panel önizlemesinde ve dışa aktarılan
+videolarda da görünüyor 3.1.5.
+
+**Metin.** Karakter başına tepkili (ölçek, titreme, yükselme) sese duyarlı tipografi · yazı tipi,
+kalınlık, boyut, hizalama, konum, opaklık, dış çizgi ve gölge · canlandırma kalıpları · kayan yazı ve
+haber bandı · karaoke vurgusu.
+
+**Şarkı sözleri.**
+
+- İçerikten biçimi algılanan **LRC ve SRT içe aktarma**, gelişmiş LRC sözcük zamanları dahil.
+- LRC'ye geri yazan senkron kaymalı bir **zamanlama düzenleyici**.
+- Ekranlar açıkken yüklü bir söz dosyası için **oynat, duraklat ve durdur**; bütün ekranlar ve OBS
+ katmanı, uygulamanın çalıştığı makineye göre düzeltilen tek bir saati paylaşıyor.
+- **Söz Kütüphanesi (Windows)** 3.1.5 — her biri sanatçı ve parça adı taşıyan birçok LRC ya
+ da SRT dosyası tutun. **Çalan Parçayı İzle**, sistem medya oturumundan şarkıya uyan dosyayı buluyor
+ ve sarma ile duraklatmayla birlikte ilerliyor. **Tam Eşleme** ya da küçük yazım farklarına izin veren
+ **Kısmen Eşleme**; kütüphanede eşleşme yoksa oynatıcının zamanlı sözleri kullanılıyor. Dosyalar zaman
+ damgalarını, sözcük zamanlarını ve etiketleri renklendiren uzun bir düzenleyicide açılıyor;
+ kaldırmadan önce soruluyor. Ağdan hiçbir şey çekilmiyor.
+
+---
+
+### Logo, görseller ve medya katmanı
+
+- **Logo** — karenin herhangi bir yerine konan, kendiliğinden boyutlanan bir görsel; boyut, opaklık,
+ parlama, konum ve ses nabzıyla; hareketli GIF'ler oynuyor. Logo **çalan parçanın albüm kapağını** da
+ gösterebiliyor. Şablon uygulamak logonuzu koruyor, yalnız yerleşimini değiştiriyor.
+- **Logo ve video kitaplıkları** 3.1.5 — içe aktarılan dosyalar uygulamanın kendi klasörüne
+ kopyalanıp kimlikle anılıyor; ayar dosyası küçük kalıyor ve taşınan bir özgün dosya sahneyi bozmuyor.
+- **Görsel nesneler** — görselleştiricinin önünde ya da arkasında görsel sprite'lar; sayı, boyut,
+ sürüklenme, dönme ve ses tepkisiyle.
+- **Medya katmanı** — bir web kamerası ya da video dosyası, görselleştiricinin önünde ya da arkasında;
+ sığdırma (kapla, sığdır, uzat), ayna, 3–12 dilimli kaleydoskop, ton kayması, doygunluk, karışım kipi,
+ opaklık ve sesle sürülen yakınlaşma ve opaklık. Aynı kare Studio shader'larında `sv_media` olarak
+ okunabiliyor.
+- **Her çıkışta akıcı** 3.1.5 — videolar varsayılan olarak işlemciyle çözülüyor; tam
+ ekran pencerelerde ve Spout/Syphon akışında tam kare hızında oynuyor. Donanım çözmede Chromium
+ orada neredeyse hiç kare üretmiyordu (ölçüldü: saniyede 0,3) ve klip döngü noktasında donuyordu.
+ HEVC/H.265 videolar için **Ayarlar → Uygulama → Donanım Video Çözme** gerekiyor (yeniden
+ başlatınca geçerli); böyle bir dosya açılmazsa panel bunu söylüyor.
---
-## MilkDrop
+### Gösteri kontrolü: zaman çizelgesi, klip destesi, Otomatik VJ, MIDI ve OSC
-
+| Zaman çizelgesi | Klip destesi |
+|:---:|:---:|
+|  |  |
+**Zaman çizelgesi.** Sahneleri ve ayar değişimlerini ölçüye ya da saniyeye hizalı biçimde zamana
+yayın; tek bir oynatma kafası bütün ekranları birlikte sürüyor, çevrimdışı dışa aktarma da aynı
+gösteriyi oynatıyor.
+
+- Sahne, şablon, palet, video, görsel, shader ve eylem için klip parçaları; herhangi bir ayar için
+ eğrili **otomasyon şeritleri**; işaretler ve döngü.
+- **Tam bir düzenleyici** 3.1.5, Ableton'ın Arrangement View'ı örnek alınarak: aktarım,
+ saat (zaman ve ölçü.vuruş), tempo, yakalama, döngü, izleme ve yakınlaştırmalı bir araç çubuğu; renk,
+ sessiz, solo ve kilitli parça başlıkları; oynatma kafasında bölme, çoğaltma, kopyala-yapıştır, dürtme,
+ 100 adımlık geri alma; kutuyla çoklu seçim; sürüklenebilir döngü ayracı ve işaret bayrakları; klip
+ başına geçiş tutamakları; **cetvelde tempo değişimleri**; ayarlanabilir şerit yüksekliği ve tam
+ pencere kipi; yalnız düzenleyici odaktayken çalışan klavye kısayolları.
+
+**Klip destesi.** Sahneleri, şablonları, paletleri ve medyayı bir ızgaraya yerleştirip vuruşta ateşleyin.
+
+- Genel bir nicemleme ayarıyla **vuruşa hizalı ateşleme**, **takip eylemleri** (sonraki, rastgele,
+ git, döngü, dur) ve süreler.
+- **Ateşleme kipleri** 3.1.5 — tetik, aç/kapa ve **basılı tut** (basılıyken çalar).
+- Sekmeli **birden çok deste**, adlandırılmış satır ve sütunlar, renkler, ilerleme çubukları, sıradaki
+ hücrelerde yanıp sönen geri sayım, taşımak ya da kopyalamak için sürükle-bırak, ve ikinci bir ekran
+ için **Performans Görünümü**.
+- **Klavyeyle çalma** 3.1.5 — 1-9 ya da oklar satırı seçer, A-P bir yuvayı ateşler, Enter
+ satırı başlatır.
+- **Medya ve eylem yuvaları** 3.1.5 — video, görsel ve shader yuvaları seçilen bir katmana
+ uygulanıyor; eylem yuvaları MIDI ve OSC eşlemeleriyle aynı eylemleri çalıştırıyor.
+- Ateşlenen yuvalar **zaman çizelgesine kaydedilebiliyor**; doğaçlanan bir set düzenlenebilir bir
+ gösteriye dönüşüyor.
+
+**Tempo ve Otomatik VJ.** Parçanın temposu bulunuyor ve **Otomatik VJ** sahneleri, görselleştirici
+modlarını ya da renkleri ölçüye hizalı olarak kendiliğinden değiştiriyor. Hangi sahnelerin, modların
+ya da paletlerin döneceğini tam olarak seçin (ya da hepsi için boş bırakın), her görselleştirici
+katmanına kendi modunu verin, ve neyin değiştiğini, sıradakini ve bir kaynak boşsa neden hiçbir şey
+olamayacağını söyleyen bir durum satırını okuyun.
+
+**MIDI.** Bir denetimi öğretin, sonra herhangi bir CC'yi ya da notayı herhangi bir ayara ya da eyleme
+eşleyin — MilkDrop'un sonraki, önceki, rastgele, kes, kilit ve puan eylemleri dahil.
+
+**OSC.** Elle yazılmış bir OSC 1.0 ayrıştırıcılı UDP dinleyici; TouchOSC, Resolume, Ableton ya da QLab
+için.
+
+
+
+
+
+
+
+**Telefon kumandası.** Sahneler, renk paletleri, Studio presetleri, görselleştirici ve arkaplan
+modları, ses hassasiyeti, karartma ve çalan parça kartı için telefon boyutunda bir sayfa; OBS
+katmanıyla aynı sunucudan. Telefondan gelen değerler uygulanmadan önce aralık denetiminden geçiyor
+3.1.5.
+
+**Karartma** Space ile ya da herhangi bir denetleyiciden; kendi geçişiyle, kayıtlı sahneye
+dokunmadan.
+
+---
+
+### Çıkışlar: ekranlar, OBS, Spout ve Syphon
+
+
+
+
+
+
+
+**Çoklu ekran.** Seçtiğiniz her ekranda ayrı bir tam ekran pencere. Seçilen ekranlar konum ve boyutla
+hatırlanıyor; Windows'un yeniden bağlanınca numarasını değiştirdiği bir monitör yeniden bulunuyor
+3.1.5.
+
+**Yüzen pencere** 3.1.5. Opaklık, 16:9 en-boy kilidi, konum kilidi ve **tıklamayı alttaki
+pencereye geçirme** seçenekli resim-içinde-resim bir pencere; çalışırken görselleri masaüstünüzün
+üstünde tutmak için.
+
+**Yayın çıkışı — OBS ve tarayıcı.** **Çıkış → Yayın Çıkışı**'nı açın; uygulama bir katman sayfası
+sunar.
+
+- OBS'e **Tarayıcı Kaynağı** olarak ekleyin. Eklenti yok, gerçek saydamlık.
+- Katman masaüstü penceresiyle **aynı motoru** çalıştırıyor; ne görüyorsanız o yayınlanıyor — MilkDrop
+ presetleri ve dokuları dahil.
+- Ağ üzerinden çalışıyor: görselleştirici bir makinede, OBS başka bir makinede olabilir.
+- **Saydamlık uygulamanın kendi anahtarı**; tek bir kaynağı zorlamak için adresine `?transparent=0` ya
+ da `?transparent=1` ekleyin.
+- **Şarkı sözleri uygulamayı izliyor**; tarayıcı saatini uygulamanın çalıştığı makineye göre düzeltiyor.
+- **Bir tanı kartı** 3.1.5 — bağlantıyı, yapılandırmayı, ses kare hızını, tuval boyutunu,
+ saydamlığı, uygulama sürümünü ve son hatayı görmek için adrese `?debug=1` ekleyin.
+- Erişim jetonlarla korunuyor; katmanın ve telefon kumandasının ayrı jetonları var.
+
+**GPU çıkışı — Spout ve Syphon.** Görüntü aynı makinedeki başka bir uygulamaya GPU üzerinden
+verilebiliyor: pencere yakalama yok, CPU kopyası yok.
+
+- Windows'ta **Spout**, macOS'ta **Syphon**. Alıcılar arasında Resolume, OBS, TouchDesigner ve
+ MadMapper var — iki protokolden birini konuşan her şey.
+- **Kaynak adını**, çözünürlüğü ve kare hızını seçin.
+- Kendi gizli penceresinde çiziliyor; hiçbir görselleştirme penceresi açık değilken de akış sürüyor.
+- Spout ve Syphon opak kalıyor: paylaşılan bir GPU dokusu göndereni düşürmeden alfa taşıyamıyor.
+- **Linux'ta yok**; orada yerleşik bir karşılığı yok. Panel bunu söylüyor ve her yerde çalışan OBS
+ tarayıcı kaynağını gösteriyor.
+
+---
+
+### Sahne: projeksiyon haritalama ve basıklık düzeltme
+
+
+
+**Projeksiyon haritalama**
+
+- Gerçek bir homografi olarak **köşe sabitleme**; doku perspektif doğru kalsın diye payda
+ `gl_Position.w`'ye yazılıyor.
+- Kontrol noktalarından geçen bir Catmull-Rom ızgarasında **ağ bükme**.
+- Çok projektörlü kurulumlar için **yumuşak kenar harmanlama**; eğrilerin örtüşmede tam 1'e toplandığı
+ sınanıyor.
+- **Çıkış başına kırpma, renk düzeltme ve Bézier çokgen maskeleri**; artı hizalama ızgaraları,
+ artılar, renk çubukları ve odak halkaları; sürükleme, ok tuşuyla dürtme ve tam sayısal giriş.
+
+**Basıklık düzeltme.** Bir ekranın bildirdiği çözünürlük her zaman fiziksel şekliyle uyuşmuyor.
+1920×1080 sürülen ama gerçekte yaklaşık 3:1 olan bir panel — bir sahne LED duvarı, bir bar ekranı,
+anamorfik bir projektör, uzatma kipine zorlanmış bir TV — her çemberi elips çiziyor.
+
+- **Kare asla uzatılmıyor.** Sahne, panelin gerçek şekline uyan kare pikselli bir tuvale çiziliyor ve
+ çerçeve tamponuna doğrusal olarak sıkıştırılıyor; panelin kendi bozulması sıkıştırmayı geri alıyor.
+ Hiçbir şey kırpılmıyor, hiçbir şey kenardan taşmıyor.
+- **Tek ayar her şeyi düzeltiyor** — arkaplan, görselleştirici, logo, metin ve sprite'lar birlikte.
+- Bir çember, kare ya da ızgarayla **gözle ayarlanıyor**; ya da panel boyutundan, gerçek en-boy
+ oranından ya da önceden uzatılmış bir görselin ölçülerinden.
+- **Ekran başına ya da tüm ekranlar**; projeksiyon haritalamayla mevcut köşe ayarını kaydırmadan
+ birleşiyor; dışa aktarılan videoya, yayına ve web katmanına dokunmuyor.
+
+---
+
+### RGB aydınlatma: Dynamic Lighting, OpenRGB ve Art-Net
+
+**Windows Dynamic Lighting**
+
+- Varsayılan olarak kapalı; yalnız uyumlu aygıtlar algılanınca kullanılabilir.
+- Dinamik kipler: görselleştirici renk akışı, bar-tayf eşlemesi, bas/orta/tiz bölgeleri, arkaplan ışık
+ eşitlemesi, eşzamanlı vuruş flaşları, frekans dalgacıkları, bar ve arkaplan birleşimi, aygıtlar
+ arası renk akışı, gökkuşağı akışı ve eşikle tetiklenen patlamalar.
+- Elle kipler: tek renk, aygıt başına renkler, ve donanımın sunduğu yerde LED ya da bölge başına renkler.
+- Parlaklık, ses tepkisi, yumuşatma, güncelleme hızı, LED yerleşimi, palet kaynağı, bant başına renk ve
+ hassasiyet, flaş eşiği, gücü ve sönümü, dalgacık hızı, yönü ve genişliği, ve renk yayılımı
+ ayarlanabiliyor.
+- Kurulum programı Windows arka plan aydınlatma kimliğini kaydediyor; uygulama odakta değilken de
+ ışıklar çalışıyor. Uygulamayı **Dynamic Lighting → Arka plan ışık denetimi**'nde üst sıralara koyun.
+
+**OpenRGB — her yerde RGB.** Çalışan bir **OpenRGB** sunucusuyla kendi protokolü üzerinden (TCP,
+varsayılan 6742 portu) Windows, macOS ve Linux'ta konuşuyor — üretici yazılımı yok, sunucu başka bir
+makinede olabilir. OpenRGB'nin sunduğu her aygıt, donanımın izin verdiği yerde LED başına, Dynamic
+Lighting ile **aynı kipler ve aynı renk matematiğiyle**.
+
+**Art-Net / DMX.** Armatürlere ve ışık masalarına ArtDMX çıkışı; paket düzeni bayt bayt sınanıyor.
+
+**Renk kaynakları.** Işıklar arkaplanı, temayı ya da **canlı MilkDrop görüntüsünü** 3.1.5
+izleyebiliyor — saniyede yaklaşık 30 kez soldan sağa sekiz dilime örnekleniyor; soldaki armatürler
+ekranın solundaki renkleri alıyor.
+
+---
+
+### Kayıt ve video dışa aktarma
+
+
+
+
+
+
+
+- **Çevrimdışı video dışa aktarma (ses dosyası → MP4).** Bir parçayı kare kare çiziyor — ekran kaydı
+ değil — 720p, 1080p, 1440p ya da 4K, 30 ya da 60 fps; kalite, CPU ya da GPU kodlayıcı, ilerleme,
+ iptal ve GPU'dan CPU'ya geri düşmeyle. Deterministik: aynı iş aynı videoyu veriyor; görsel gerileme
+ testlerinin dayandığı özellik bu. Ad, sanatçı, albüm ve kapak dosyadan okunup Çalan Parça'ya ve metin
+ katmanlarına veriliyor.
+- Çıkışın göründüğü gibi **canlı kaydı** — canlı ses, modülasyon, geçişler ve efektlerle — MP4 ya da
+ WebM'e, tek tuşla.
+- Tek geçiş gözle görülür bantlandığı için iki geçişli palet üretimli **GIF dışa aktarma**.
+- Bir kısayolla 4×'e kadar **PNG anlık görüntü**.
+- Yaygın en-boy oranları için **dışa aktarma kalıpları**.
+
+---
+
+### MCP — bir yapay zekâ ajanıyla kontrol
+
+3.1.5
+
+Bir ajan, çalışan uygulamayı **Model Context Protocol** üzerinden sürer. Anahtar **Kontrol**
+kartındadır ve varsayılan olarak kapalıdır. Anahtar açıkken uygulama açık kalır. Kurulum
+penceresi Claude Desktop, Codex, Cursor, Grok ve Grok Bot için bir stdio komutu verir. Ollama
+ayrı bir protokol değildir; MCP konuşan bir istemcinin arkasındaki yerel modeldir ve aynı komutu
+kullanır.
+
+> **Node.js gerekir.** stdio komutu `node` çalıştırır; bilgisayarda [Node.js](https://nodejs.org/)
+> LTS kurulu ve `PATH` üzerinde olmalıdır. Uygulamanın kendisinin Node.js'e ihtiyacı yoktur. Node.js
+> yoksa MCP istemcisi `node`'u başlatamadığını bildirir.
+
+Sunucu JSON-RPC `initialize`, `ping`, `tools/list` ve `tools/call` konuşur. `2024-11-05`,
+`2025-03-26` ve `2025-06-18` sürümlerini kabul eder; başka bir sürüm isteğine `2024-11-05` ile
+yanıt verir. Sunucu adı `soundvisualizer`. **96 araç** vardır.
+
+İstemci stdio köprüsünü başlatır. Köprü, taşıyıcı jetonla `http://127.0.0.1:/mcp` adresine
+yazar. Soket yalnız `127.0.0.1` adresine bağlanır. Port, siz başkasını seçmedikçe **38471**'dir.
+**8722** reddedilir; o port yayına aittir. Meşgul port meşgul kalır: sunucu başka porta geçmez,
+kart başarısızlığı yazar. Her açılış, uygulama veri klasöründeki `mcp-endpoint.json` dosyasına
+yeni bir jeton yazar; yanında köprünün bir kopyası durur. Linux ve macOS'ta bu iki dosyayı yalnız
+bu kullanıcı okur. Başka bir makineden gelen bağlantı reddedilir; eksik ya da yanlış jeton da
+reddedilir.
+
+`sv_get_config`, çıkış durumu okuması ve `sv_export_json` yayın jetonlarını karartır.
+`sv_set_stream`, `token` ve `remoteToken` alanlarını atar.
+
+Her araç parametrelerini türleri, aralıkları ve izin verilen değerleriyle `tools/list` içinde
+bildirir. Panelin üretemeyeceği değerler reddedilir ya da panelin aralığına çekilir: -1..1
+dışındaki katman konumu, `#rrggbb` olmayan renk, bilinmeyen efekt türü, var olmayan bir ayara
+giden modülasyon rotası. `sv_patch_config` bir listeye yalnız var olan bir sıradan yazar
+(`layers.0.opacity`) ve yeni üst anahtar oluşturmaz. Yazılan değer yerine geçtiği değerin türünde
+olmalı; `layers` altındaki yazım `sv_update_layer` ile aynı denetimden geçer. Aracın tanımadığı
+argümanlar yanıtta `ignored` olarak geri söylenir.
+
+Beş kip birikir. Anahtar **Okuma** kipinde açılır. Üst kip altındakileri de kapsar. Ajan kendi
+iznini yükseltemez: `sv_patch_config` her `mcp.*` yolunu reddeder. Engellenen çağrı gereken kipin
+adını söyler ve ajana kipi değiştirmemesini, panele tıklamamasını bildirir.
+`sv_list_permissions` ve `mcp_permissions` etkin kipi, araç adı verirseniz o aracın en alt kipini
+bildirir.
+
+İzin verilen değişiklik, tıklamayla aynı yoldan kaydolur ve gider. Yönetici paneli, açık
+görselleştirici pencereleri ve yayın hepsini alır. Her çağrıdan sonra, başarılı ya da hatalı,
+preset klasörü yeniden okunur ve açık pencereler farkı alır.
+
+#### Okuma
+
+Ana anahtar yeter. Bu çağrılar yalnız okur.
+
+- `sv_get_state` gösteriyi döner: etkin preset, sahneler, katmanlar, açık efektler, ekranlar, BPM
+ ve seviyeler, çalan parça, katman yığını, yayın durumu, Spout/Syphon durumu ve panel
+ önizlemesinin canlı çözümlemesi (önizlemede ses yokken boş).
+- `sv_get_visual_state`, `sv_list_layers`, `sv_get_layer` ve `sv_get_layer_stack` katman konumu,
+ ayarları ve katman efektlerini döner.
+- `sv_get_preview` ekrandaki görüntünün JPEG'ini ekler; genişlik en çok 480 pikseldir. Sırayla
+ açık bir görselleştirici penceresine, yüzen pencereye, sonra yönetici panelindeki önizleme
+ dikdörtgenine bakar.
+- `sv_get_audio` panelin çizdiği aynı sayaçtan seviye, bas, orta, tiz, BPM ve güven döner.
+ `sv_get_now_playing` çalan parçayı döner. `sv_list_audio_sources` ayarlı girişleri listeler.
+- `sv_list_scenes` ve `sv_get_scene` kayıtlı sahneleri okur. `sv_list_modes` bütün görselleştirici ve
+ arkaplan kimliklerini, katman türlerini ve karışım kiplerini listeler; mod ve katman araçları
+ listede olmayan kimliği reddeder. `sv_list_effects` genel zinciri, her
+ katmanın zincirini ve 40 hazır efekt türünü listeler. `sv_list_presets` kütüphane presetlerini
+ ve kullanıcı renk paletlerini listeler. `sv_list_displays` ekranları listeler.
+- `sv_get_output_status` hangi görselleştirici pencerelerin açık olduğunu, yayın anahtarını,
+ portunu ve LAN bayrağını, Spout/Syphon adını okur. `sv_get_timeline`, `sv_get_clipdeck` ve
+ `sv_get_autovj` o panelleri okur. `sv_get_config` bütün yapılandırmayı ya da tek bir noktalı
+ yolu okur.
+
+#### Uygula
+
+Kayıtlı olanı kullanır.
+
+- `sv_apply_scene` kayıtlı bir sahneyi kimlikle, ad tekilse adla yükler. Anlık görüntü arkaplan,
+ görselleştirici, katmanlar, gruplar, çapraz geçiş, geometri, efektler, logo, resimler, ortam,
+ yazı, modülasyon, geçiş, Studio, MilkDrop ve geri beslemeyi kapsar. Pencere saydamlığı ve görev
+ çubuğunu kaplama olduğu gibi kalır.
+- `sv_apply_template` hazır bir şablonu kimlik ya da adla uygular. `sv_set_visualizer_type` ve
+ `sv_set_background_type` var olan bir mod kimliğine geçer. Bir Studio shader'ı `custom` türü ve
+ `presetId` ile gösterilir. `sv_set_layer_enabled` bir katmanı gösterir ya da gizler ve yığını
+ açar. `sv_set_crossfade` A/B sürgüsünü 0 ile 1 arasına alır.
+- `sv_trigger_clip` klip destesinde bir yuvayı satır ve sütunla ateşler. `sv_stop_clips` çalan her
+ yuvayı durdurur. Izgara kayıtlı halinde kalır. İkisi de yönetici penceresinin açık olmasını
+ ister.
+- `sv_set_effect_enabled` ve `sv_set_effect_param` genel zincirde duran bir efekti değiştirir.
+ Katman çifti aynı işi tek katmanda yapar. `sv_set_modulation_enabled` modülasyon matrisini açar
+ ya da kapatır. `sv_set_macro` var olan bir makro sürgüsünü ayarlar.
+- `sv_load_preset` kütüphanedeki bir preseti canlı MilkDrop kaynağına kopyalar.
+ `sv_apply_color_preset` var olan bir kullanıcı ya da hazır paleti arkaplan gradyanına boyar.
+ `sv_set_milkdrop_cycle` kütüphanenin ilerleyişini ayarlar: otomatik sonraki, sıra, kaynak,
+ etiket, birim, ölçü sayısı, parça ilerleyişi ve sert kesme.
+
+#### Yazma
+
+Oluşturur ve düzenler.
+
+- Sahneler: `sv_create_scene` o anki görünümü yeni bir adla saklar, `sv_update_scene` birinin
+ üstüne yazar, `sv_rename_scene` kimliği ya da şimdiki adıyla bulduğu sahneye `newName` adını verir,
+ `sv_delete_scene` siler.
+- Katmanlar: `sv_add_layer`, `sv_update_layer`, `sv_set_layer_position`, `sv_set_layer_settings`,
+ `sv_remove_layer`, `sv_reorder_layers`. Bir katman tür, görselleştirici tipi, preset, opaklık,
+ harman, dönüşüm (x, y, ölçek, döndürme, çevirme), ses tepkisi, maske, solo, sessiz, kilit ve
+ grup taşır. Katman efektleri efekt araçlarından gider. Katman eklemek ya da göstermek yığını
+ açar.
+- `sv_set_text` yazı katmanını düzenler; şarkı sözü ya da çalan parça kaynağı buna dahildir.
+ `sv_set_logo`, `sv_set_media` ve `sv_set_geometry` o blokları düzenler.
+- Efektler: genel zincirde `sv_add_effect` ve `sv_remove_effect`, tek katmanda
+ `sv_add_layer_effect` ve `sv_remove_layer_effect`. Hazır türler bloom, chroma, glitch, grain,
+ crt, pixelate, kaleido, mirror, grade, vignette, trails, edge, zoomblur, ripple, posterize,
+ blur, radialblur, motionblur, tiltshift, dof, sharpen, emboss, dither, halftone, ascii, hatch,
+ paint, vhs, datamosh, slitscan, lens, twirl, polar, gradientmap, levels, threshold, solarize,
+ godrays, badtv ve starfilter. `sv_add_modulation_route` ve `sv_remove_modulation_route`
+ rotaları düzenler.
+- Presetler: `sv_save_preset` preset deposuna bir dosya yazar. Türü verilmemiş shader metni Studio
+ görselleştiricisi olarak kaydolur (`kind` `visualizer`, `engine` `shader`). Türü verilmemiş
+ diğer kayıt MilkDrop'dur. `engine` `shader` ya da `variation` olur; `glsl`, `shadertoy`, `isf`
+ ve `frag` `shader` sayılır. `sv_delete_preset` dosyayı siler, olmayan kimliği bildirir. `sv_set_milkdrop_source` MilkDrop
+ kaynağını canlı gösteriye yazar. `sv_create_color_preset` iki ile beş `#rrggbb` renkli bir
+ kullanıcı paleti saklar; panel gibi beş renk tutar, eksikte son rengi tekrarlar. `sv_delete_color_preset` bir kullanıcı paletini siler.
+- Otomatik VJ: `sv_set_autovj` açık, kaynak, aralık, birim, sıra, BPM kilidi, palet kaynağı ve
+ katman başına görselleştirici hedeflerini ayarlar.
+- Dışa aktarma ve kayıt: `sv_start_export` diskte duran bir ses dosyasını sizin verdiğiniz video
+ yoluna çizer. Çözünürlük, saniyede 30 ya da 60 kare, CPU ya da GPU kodlayıcı, hız ve kalite
+ dışa aktarma panelindeki seçeneklerdir. `sv_cancel_export` süren aktarmayı durdurur.
+ `sv_export_json` sahne listesini ya da bütün ayarları, pencere açmadan, bir yola yazar.
+ `sv_save_snapshot` canlı görüntüyü bir yola JPEG olarak yazar. Bu üç araç yalnız uzantısı
+ uyan, mutlak ve yerel bir yol kabul eder: video için `.mp4`, ayarlar için `.json`, görüntü için
+ `.jpg` ya da `.jpeg`. Ağ yolları, `tcp://` gibi adresler ve uygulamanın kendi klasörleri
+ reddedilir. Var olan bir dosyanın üstüne yalnız `overwrite: true` ile yazılır. `sv_record_start` ve `sv_record_stop`
+ yönetici kaydedicisini sürer. Durdurmak, Kayıt kartındakiyle aynı kaydetme penceresini açar.
+ Kaydedici, yönetici penceresinin açık olmasını ister.
+
+#### Tam
+
+Canlı yüzeyleri açar.
+
+- `sv_open_output` görselleştiriciyi seçilen ekranlarda açar. Bir ekran kimliği vermek seçili
+ kümeyi değiştirir. `sv_close_output` görselleştirici pencerelerini kapatır. `sv_set_displays`
+ ekranları seçer, pencereleri olduğu gibi bırakır.
+- `sv_set_stream` OBS ve tarayıcı yayınını değiştirir. `sv_set_texture_share` Spout ve Syphon'u
+ değiştirir. `sv_set_aspect` basıklık düzeltmesini değiştirir. `sv_set_power` kare hızı tavanını,
+ çizim ölçeğini ve görselleştirme penceresi açıkken ekranı uyanık tutan `keepAwake` ayarını değiştirir.
+- `sv_set_floating` yüzen pencere tercihlerini değiştirir; opaklık ve tıklamayı geçirme buna
+ dahildir. `sv_set_floating_open` aynı resim-içinde-resim penceresini açar ya da kapatır.
+- `sv_set_window_mode` saydam arkaplanı, saydamlık eşiğini ve görev çubuğunu kaplamayı ayarlar.
+- `sv_set_lighting` Windows Dynamic Lighting ayarlarını değiştirir. `sv_set_openrgb` OpenRGB'yi
+ değiştirir. `sv_set_artnet` Art-Net'i değiştirir. `sv_set_audio_sources` giriş karışımını
+ değiştirir.
+- `sv_set_mapping` bir ekranın projeksiyon haritasını yazar: açık, köşeler, kırpma, kenar
+ harmanlama, maskeler, ağ, renk ve test deseni; haritalamayı da açar. Yeni bir ağ portu açmaz.
+- `sv_timeline_transport` zaman çizelgesini yönetici taşıması üzerinden oynatır, duraklatır,
+ durdurur ya da sarar. Yönetici penceresi açık olmalıdır.
+- `sv_set_blackout` `on`, `off` ya da `toggle` alır ve kayıtlı sahneyi yerinde bırakır.
+ `sv_set_blackout_transition` karartma geçişinin türünü ve süresini ayarlar.
+
+#### Her şey, ve genel yama
+
+`sv_patch_config` başka herhangi bir noktalı yolu yazar. Kip yola bağlıdır: sahne içeriği,
+efektler ve presetler **Yazma** ister; dışa aktarma yolları **Yazma** ister; ekranlar, yayın,
+ışık, eşleme, pencereler ve zaman çizelgesi **Tam** ister; `control.*` (MIDI ve OSC bağlamaları)
+**Her şey** ister. Daha sıkı bir yolu içeren yol da o kipi ister: anahtarları taşıdığı için
+`stream` nesnesinin tamamı **Her şey**, `power`, `audio`, `background` ve `transition`
+nesnelerinin tamamı **Tam** ister. Tabloda olmayan bir yol **Her şey** ister. `mcp.*`, `version`,
+`__proto__`, `prototype` ve `constructor` yolları reddedilir.
+
+`sv_updates_download` ve `sv_updates_install` uygulamanın bulduğu güncellemeyi indirir ve kurar.
+`sv_rotate_stream_token` OBS ya da kumanda anahtarını yeniler. `sv_repair_audio` ses bileşeni
+sağlamsa yakalamayı baştan kurar; eksikse bunu söyler, çünkü kurulum kullanıcının onayını ister.
+Dördü de **Her şey** ister. Okuma araçları `sv_diagnose_audio` ve `sv_get_analysis` yakalama
+tanısını ve canlı çözümlemeyi (ton, akor, perde, gürlük, davul bantları) döner.
+
+---
+
+### Yönetici paneli
+
+
+
+- **Sekiz kategori** — Sahne, Ses, Işık, Çıkış, Kontrol, Studio, Kitaplık ve Ayarlar.
+- **Her yerde canlı** — her değişiklik anında çıkış pencerelerine ulaşıyor ve kendini kaydediyor.
+- Her sayfanın yanında kendi demo sinyaliyle bir **canlı önizleme**, ses ölçerleri ve kayıtlı sahneler.
+- Her kartta ve kategoride **değişti işaretleri**; bölümü ya da bütün kategoriyi sıfırlama.
+- Her kategorideki her ayarda **arama** (Ctrl + K).
+- **Gelişmiş** anahtarları seyrek kullanılan denetimleri siz isteyene kadar gizliyor; **genişletilmiş
+ aralıklar** sürgü sınırlarını 5 katına çıkarıyor.
+- Çalışırken değiştirilebilen **Türkçe ve İngilizce**; çevrilmemiş tek bir arayüz metni kalırsa öz test
+ başarısız oluyor.
+
+---
+
+### Güvenilirlik, güç ve güncellemeler
+
+- **Kaza koruması** — beklenmedik biçimde kapanan bir görselleştirici penceresi (çökme, Alt+F4) anında
+ yeniden açılıyor; *Yanlışlıkla Kapatmayı Önle* gösteri sırasında uygulama kapanmadan önce soruyor;
+ isteğe bağlı bir ESC kilidi ve çıkış yolu olarak Ctrl + Shift + Q.
+- **Ekranı uyanık tutuyor** 3.1.5 — bir görselleştirici penceresi açık ve simge durumunda
+ değilken varsayılan olarak açık; Windows, macOS ve Linux'ta. Küçültmek ya da kapatmak denetimi güç
+ ayarlarınıza geri veriyor.
+- **Her GPU yüzeyi kaybolan bağlamdan dönüyor** 3.1.5 — bir sürücü sıfırlaması artık yeniden
+ başlatmaya kadar siyah katmanlar bırakmıyor.
+- **Ana süreç hataları kapsanıyor** 3.1.5 — beklenmedik bir hata, uygulamayı bir hata
+ kutusunun ardında dondurmak yerine kaydediliyor ve panelde gösteriliyor.
+- **Aynı anda iki kopya** 3.1.5 — ikinci kopya zaten çalışanı adıyla söylüyor ve ona geçmeyi
+ öneriyor; bir kopya başkasının değiştirdiği ayarların üstüne sessizce asla yazmıyor.
+- **Güncellemeler** 3.1.5 — *Kitaplık → Güncellemeler* GitHub Sürümlerini denetliyor, notları
+ gösteriyor ve bir sürümü atlamanıza izin veriyor. Windows kurulumu ve AppImage yerinde indirip
+ kuruyor; boyut ve SHA-256 tam uyuşmadıkça hiçbir şey çalışmıyor. Kapalı, haber ver (varsayılan) ya da
+ otomatik.
+- **Ayar yedeği ve geri yükleme** — her ayar tek bir JSON dosyasında; paletlerin ve sahnelerin kendi
+ dışa aktarımı var ve içe aktarmadan sağ çıkıyorlar. 1.3 ve 2.0 sürümlerinin yazdığı dosyalar tek bir
+ değer kaybetmeden açılıyor.
+- **Güç ve performans** — *Ekranla Eşitle* kare hızı ya da 120, 60 veya 30 FPS sınırı, arkaplan
+ çözünürlük ölçeği, sessizlikte duraklatma, imleci gizleme, her zaman üstte, ve görev çubuğunu örtme.
+
+---
+
+### Gizlilik ve güvenlik
+
+- **Hesap yok, telemetri yok, analiz yok.** Ayarlar kullanıcı klasörünüzde duruyor.
+- **Kendiliğinden yaptığı tek ağ çağrısı**: güncelleme denetimi için GitHub'ın son sürüm API'si,
+ hiçbir kimlik bilgisi olmadan. Güncellemeleri *Kapalı* yapın, hiç kalmaz.
+- **Geri kalan her şey isteğe bağlı ve yerel**: yayın sunucusu (yerel ağ, jetonla korunuyor; başka
+ kökenlerden gelen sayfaları ve tanımadığı ana bilgisayar adlarını reddediyor 3.1.5), OSC,
+ OpenRGB, Art-Net ve MCP (yalnız `127.0.0.1`'e bağlı, bir taşıyıcı jetonla).
+- **Çeviriciler ve üreticiler çevrimdışı çalışıyor** — Shadertoy ve ISF içe aktarma, sahne üretici,
+ MilkDrop preset üretici, şarkı sözleri.
+- **Otomasyon kamerayı asla açmıyor**, ve bir fuzz testi hiçbir MilkDrop presetinin motora JavaScript
+ kaçıramayacağını doğruluyor.
+
+---
+
+## SSS
+
+**Ücretsiz mi?**
+Evet. CAYADEV Visualizer MIT lisansıyla açık kaynak. Ücretli katman, hesap ya da filigran yok.
+
+**Stereo Mix ya da sanal ses kablosu gerekiyor mu?**
+Windows'ta hayır: sistem sesi doğrudan çıkış aygıtından yakalanıyor. macOS'ta sistem sesi için
+BlackHole gibi sanal bir aygıt gerekiyor (mikrofonlar doğrudan çalışıyor). Linux'ta PulseAudio ya da
+PipeWire monitor kaynağı kendiliğinden kullanılıyor.
+
+**Spotify, YouTube, Apple Music ya da bir DAW ile çalışır mı?**
+Evet — bilgisayarınız ne çalıyorsa onu görselleştiriyor. Windows'ta yalnız tek bir uygulamayı (örneğin
+Spotify'ı) yakalayıp gerisini yok sayabilirsiniz; Çalan Parça parça adını ve kapağı sistem medya
+oturumundan okuyor.
+
+**OBS katmanı olarak kullanabilir miyim?**
+Evet. Yayın Çıkışı'nı açın ve adresi bir Tarayıcı Kaynağı olarak ekleyin. Saydamlık çalışıyor ve OBS
+aynı ağdaki başka bir bilgisayarda olabilir. GPU paylaşımı için Spout (Windows) ve Syphon (macOS) da var.
+
+**MilkDrop presetlerimi yükleyebilir mi?**
+Evet: tek `.milk` dosyaları, MilkDrop 3 `.milk2` çift presetleri 3.1.5, ZIP paketleri,
+klasörler ya da bilgisayarınızda bir arama. Görsel kullanan presetler için uygulamayı bir MilkDrop
+`textures` klasörüne yönlendirin. Üçüncü taraf preset paketi gelmiyor; beş özgün preset geliyor.
+
+**Bir Winamp ya da projectM eklentisi mi?**
+Hayır. WebGL2'de kendi MilkDrop uyumlu motoru olan bağımsız bir uygulama. projectM'i ya da MilkDrop'u
+içermiyor.
+
+**Birkaç monitörü ve projektörü destekliyor mu?**
+Evet — seçilen her ekranda tam ekran bir pencere, artı projektörler ve LED duvarlar için projeksiyon
+haritalama, kenar harmanlama ve basıklık düzeltme.
+
+**Bir parçadan müzik videosu yapabilir miyim?**
+Evet. Video Dışa Aktar, güncel sahneyle bir ses dosyasını kare kare MP4'e, 60 fps'de 4K'ya kadar
+çiziyor. Ekran kaydı değil; sonuç bilgisayarınızın hızına bağlı değil.
+
+**Yapay zekâ ajanları kontrol edebilir mi?**
+Evet 3.1.5. Kontrol sayfasında MCP'yi açın ve kurulum penceresinin verdiği komutla Claude
+Desktop, Codex, Cursor ya da herhangi bir MCP istemcisini bağlayın. Erişim salt okumadan başlıyor.
+Komut için bilgisayarda [Node.js](https://nodejs.org/) LTS kurulu olmalı.
+
+**Bilgisayarımı yavaşlatır mı?**
+WebGL2 destekli bir GPU gerekiyor. Dizüstü bilgisayarlarda kare hızı sınırını, arkaplan çözünürlük
+ölçeğini ve sessizlikte duraklatmayı kullanın; MilkDrop paneli ağ yoğunluğunu ve iç çözünürlüğü
+gösteriyor.
+
+**Ekran koruyucu olabilir mi?**
+Bir Ekran Koruyucu şablon grubu var ve görseller çalışırken ekran uyanık tutuluyor, ama uygulama
+kendini işletim sistemi ekran koruyucusu olarak kaydetmiyor.
+
+**macOS ve Linux ne kadar destekleniyor?**
+İkisi de CI makinelerinde derleniyor ve ses motoru orada yükleniyor, ama ikisi de henüz proje
+tarafından gerçek donanımda çalıştırılmadı. Her şey Windows'ta ölçülüyor. Mac ve Linux
+kullanıcılarından gelecek raporlar çok değerli.
+
+**Videom tam ekranda ya da Spout'ta donuyor, ya da iPhone videosu oynamıyor.**
+Videolar varsayılan olarak işlemciyle çözülüyor; bu, tam ekranda ve Spout/Syphon akışında akıcı
+kalmalarını sağlıyor 3.1.5. HEVC/H.265 dosyalar (telefonlarda yaygın) yalnız donanımla
+çözülebiliyor: Ayarlar → Uygulama → Donanım Video Çözme'yi açıp uygulamayı yeniden başlatın.
+
+**Verilerim bir yere gönderiliyor mu?**
+Hayır. Bkz. [Gizlilik ve güvenlik](#gizlilik-ve-güvenlik).
+
+---
+
+## MilkDrop motoru notları
+
+Motorun uyum çalışması, preset preset ölçülmüş hâliyle. MilkDrop Uyumu varsayılan olarak açık;
+kapatmak motorun önceki görünümünü geri getiriyor.
+
- **Preset dili gerçekten çalışıyor** — sözcük çözümleyici, ayrıştırıcı ve JavaScript kapanışlarına
derleme. `per_frame` ve `per_pixel` denklemleri gerçek bir warp ağını geri beslemeyle sürüyor.
+- **10.347 gerçek preset üzerinde ölçüldü**, projectM'in özgün ve cream-of-the-crop paketlerinden:
+ hepsi yükleniyor ve çalışıyor, 10.344'ünde tek bir deyim bile atlanmıyor.
- **`.milk` içe aktarma**, çok dosyalı paketler dahil; derleme hataları dosya dosya bildiriliyor.
- **Uygulama kendi beş presetiyle geliyor.** *Kutup Işığı* (akışkan bir bulutsu), *Erimiş Altın*
(abartılı olan), *Dingin Halkalar* (yavaş ve neredeyse siyah), *Sonsuz Tünel* (klasik tünel) ve
@@ -237,6 +1208,41 @@ profilinde basamak olmadığını doğruluyor.
değiştirmişti, yani geniş ekran düzeltmesi yanlış eksene uygulanıyordu. Bulanık kopya kenarında
karartılıyor (`b1ed`, %68,6'sı istiyor), özel dalgalar MilkDrop genliğinde çiziliyor ve tayf
isteyen dalga tayfı okuyor (%23,2).
+- **Kendi shader'ı olmayan presetler MilkDrop 2'deki gibi görünüyor.** MilkDrop bir presetin warp
+ ve birleştirme shader'ını shader metninin varlığından değil dosyanın sürümünden seçiyor, gerisini
+ harmanlama geçişlerinden kurulu sabit bir yolla çiziyor. MilkDrop 2'nin kaynağına ve özgün D3D9
+ koduna göre denetlendi: orada parlatma `1−(1−c)²`, solarize `2c(1−c)` — motorun kullandığı
+ `sqrt(c)` ve `4c(1−c)` değil (10.332 presetlik bir korpusta 410 preset parlatmayı, 83'ü
+ solarize'ı açıyor); yankı yönü `(int)x % 4`; yankı açıkken 1'in altındaki gama uygulanmıyor;
+ yankıları farklı yöne bakan iki preset geçişte karışırken yankı bir anda dönmüyor, sönüp
+ yeniden beliriyor. Sönmesini ya da gamasını yazmayan bir preset 0 yerine MilkDrop'un 0,98 ve
+ 2,0'ını alıyor, yazmadığı öteki değerler de öyle — MilkDrop'un eksik dalga rengini 0 okuyan
+ tuhaflığına kadar; dönme merkezi 0 ise köşede kalıyor. MilkDrop'un denklemlere açmadığı değerler
+ (dalga ölçeği ve yumuşatması, sesle sönme, warp hızı ve ölçeği) oradaki gibi dosyadan geliyor, yani
+ 0 dalga ölçeği dalgayı düzleştiriyor (korpusta 102 preset). Motordan geçirilerek çizildi: her
+ durum MilkDrop'un formülüyle 2/255 içinde aynı.
+- **Preset dosyaları MilkDrop'un okuduğu gibi okunuyor.** Uyum açıkken anahtarlar büyük/küçük harfe
+ duyarlı, iki kez yazılmış bir anahtar MilkDrop'un bulduğu değeri (çoğunlukla ilkini) alıyor,
+ numaralı kod ilk eksik numarada bitiyor, tam sayı ayarları kesirlerini atıyor ve denklem satırları
+ MilkDrop'un yapıştırdığı gibi, `\\` yorumları dahil, yapışıyor. Korpusta 32 preset farklı
+ okunuyor; uyum kapalıyken eski ayrıştırıcı duruyor.
+- **Denklemler MilkDrop 2 derleyicisinin kurallarıyla çalışıyor.** Uyum açıkken doğruluk ve eşitlik
+ sınamaları onun 0.00001 toleransını kullanıyor, `%` işaretsiz tam sayılarla, `&` ve `|` 64 bit
+ tam sayılarla çalışıyor, `megabuf` ve `gmegabuf` indisleri onun yuvarladığı ve sınırladığı gibi
+ hesaplanıyor, `rand(n)` gerçel sayı döndürüyor (korpusta 5.361 preset çağırıyor) ve derleyicinin
+ `_aboeq` gibi iç adları çalışıyor. Uyum kapalıyken hiçbir şey değişmiyor.
+- **Her blok MilkDrop'taki kendi değişkenleriyle çalışıyor.** Uyum açıkken per-pixel kodu ve bir
+ dalganın per-point kodu, MilkDrop'un ayrı sanal makineleri gibi kendi değişken alanında koşuyor:
+ yalnız MilkDrop'un verdiklerini görüyor (zaman, ses, ağ ölçüsü, q1..q32, dalgada t1..t8), kendi
+ değişkenlerini ve `megabuf`ını tutuyor, yazdıkları geri sızmıyor. `reg00`..`reg99` her blokta ve
+ presette ortak; şekiller artık init'in oraya bıraktığı rastgele değerleri görüyor. `loop`/`while`
+ MilkDrop'taki gibi çağrı başına 1.048.576 turda duruyor.
+- **Birleştirme shader'ları MilkDrop'un verdiği ton rengini alıyor.** MilkDrop her birleştirme
+ shader'ına `hue_shader` olarak dört köşede yavaşça gezinen renkler veriyor, presetin `fShader`ı
+ ne derse desin; `fShader` onları yalnız sabit yolda ölçekliyor. Motor `fShader`ı shader'lara da
+ uyguluyordu: korpustaki yaklaşık 950 preset renksiz ya da rengin bir kısmıyla çiziliyordu,
+ köşeler de dikeyde aynalanmıştı. Sabit yolda renk artık MilkDrop'un kendi çizim geçişlerinden,
+ aralık dışı renklerin sarması dahil, geçiyor.
- **Dokulu şekiller, hareket vektörleri, dönme matrisleri, ağ sıklığı, iç çözünürlük, fare girdisi
ve preset geçişleri** uygulandı; her sampler adının istediği süzme ve sarma ile okunuyor
(`sampler_pw_main` noktasal, `sampler_fc_main` süzülmüş+kenetli — presetlerin %22,7'si aynı
@@ -256,6 +1262,36 @@ profilinde basamak olmadığını doğruluyor.
gelen bir presetle ölçüldü: dönem başına salınım panelin 45 fps'lik önizlemesinde 0,714, 74
Hz'lik ekranda ise 1,000'dı, flaş hiç kısılmıyordu. Sınır artık saniye başına: önizlemede, 60
ve 74 Hz'lik pencerelerde, 35 fps'lik pencerede ve web çıkışında aynı biçimde 0,43–0,49.
+- **MilkDrop sistemin "hareketi azalt" ayarını izliyor.** İşletim sistemi hareketin azaltılmasını
+ istediğinde (Windows'ta Erişilebilirlik › Görsel efektler altında *Animasyon efektleri*
+ kapalıyken) flaş sınırlayıcı kapatılmış olsa da açık kalıyor, sesin yükselişinde sert geçiş
+ olmuyor ve her değişim 5 saniyede karışıyor. Otomatik geçiş bu uzun geçişle planlıyor, yani
+ preset ayarladığınız süre boyunca yine tam görünüyor. Elle *Şimdi kes* yine kesiyor. MilkDrop
+ paneli açık olup olmadığını ve nedenini söylüyor; *Hareketi Azalt* iki yönde de geçersiz
+ kılıyor: *Her zaman* ya da sistem istese de *Kapalı*. Her ekran kendi sistemine bakıyor — başka
+ makinedeki web çıkışı o makineyi izliyor — video dışa aktarımı ise yalnız *Her zaman*'ı izliyor,
+ yani bir video onu üreten makineye bağlı değil. Ayarın tarayıcı motorunda taklit edildiği
+ yalıtılmış bir kopyada denetlendi; sistemin kendi ayarına dokunulmadı.
+- **Kaybolan GPU bağlamı geri geliyor.** Sürücünün sıfırlanması ya da GPU sürecinin çökmesi bütün
+ WebGL nesnelerini götürüyor; MilkDrop uygulama yeniden açılana kadar siyah kalıyordu, çünkü kodda
+ bunu dinleyen bir yer yoktu. Motor artık kaybı tutuyor: tarayıcıdan bağlamı geri istiyor ve
+ geldiğinde programlarını, dokularını ve tamponlarını aynı tuvalde yeniden kuruyor; üç saniyede
+ gelmezse — tarayıcı vazgeçmişse ya da bağlam elle kaybettirilmişse — yeni bir tuvalde baştan
+ kuruluyor. Çalışan preset iki durumda da yaşıyor: aynı nesne, aynı denklem durumu, aynı saat,
+ yani kaldığı yerden sürüyor. Geri gelemeyen tek şey GPU belleğindeki geri besleme tamponunun
+ içeriği; görüntü yeniden siyahtan akmaya başlıyor. Chromium'un, GPU süreci çöken bir sayfaya 3B'yi
+ kapatma alışkanlığı da kapatıldı: o engel kurtarmanın gidecek yerini bırakmıyordu. GPU öz testi
+ çalışan motorda bağlamı iki yoldan da kaybettirip karelerin, piksellerin ve presetin kendi
+ durumunun geri geldiğini ölçüyor.
+- **Diğer GPU yüzeyleri de dönüyor.** Gerçek bir GPU sıfırlanması bütün bağlamları birden götürüyor;
+ gradyan arkaplan, 3B geometri modu, shader modları, efekt zincirleri ve projeksiyon haritalaması
+ siyah kalırken MilkDrop'un dönmesi yetmiyordu. Hiçbiri geri besleme ya da birikmiş durum
+ taşımıyor; her biri artık bağlamının kaybolduğunu söylüyor ve sahibi aynı ayarlarla yenisini
+ kuruyor: katman YERİNDE — aynı sırada, aynı karışım kipi, saydamlık ve z-sırasıyla — yeniden
+ kuruluyor, efekt zinciri efektlerini koruyor. Bir yüzey en çok iki saniyede bir yeniden kuruluyor;
+ GPU süreci daha kalkmadıysa her karede yeni bir tuval açılmıyor. GPU öz testi çalışan sahnede
+ gradyan arkaplanın ve efekt zincirinin bağlamını kaybettirip ikisinin de görüntüyle döndüğünü
+ ölçüyor (en parlak örnek 175 ve 206/255, kayıptan öncekiyle aynı).
- **Preset geçişi MilkDrop'un çift boru hattı.** Yeni preset yüklenince eskisi durmuyor: kendi
nesnesi, kendi derlenmiş shader'ları ve kendi saatiyle yaşamaya devam ediyor ve her karede iki
presetin de kare ve düğüm denklemleri koşuyor. İki warp ağı düğüm düğüm bir rampa boyunca
@@ -275,6 +1311,110 @@ profilinde basamak olmadığını doğruluyor.
12,00 → 18,00 ms'ye çıkıp bir kare düşürüyor. Bu yüzden varsayılan 1,7 sn — MilkDrop'un kendi
`fBlendTimeUser` değeri — ve otomatik preset geçişi varsayılan olarak kapalı, yani geçiş yalnız
siz istediğinizde koşuyor.
+- **Preset değişimi kareyi bekletmiyor.** 900 presette, 1280×720'de ölçüldü: preseti yükleyen kare
+ komşularından ortancada 17 ms, en kötü ~119 ms uzundu ve her on değişimden altısı, başka türlü
+ tutacak bir kareyi düşürüyordu — bunun onda dokuzu, kare beklerken GPU'nun yeni shader'ları
+ derlemesiydi. Sürücü `KHR_parallel_shader_compile` sunuyorsa derleme artık arka planda sürüyor ve
+ çalışan preset çizilmeye devam ediyor; değişim — geçiş dahil — yeni programlar hazır olunca,
+ ortancada iki üç kare sonra başlıyor. Otomatik geçişte sıradaki preset bir saniye önceden seçilip
+ derleniyor, yani değişim yine vaktinde — ölçü kipinde ölçünün başında — geliyor ve diğer ekranlar
+ da aynı preseti hazırlıyor. Varsayılan ağda kare düşüren değişimler sert kesmede %61,9'dan
+ %4,9'a, geçişte %61,7'den %8,1'e indi. Video dışa aktarımı derlemeyi yine bekliyor; bir presetin
+ hangi karede göründüğü makineye bağlı değil.
+- **Yeni parça sıradaki preseti getirebilir.** Otomatik geçişin yanında *Parça Değişince* ayarı,
+ Şimdi Çalıyor yeni bir parça gördüğünde sıradaki presete geçiyor — seçilen sırayla, rastgele de
+ dahil. Zamanlayıcı kapalıyken de çalışıyor, kilit bunu da durduruyor ve seçimi yalnız lider ekran
+ yapıyor, yani bütün ekranlar birlikte değişiyor. Uygulama açılırken zaten çalan parça sayılmıyor,
+ iki parça arasındaki boşluk da.
+- **Favoriler, etiketler ve yazara göre arama.** MilkDrop panelinin listesinde presetleri yıldızla
+ işaretleyin, ekrandakini *Favori* ile (bir MIDI ya da OSC eşlemesinden de) ve onlara kendi
+ etiketlerinizi verin. Arama adda, yazarda ve etiketlerde. MilkDrop adları çoğunlukla "Yazar -
+ Başlık"; `yazar:geiss` (ya da `author:`) Geiss'in presetlerini buluyor, adını anan bir başlığı
+ değil, `#sakin` bir etiketi buluyor. *Süz* listeyi favorilere ya da bir etikete, *Yazar* bir
+ yazara daraltıyor. *Havuz* otomatik geçişi — zamanlayıcı, sert geçiş ve parça değişimi —
+ favorilerle ya da bir etiketle sınırlıyor; Önceki, Sonraki, Rastgele ve liste yine bütün presetlere gidiyor.
+ Favori ve etiketler puanlarınızın yanında, ayarlarda duruyor, preset dosyalarında değil; paket
+ üçünü de taşıyor: *Görünenleri Paketle* listede görünen presetleri onlarla birlikte yazıyor, paketi
+ içe aktarmak onları yeni kopyalara bağlıyor. Yalıtılmış bir kopyada denetlendi: havuz üç favoriye
+ ayarlıyken görselleştirici penceresi o üçünde döndü, başka hiçbir presete geçmedi.
+- **Büyük preset kütüphaneleri hafif kalıyor.** Her kayıt ya da silme bütün preset dosyalarını
+ yeniden okuyor ve bütün listeyi kaynaklarıyla panele, her pencereye ve her web istemcisine
+ gönderiyordu. Tam bir MilkDrop kütüphanesinin 10.347 presetiyle (116 MB) tek bir silme uygulamayı
+ ~2,4 saniye tutuyordu ve panel 631 MB kullanıyordu. Presetler artık bir kez okunup tutuluyor; bir
+ değişiklik yalnız değişeni gönderiyor. Aynı büyüklükte bir kayıt artık 91 ms sürüyor, panel 273 MB
+ kullanıyor. MilkDrop presetleri eklenip silindiğinde ekrandaki MilkDrop görüntüsü artık baştan
+ başlamıyor. Web istemcileri MilkDrop presetlerini kaynaksız alıyor (2.000 presette ~30 MB yerine
+ 271 KB) ve web çıkışı bir presetin kaynağını ancak onu çizecekken istiyor.
+- **Bütün bir MilkDrop kütüphanesini içe aktarın.** MilkDrop panelindeki *ZIP Paketinden İçe
+ Aktar*, *Klasörden İçe Aktar* ve *Makinede Ara* bir kütüphaneyi tek seferde alıyor: iç içe
+ klasörler, paketin dokuları ve istenirse paketin kategori klasörleri etiket olarak. Neyin
+ ekleneceğini (preset, doku, MB ve neyin atlanacağı: MilkDrop 3'ün `.milk2` çift presetleri, sınırı
+ aşan dosyalar, şifreli ZIP girdileri) görüp onaylamadan hiçbir şey kopyalanmıyor. Aynı ad ve
+ içerikteki presetler atlanıyor, yani bir paketi iki kez almak bir şey eklemiyor. Dokular
+ uygulamanın kendi klasörüne gidiyor ve seçtiğiniz doku klasöründen sonra aranıyor; paketin
+ `sampler_worms`'u klasör seçmeden de çalışıyor. Arama bilinen Winamp, foobar2000 ve projectM
+ klasörlerine ve İndirilenler, Masaüstü, Müzik, Belgeler'e — sistem onları nerede tutuyorsa —
+ bakıyor ve birkaç saniyede duruyor; sayımını bitiremediği bir kütüphane size sorulmadan önce
+ baştan taranıyor. Uygulamayla hiçbir preset paketi gelmiyor. Gerçek paketlerle ölçüldü: 9.795
+ presetlik bir klasör 1,1 sn'de tarandı, 6,2 sn'de içe aktarıldı; ikinci kez almak hiçbir şey
+ eklemedi.
+- **Preset küçük resimleri.** MilkDrop panelindeki listenin *Izgara* düzeni var: her preset kendi
+ küçük resmiyle görünüyor, yani bir preset görünüşünden bulunabiliyor. Her küçük resim arka planda
+ bir kez çiziliyor — presetin ilk iki saniyesi, örnek sesle, siyah bir ekrandan — uygulamanın
+ verisinde saklanıyor ve preset ya da kullandığı bir doku değişince yeniden çiziliyor. Yalnız
+ kaydırıp baktığınız presetler çiziliyor. Aynı anda MilkDrop çizen bir görselleştirici penceresi
+ bunu neredeyse hiç fark etmedi: hiçbir karesi 27 ms'den uzun sürmedi. Bunu yaparken bulundu: başka
+ bir MilkDrop penceresi çizerken ve bilgisayar meşgulken, tamponlarını yeni kuran bir MilkDrop
+ görüntüsü (yeni bir pencere, yeniden boyutlandırma, küçük resim, video dışa aktarımı) öbür
+ pencerenin görüntüsüyle başlayabiliyordu. Tamponlar artık sıfırdan başlıyor.
+- **Kendi preset üreticimiz.** *Studio → MilkDrop Preset Üretici* dört kaydırıcıdan — enerji,
+ sıcaklık, yoğunluk ve hareket — ve bir tohumdan özgün bir MilkDrop preseti yazıyor. Çevrimdışı
+ çalışıyor; kullandığı hareket, dalga, şekil ve shader kalıplarının hepsi bu uygulama için
+ yazıldı: 30 karakterden uzun hiçbir satırı 10.332 presetlik bir korpusta geçmiyor. Preset
+ kaydedilmeden, önizleme olarak hemen yükleniyor; *Kütüphaneye Kaydet* onu saklıyor. Kaydırıcıyı
+ oynatmak tohumu değiştirmiyor: başka bir preset değil, aynı presetin daha enerjik ya da daha sıcak
+ renkli hâli geliyor; `72-15-60-88-2n9c` gibi bir kod aynı preseti geri getiriyor. Üretilen
+ presette flaş yok: renkleri her ses düzeyinde aralıkta kalıyor, ters çevirme, solarize ve
+ parlatma hiç kullanılmıyor. 200 üretilmiş presette sessizlik, örnek ses ve yüksek bir bas
+ çizgisiyle ölçüldü: bütün shader'lar derlendi; hiçbiri siyah kalmadı, beyaza doymadı, saniyede
+ ikiden çok yanıp sönmedi ya da donmadı.
+- **Kütüphaneden karışım.** Aynı kart zaten sahip olduğunuz presetlerin parçalarından bir preset
+ kuruyor: görünüm (sönme, yankı, gama, ana dalga), hareket denklemleri, özel dalgalar, özel
+ şekiller, warp shader'ı ve birleştirme shader'ı — her biri bütünüyle tek bir presetten, satır
+ satır kopyalanarak. *Yeni Karışım* her parçayı MilkDrop panelinin listesinde görünen
+ presetlerden rastgele çekiyor, yani oradaki arama ve süzgeç burada da geçerli, ve yalnız o
+ parçası olan presetlerden. Tek bir parça yeniden çekilebiliyor ya da altısı birden ekrandaki
+ presetten başlayabiliyor; oklar önceki karışımlara dönüyor, *Kütüphaneye Kaydet* birini saklıyor.
+ Karışım parçalarını veren presetlerin görünüşünü taşıyor, yani onlardan daha parlak ya da daha
+ karanlık çıkabilir. 10.332 presetlik bir korpusta denetlendi: tek presetten kurulan karışım
+ presetin kendisi, 5.000 rastgele karışımda da her parça onu veren presetinkiyle birebir aynı.
+ 300 rastgele karışım motorda koşturuldu; hiçbir shader aşaması düşmedi.
+- **Preset düzenleyici.** *Studio → MilkDrop Preset Düzenleyici* ekrandaki preseti açıyor: kare ve
+ piksel denklemleri, özel dalgalar ve şekiller, warp ve birleştirme shader'ları ve ana değerler ayrı
+ sekmelerde; değişiklik, yazmayı bıraktıktan bir an sonra çalışan görüntüde. Hatalar presetin kendi
+ satırını (`per_frame_14`) kendi metniyle gösteriyor, üretilmiş kodu değil; shader'lar yazarken
+ derleniyor. Yakınlaşma, bükülme, dönme, sönüm ve yankı kaydırıcıları, presetin denklemleri değeri
+ her karede yeniden yazıyorsa bunu söylüyor. Asıl preset hiç değişmiyor: *Yeni Preset Olarak
+ Kaydet* sizin sürümünüzü saklıyor ve yalnız değiştirdiğiniz yazılıyor — dosyanın geri kalanı
+ baytı baytına aynı.
+- **MilkDrop 2 ve MilkDrop 3 kuralları.** *Preset Biçimi* ayarı — Otomatik, MilkDrop 2 ya da
+ MilkDrop 3 — presetin kimin dosya kurallarıyla okunacağını seçiyor: MilkDrop 3'ün 16 özel dalgası
+ ve şekli ve q1–q64'ü ya da MilkDrop 2'nin dördü ve q1–q32'si. Otomatik, bu uzantıları kullanan
+ preseti MilkDrop 3 kurallarıyla okuyor ve panel hangilerini kullandığını söylüyor. MilkDrop 3'ün
+ 1–6 numaralı sert geçiş kipleri kendi eşik ve gecikmeleriyle seçilebiliyor. `.milk2` çift presetleri,
+ iki presetinin donmuş bir karışımı olarak yükleniyor. Yeni dalga biçimleri, yeni geçişleri ve
+ shader'da `get_fft` henüz yok: nasıl davrandıklarını tarif eden bir kaynak yok.
+- **`milk_img.ini`'den sprite'lar.** MilkDrop 2 gösteri sırasında kendi resimlerinizi görüntünün
+ üstüne çiziyor: her biri `milk_img.ini`de bir resim, bir kez çalışan ve her kare çalışan koduyla
+ tanımlı ve numarasıyla başlatılıyor. Dosyayı MilkDrop panelinde seçin; panelin listesinden, bir
+ MIDI ya da OSC eşlemesinden ya da görselleştirici penceresinde MilkDrop'un kendi tuşlarıyla
+ başlatın — K ve iki hane başlatır, SHIFT+K ve iki hane o numarayı siler, DELETE en yeniyi siler.
+ Aynı anda 16 tane; beş karışım kipi, renk anahtarı, döşeme, çevirme ve `burn` (sprite resmini
+ geri beslemede bırakıyor, presetle akıyor) MilkDrop 2'nin kaynağına göre. Bütün ekranlar aynı
+ sprite'ı gösteriyor, `rand` dahil: başlatma kendi tohumunu taşıyor. Üç ekran, web çıkışı, Spout
+ ve panel önizlemesiyle yalıtılmış bir kopyada ölçüldü: altısı da yoklama resmini her ölçüm
+ noktasında çizdi, `rand` ile konumlanan sprite hepsinde aynı x/y'deydi ve basılan bir sprite'ın
+ resmi o öldükten sonra olduğu yerde kaldı. Sprite canlı bir araç; video dışa aktarımına girmiyor.
- **Otomatik geçiş artık geçiyor.** Paneldeki Otomatik Geçiş kaydırıcısı motor geldiğinden beri
oradaydı ve hiçbir yer onu okumuyordu: iki saniyeye ayarlanınca aynı preset ekranda kalıyordu
(çalışan uygulamada ölçüldü — dokuz saniye, değişim yok). Artık her *n* saniyede, sırayla ya da
@@ -306,7 +1446,7 @@ profilinde basamak olmadığını doğruluyor.
vermediğiniz preset boş görünüyor, rastgele sıra ise onu kendi dosyasındaki puanla ağırlıklandırmayı
sürdürüyor. Verdiğiniz puan presete değil
ayarlara yazılıyor, çünkü bir preseti kaydetmek bütün kitaplığı kaynaklarıyla birlikte bütün
- pencerelere yeniden gönderiyor. ◀ ve ▶ artık son tıkladığınız presetten listede adım atmak yerine
+ pencerelere yeniden gönderiyor. Önceki ve Sonraki artık son tıkladığınız presetten listede adım atmak yerine
gerçekten gösterilenlerin geçmişinde geziyor; otomatik geçişin ve sert geçişin seçtikleri de
içinde, geçmiş MilkDrop'un 64 adımını tutuyor. Bir fark bilinçli: geri gidildikten sonra yeni bir
preset gelirse ileri kısım atılıyor, tarayıcıdaki gibi; MilkDrop'un otomatik geçişi ise onu
@@ -410,676 +1550,7 @@ profilinde basamak olmadığını doğruluyor.
---
-## Studio — kendi shader'ınızı yazın
-
-
-
-| Studio | Yerleşik shader'lar |
-|:---:|:---:|
-|  |  |
-
-
-
-- **GLSL düzenleyici**; canlı önizleme, hata satırı bildirimi ve kendi kaydırıcılarınız.
-- **42 yerleşik shader**, hepsi öz testte gerçek GPU'da derleniyor.
-- **Shadertoy ve ISF içe aktarma**, yerel dönüştürücülerle. Hiçbir servise bağlanılmıyor.
-
----
-
-## Basıklık düzeltme
-
-Bir ekranın bildirdiği çözünürlük fiziksel şekliyle her zaman uyuşmaz. 1920x1080 beslenen ama
-gerçekte yaklaşık 3:1 olan bir panelde — sahne LED duvarı, bar tipi ekran, anamorfik lensli
-projektör, gerilmiş moda zorlanmış televizyon — her daire elips çıkar. Logo ezik görünür; yazı,
-efektler ve arkaplan da öyle.
-
-- **Görüntü gerilmez.** Hazır bir kareyi büyütmek kırpar, küçültmek siyah bant bırakır. Bunun
- yerine sahne, panelin gerçek şekline eşit oranlı kare pikselli bir tuvale çizilir ve çerçeveye
- doğrusal olarak sıkıştırılır; panelin kendi çarpıklığı sıkıştırmayı geri alır. Kırpma olmaz,
- hiçbir şey kenardan taşmaz.
-- **Tek ayar hepsini düzeltir** — arkaplan, görselleştirici, logo, yazı ve görsel nesneler aynı
- mantıksal uzayı paylaşır; görselleri tek tek önceden germek gerekmez.
-- **Gözle kalibre edilir.** Sahnenin arkasındaki LED duvarı kimse ölçemez ama bir dairenin
- yuvarlak olup olmadığını herkes görür: daire, kare ya da ızgara desenini açıp kaydırıcıyı
- düzgün görünene kadar oynatın. Panel ölçüsü, gerçek en boy oranı ve elle gerilmiş bir görselin
- boyutu aynı sayıya götüren yardımcı yollardır.
-- **Ekran başına ya da tüm ekranlar için**, ve projeksiyon haritalamasıyla birlikte çalışır:
- kurulmuş bir köşe kalibrasyonu yerinden oynamaz.
-- **Sahnenin değil fiziksel çıkışın özelliğidir** — dışa aktarılan video, yayın ve web kaplaması
- düzeltilmez.
-
----
-
-## Projeksiyon haritalama
-
-
-
-- **Köşe düzeltme** gerçek bir homografi olarak; payda `gl_Position.w` alanına yazılıyor, böylece
- doku perspektif olarak doğru kalıyor.
-- **Ağ bükme**, kontrol noktalarından geçen Catmull-Rom ızgarasıyla.
-- **Kenar harmanlama** çoklu projeksiyon kurulumları için; eğrilerin örtüşme boyunca tam olarak
- 1'e toplandığı test ediliyor.
-- **Ekran başına kırpma, renk düzeltme ve çokgen maskeler**, artı hizalama ızgaraları ve test
- desenleri.
-
----
-
-## Sahne geçişleri
-
-
-
-- **Dokuz grupta 72 bitmiş sahne**: Kulüp, Ambiyans, Yayın, Müzik Videosu, Müzik, Ekran Koruyucu,
- 3B Geometri, Tür ve Etkinlik.
-- **Tek tık**, ve ses aygıtınız, ekran seçiminiz, yayın ve aydınlatma ayarlarınız korunur — bir
- şablonu denemek çalışan kurulumu bozmamalı. Bir test bunu doğruluyor.
-
-
-
-- **Sese tepki veren tipografi**, karakter başına tepkiyle.
-- **LRC ve SRT içe aktarma**; biçim içerikten anlaşılıyor, gelişmiş LRC kelime zamanlamaları
- destekleniyor.
-- **Zamanlama düzenleyici**, LRC'ye geri yazan bir senkron kaydırmasıyla.
-- **Çalan parça bilgisi**, düzenlenebilir; başlık ve sanatçı ayrı katmanlara bağlanabilir.
-
----
-
-## Kayıt ve dışa aktarma
-
-
-
-- **Tek tuşla kayıt**: ekranda göründüğü gibi — canlı sesle, modülasyon, geçiş ve efektler dahil.
-- **MP4, WebM, GIF ve PNG.** GIF iki geçişli palet üretimi kullanıyor, çünkü tek geçiş gözle
- görülür bantlanma yapıyor.
-- **PNG anlık görüntü** 4× çözünürlüğe kadar.
-- **En sık kullanılan en-boy oranları** için hazır profiller.
-- **Çevrimdışı video dışa aktarımı** bir ses dosyasını kare kare, deterministik olarak render
- ediyor — görsel regresyon testlerinin dayandığı özellik de bu.
-
----
-
-## Yayın çıkışı — OBS ve tarayıcı
-
-**Çıkış → Yayın Çıkışı**'nı açın; uygulama bir katman sayfası servis eder.
-
-- OBS'ye **Tarayıcı Kaynağı** olarak ekleyin. Eklenti yok, gerçek saydamlık var.
-- Katman sayfası masaüstü penceresiyle **aynı motoru** çalıştırır; gördüğünüz şey yayına giden şeydir.
-- Ağ üzerinden çalışır, yani görselleştirici bir bilgisayarda, OBS başka birinde olabilir.
-- **Saydamlık uygulamanın kendi anahtarıdır.** **Arkaplan → Şeffaf Arkaplan** açıkken katman OBS'te,
- pencerenin masaüstünde olduğu gibi şeffaftır; kapalıyken sahne gördüğünüz gibi yayına girer. Tek bir
- kaynağı zorlamak için adresine `?transparent=0` ya da `?transparent=1` ekleyin. Spout ve Syphon opak
- kalır: paylaşılan GPU dokusu göndericiyi düşürmeden alfa taşıyamıyor.
-- **Katman sayfası başlayamazsa bunu söylüyor.** v3.1.3'te sayfa açılışta çöküyordu —
- `aspect.js`i hiç yüklemiyordu — ve hata gizli bir kutuda kalıyordu; OBS de tarayıcı da konsolda
- tek satır olmadan boş bir sayfa gösteriyordu (#563). Sayfa artık hatayı gösteriyor ve konsola
- yazıyor; öz test de katman sayfasını her çalıştırmada gerçek yayın sunucusundan açıyor, paketlenmiş
- derlemeler dahil.
-- **Bir şey ters gidince tanı kartı.** Katman adresine `?debug=1` ekleyin; köşedeki kart sayfanın
- bağlı olup olmadığını ve kaç denemede bağlandığını, yapılandırmanın gelip gelmediğini ve ne zaman
- geldiğini, saniyedeki ses karesini ve sonuncunun yaşını, sayfanın kendi kare hızını ve tuval
- boyutunu, kullanılan saydamlığı, sayfayı servis eden uygulamanın sürümünü ve son hatayı — yüklenemeyen
- bir betik dahil — gösterir. Sayfanın geri kalanı gibi çevrilir ve istenmedikçe kapalıdır; öz test
- katman sayfasını her çalıştırmada kartla birlikte açar (#565).
-- **Görselleştirici penceresinin kendisi de üst katman olabilir.** **Arkaplan → Şeffaf Arkaplan**'ı
- açın, pencerenin arkasındaki masaüstü görünür: düz renk boyanmaz, bir arkaplan efektinin koyu
- yerleri **Saydamlık Eşiği**'nin altında saydamlaşır — siyah her zaman, parlak yerler kalır.
- v3.1.4'e kadar bu anahtar görünürde hiçbir şey yapmıyordu: pencere şeffaf doğuyor ama sayfa kendi
- arkaplan rengini satır içi olarak üstüne boyuyordu. Anahtarı değiştirmek açık görselleştirici
- penceresini yeniden kurar, çünkü bir pencerenin şeffaflığı doğduğu anda sabitlenir.
-- **Saydamlık son işlemden sağ çıkıyor.** Efekt zincirinin her geçişi opak alfa yazıyordu; tek bir
- efekt açıkken saydam yayın katmanı da şeffaf pencere de siyah bir dikdörtgene dönüyordu. Saydam
- modda sahne zincire artık ön-çarpımlı giriyor ve örtü sahnenin kendi alfasından geliyor; koyu
- yazılar, dış çizgiler ve gölgeler dolu kalıyor. Işık yayan efektler — bloom, bulanıklık — boş
- piksellere parlamalarını ekliyor; zincir görüntüyü ayrıca kaydırıyorsa (glitch, kromatik sapma,
- ayna) örtü sahnenin kendisinde kalıyor ve kaymış bir kopya boş alanda hayalet olarak belirmiyor.
-
-### Mobil kumanda
-
-
-
-Aynı sunucu, sahneler, şablonlar ve Studio presetleri için telefon boyutunda bir kumanda sayfası da
-barındırıyor; yanında MIDI ve OSC kontrol yüzeyleri.
-
----
-
-## GPU çıkışı — Spout ve Syphon
-
-Görüntü, aynı makinedeki başka bir uygulamaya **GPU üzerinden** verilebilir: pencere yakalama yok,
-eklenti yok, CPU kopyası yok.
-
-- Windows'ta **Spout**, macOS'ta **Syphon**. Alıcılar arasında Resolume, OBS, TouchDesigner,
- MadMapper — bu protokollerden birini konuşan her şey var.
-- Alıcıların arayacağı **kaynak adını**, çözünürlüğü ve kare hızını siz seçersiniz.
-- Kendi gizli penceresinde çizer; bu yüzden hiçbir ekranda görselleştirme penceresi açık olmasa da
- yayın sürer.
-- **Linux'ta yoktur.** Spout bir Windows, Syphon bir macOS teknolojisi ve Linux'ta yerleşik bir
- eşdeğeri yok. Panel bunu söyler ve her platformda çalışan OBS tarayıcı kaynağına yönlendirir.
-
----
-
-## Klasik görünüşler
-
-Uygulamanın ilk günden beri gelen biçimleri, hâlâ tek tık uzakta.
-
-
-
-| Tüm görselleştirici modları | Tüm arkaplanlar |
-|:---:|:---:|
-|  |  |
-
-
-
----
-
-## Her şey, ayrıntısıyla
-
-Yukarıdaki bölümler uygulamanın nasıl göründüğünü gösteriyor. Bu bölüm içinde
-gerçekte ne olduğunu adıyla sayıyor.
-
-### Arkaplanlar — 31 tür
-
-**Akışkan** — **Akışkan Gradyan** (WebGL shader'da sese tepki veren ağ gradyanı; *Yumuşak* ve
-*Plazma* biçimleri, akış hızı, gezinme, yörünge, iç dönüş, bozulma, ölçek, gren, vinyet, ses
-patlaması parlaklığı ve ses ile renk kayması) · **Mürekkep** (akarken burulan sıvı damlalar: damla
-sayısı, akışkanlık, burulma, yayılma) · **Bulutsu** (üst üste binen yumuşak gaz bulutları: katman
-sayısı, boyut, yumuşaklık, yoğunluk) · **Dalga Katmanları** (sesle kabaran tepeler: katman sayısı,
-tepe yüksekliği, dalga sıklığı, açıklık, saydamlık) · **Kutup Işıkları** (dalgalanan ışık perdeleri:
-perde sayısı, kalınlık, dalgalanma, kenar yumuşaklığı, dikey konum)
-
-**Geometrik** — **Retro Izgara** (ufka giden perspektif ızgara: ufuk yüksekliği, satır ve sütun
-sayısı, çizgi kalınlığı, ufuk parlaması, gökyüzü yoğunluğu, spektrum tepkisi) · **Petek Izgara**
-(merkezden yayılan dalgayla ve spektrumla aydınlanan altıgen hücreler) · **Mozaik** (düzensiz hücre
-ızgarası; her hücre bir frekans bandını izler) · **Koridor** (izleyiciye gelen halkalar ya da
-çokgenler: halka sayısı, hız, kenar sayısı, burulma) · **Sarmal** (dönen çok kollu sarmal: kol
-sayısı, tur, incelme) · **Nabız Halkaları** (merkezden genişleyen halkalar, bas vuruşlarında ek
-halkalar: doğma hızı, genişleme, kalınlık, sönme) · **Ağ** (yakın komşularına bağlanan sürüklenen
-düğümler: düğüm sayısı ve boyutu, bağlantı mesafesi, çizgi kalınlığı, hız)
-
-**Atmosfer** — **Yıldız Alanı** (merkezden akan yıldızlar: sayı, boyut, hız izi, derinlik,
-parıldama) · **Kar / Kor** (derinlikle salınarak düşen parçacıklar) · **Işık Parçacıkları** (odak
-dışı yumuşak toplar: sayı, boyut, boyut çeşitliliği, süzülme, bas nabzı) · **Dijital Yağmur** (düşen
-parlak çizgiler: sütun sayısı, düşme hızı, iz uzunluğu, yoğunluk, kalınlık) · **Şehir** (pencereleri
-müzikle yanan iki katmanlı paralaks silüet)
-
-**Üretken** — **Sıvı Metal** · **Plazma** · **Su Yüzeyi** · **Şeritler** · **Eşyükselti** ·
-**Dalga Alanı** · **Kıvılcım** · **Kum** · **Vitray** · **Devre Kartı** · **Prizma** ·
-**Küre Ağı** · **Tel Tüneli** · **Petek Nabzı**
-
-**Diğer** — **Studio Preseti** (kendi yazdığınız GLSL shader) · **Düz Renk**
-
-Beş renk durağı, yedi grupta **58 yerleşik palet** (Klasikler, Sıcak, Soğuk, Neon ve Siber, Karanlık,
-Aydınlık, Tek Renk Aileleri) ve kendi kaydettiğiniz paletler her arkaplan türünde, Studio motorunda ve
-3B motorda geçerlidir.
-
-### Görselleştirici — 48 mod
-
-**Temel** — **Barlar** · **Merkez** · **Segment** (LED ekolayzer) · **Nokta Matris** ·
-**Şehir Silüeti** (pencereleri yanan binalar)
-
-**Dalga formu** — **Dalga** (osiloskop) · **Şerit** (dalga formu geçmişi) · **3B Dalga** (geçmiş
-perspektifte üst üste) · **Lissajous** (XY osiloskop) · **Teller** (her tel kendi bandıyla titrer) ·
-**Arazi** (perspektif tel kafes manzara)
-
-**Işınsal** — **Çember** · **Dairesel Dalga** · **Işın** · **Yaylar** (bant başına bir yay) ·
-**Fırıldak** · **Mandala** (kutupsal gül eğrisi) · **Kaleydoskop** · **Girdap** · **Sarmal** ·
-**Tünel** · **Küre**
-
-**Parçacık ve olaylar** — **Parçacık** · **Havai Fişek** (vuruşta patlamalar) · **Şimşek** (basta
-dallanan yıldırımlar) · **Baloncuk** · **Sıvı Damla** (metaball) · **Dalgalı Izgara** (vuruşta
-yayılan halkalar) · **Spektrogram**
-
-**Üretken** — **Akış Alanı** (gürültü alanında sürülen parçacıklar) · **Sürü** (spektrumla sürülen
-boid'ler) · **Voronoi** · **Truchet** · **Moiré** · **Dalga Girişimi** · **İpler** (vuruşla
-tekmelenen verlet fiziği) · **Galaksi** · **DNA Sarmalı** · **İzometrik Şehir** · **Çekici Alanı**
-(formül kitaplığından ayrık haritalar; iki parametresi sese bağlı)
-
-**Ölçüm** — **Osiloskop (XY)** · **Gonyometre** (stereo faz göstergesi) · **Kroma Çemberi**
-(beşliler çemberi sırasında nota sınıfları; algılanan akorun kökü vurgulanır)
-
-**Motorlar** — **3B Geometri** · **MilkDrop** · **Geri Besleme** · **Metin / Şarkı Sözü** ·
-**Studio Preseti**
-
-Bar sayısı, min ve maks frekans, boşluk, yerleşim, ayna, çizgi kalınlığı, genlik, duyarlılık ve
-parlama, seçili mod için anlamlı oldukları her yerde görünür. **Gökkuşağı** kapatılıp tek ya da çift
-renk seçilebilir.
-
-### Tayf ölçümü
-
-- **Frekans ölçeği** — logaritmik, doğrusal, mel ya da bark.
-- **Genlik ölçeği** — doğrusal ya da desibel; taban −24 ile −96 dB arasında ayarlanır.
-- **Atak ve bırakma** ayrı zaman sabitleri olarak, kare hızından bağımsız.
-- **Komşu yayılımı** (tepeleri ezmeden genişletir) ve **profil yumuşatma** (simetrik komşu
- ortalaması).
-- **Eğim**, oktav başına dB; 1 kHz'de nötr.
-- **Bar yerleşimi** — genişlik, yatay konum, yükseklik ve taban çizgisi; her biri kadranın oranı.
-
-### Katmanlar, maskeler ve gruplar
-
-- Sınırsız katman; her birinin kendi kaynağı, karışım modu, saydamlığı, dönüşümü (ölçek, döndürme,
- X/Y, çevirme) ve ses tepkisi (bant, saydamlık, ölçek, döndürme) var.
-- **17 karışım modu** — Normal, Toplama, Ekran, Çarpma, Kaplama, Koyulaştır, Açıklaştır, Renk
- Soldurma, Renk Yakma, Sert Işık, Yumuşak Işık, Fark, Dışlama, Renk Tonu, Doygunluk, Renk,
- Parlaklık.
-- **Maskeler** — başka bir katmandan alfa, ayrıca dikdörtgen, elips, doğrusal ve ışınsal gradyan;
- konum, boyut, açı, yumuşatma ve tersine çevirmeyle.
-- Tek fader'lı **gruplar** ve eşit güç eğrisinde **A/B çapraz geçişi**.
-- **Solo, sessiz ve kilit** — solo bir katmanı geri alınabilir biçimde yalnız bırakır, sessiz
- ayarlarını kaybetmeden gizler, kilit kazara düzenlemeyi engeller.
-- Bileşik zincire ek olarak **katman başına efekt zinciri**.
-- Katmanları sahneler arasında kopyala, yapıştır ve çoğalt.
-- Yığının tamamı kapatılabilir; liste kaybolmadan yalın Arkaplan + Görselleştirici kurulumuna
- dönülür.
-
-### Son işlem — 40 efekt
-
-**Kompozisyon** — Bloom · Parlama · Vinyet · İzler / Eko · Kenar Vurgusu · Renk Derecelendirme
-
-**Bulanıklık ve odak** — Gauss Bulanıklığı · Işınsal Bulanıklık · Yönlü Bulanıklık · Zum
-Bulanıklığı · Tilt-Shift · Alan Derinliği (Bokeh) · Keskinleştirme · Kabartma
-
-**Halftone ve desen** — Dither (Bayer) · Halftone · ASCII Mozaik · Çapraz Tarama · Yağlı Boya
-(Kuwahara) · Pikselleştirme · Posterize / Ters Çevirme · Eşik · Solarize
-
-**Analog ve bozulma** — Film Greni · CRT / Tarama Çizgileri · VHS / Analog Bant · Glitch (Dilim
-Kaydırma) · Datamosh (Blok Kaydırma) · Bozuk Sinyal · Renk Kayması
-
-**Bozunma** — Lens Bozulması · Burgu · Kutupsal Dönüşüm · Dalgacık Bozulması · Slit-Scan ·
-Kaleydoskop · Ayna
-
-**Renk ve ışık** — Gradyan Eşleme · Seviyeler ve Eğri · Tanrı Işınları · Yıldız Filtresi
-
-Her biri sıralanabilir, kendi saydamlığı vardır, açılıp kapatılabilir ve her parametresi modülasyon
-matrisiyle sürülebilir.
-
-### Sahne geçişleri — 18
-
-**Kesme** · **Çapraz Geçiş** · **Erime** · **Silme** · **Işınsal** · **Saat** · **Kanat** ·
-**Panjur** · **Şeritler** · **Dama** · **İris** · **Parlaklık** (giden karenin kendi parlaklığına
-göre, kendi aralığına normalize edilerek) · **Zum** · **İtme** · **Kaydırma** · **Flaş** ·
-**Glitch** · **Bulanıklık**
-
-Altı yumuşatma eğrisi — doğrusal, yumuşak, yavaş giriş, yavaş çıkış, yavaş giriş-çıkış ve ani —
-artı saniye ya da vuruş cinsinden süre. Geçişler tamamen kapatılabilir ve herhangi bir ayar değil
-**sahne** değiştiğinde tetiklenir; kaydırıcı sürüklemek geçiş başlatmaz.
-
-### Modülasyon
-
-**Kaynaklar** — bas, orta, tiz, seviye, vuruş zarfı ve vuruş tetiği · sekiz spektrum bandı · dört ve
-üzeri LFO · iki ve üzeri zarf takipçisi · örnekle-ve-tut · rastgele · vuruş saati · makro düğmeleri ·
-ve tüm derin çözümleme ölçümleri.
-
-**LFO şekilleri** — sinüs, üçgen, yükselen testere, alçalan testere, kare, darbe, rastgele rampa ve
-gürültü; hız Hz cinsinden ya da algılanan tempoya kilitli vuruş bölmeleriyle (1/16'dan 8 ölçüye),
-artı faz kaydırma ve darbe genişliği.
-
-**Yönlendirme** — herhangi bir kaynaktan, mevcut ayarların canlı ağacından seçilen herhangi bir
-yapılandırma yoluna. Her yönlendirmenin alt sınırı, üst sınırı, miktarı, kipi (ata ya da ekle),
-eğrisi (doğrusal, üs, S eğrisi, kuantalama, ters çevirme) ve kendi yumuşatma ile eğim sınırlaması
-vardır.
-
-**Makrolar** — sekiz atanabilir düğme; MIDI öğretmeye ve mobil kumandaya açık.
-
-Değerler kopyala-yaz ile uygulanır, yani modülasyon kayıtlı ayarlarınızı hiç değiştirmez; LFO fazı
-biriktirilmek yerine çizim saatinden hesaplanır, böylece çevrimdışı dışa aktarma kare kare kesindir.
-
-### Derin ses çözümlemesi
-
-Kroma vektörü (sabit-Q Goertzel filtre bankası), tonalite (Krumhansl-Schmuckler profilleri), şablon
-tabanlı akor, armonik/vurmalı ayrıştırması, kick/snare/hat için bant başına vuruş algılama, tınısal
-merkez, dönüm, düzlük ve tepe faktörü, gürlük, dinamik, gerçek tepe, stereo genişlik, korelasyon,
-mid/side bantları, temel frekans (YIN), sessizlik algılama ve otomatik kazanç, artı kayan tayf
-geçmişi tamponu. Hepsinin canlı ölçeri var ve hepsi modülasyon kaynağı olarak kullanılabilir.
-
-### 3B geometri — 98 formül ve 13 katı cisim
-
-**Düzlem eğrileri (30)** — gül eğrileri, lemniskatlar, kardioidler, epizikloidler, hipozikloidler,
-sarmallar, ruletler, Lissajous şekilleri, kelebek ve süperformül eğrileri bunlar arasında.
-
-**Uzay eğrileri (12)** — yonca ve simit düğümleri, Viviani eğrisi, helisler, konik sarmallar ve
-benzerleri.
-
-**Yüzeyler (29)** — simit, Klein şişesi, Möbius şeridi, Boy yüzeyi, Dini yüzeyi, breather,
-süperelipsoid, Gielis süpershape'leri, Chladni şekilleri, yonca borusu ve daha fazlası.
-
-**Çekiciler (27)** — Lorenz, Rössler, Chen, Halvorsen, Thomas, Aizawa, Chua, Dadras, Sprott,
-Clifford, de Jong, Hénon ve diğerleri; hem sürekli hem ayrık.
-
-**Katı cisimler (13)** — dörtyüzlü, küp, sekizyüzlü, onikiyüzlü, yirmiyüzlü, alt bölme denetimli
-jeodezik küre, dört L-sistemi (ağaç, eğrelti, ejderha eğrisi, 3B Hilbert eğrisi) ve üç yinelemeli
-fonksiyon sistemi (Barnsley eğreltisi, Sierpinski dörtyüzlüsü, sarmal).
-
-Tel kafes, nokta ya da gölgeli olarak çizilir; çözünürlük, deformasyon, dönüş, renk kipi ve her
-parametrede ses bağlama vardır. Matematik projenin kendi matematiğidir — üçüncü parti 3B kütüphanesi
-yok — ve kadraj elle bildirilmek yerine her sistemin gerçek sınırlayıcı kutusundan ölçülür.
-
-### Studio — 42 yerleşik shader
-
-**Arkaplanlar (25)** — Bulut Katmanları · Kıvrım Akışı · Lav Lambası · Mürekkep Yayılması · Duman
-Halkaları · Petek Akışı · Bükülmüş Izgara · Truchet Dokuması · Moiré Girişimi · Kristal Mağara ·
-Mandelbrot Zumu · Julia Kümesi · Burning Ship · Apollon Contası · Kaleydoskopik IFS · Menger
-Süngeri · Mandelbulb · Işık Tüneli · Yıldız Sıçraması · Kutup Perdesi · Sıvı Metal · Neon Yağmur ·
-Tepkime Deseni · Su Kostikleri · Prizma Parıltısı
-
-**Görselleştiriciler (11)** — Parlayan Barlar · Spektrum Halkası · Dalga Alanı · Vuruş Patlaması ·
-Parlayan Osiloskop · Frekans Ağı · Nota Halkası · Parçacık Akışı · Kaleydoskop Spektrumu · Nabız
-Izgarası · Sıvı Barlar
-
-**Artı altı önceki preset** — Plazma Deniz, Frekans Halkaları, Sıvı Metal, Yıldız Geçidi, Dalga
-Perdesi, Bas Küresi.
-
-Düzenleyici canlı önizleme, hata satırı bildirimi ve kendi tanımladığınız kaydırıcıları verir.
-Shader'lar `sv_resolution`, `sv_time`, `sv_level`, `sv_bass`, `sv_mid`, `sv_treble`, `sv_beat`,
-`sv_spec(x)`, `sv_waveAt(x)`, kullanıcının paleti için `sv_col(x)` ve kamera/video katmanı için
-`sv_media` alır. Shadertoy ve ISF presetleri yerel dönüştürücülerle içe aktarılır.
-
-### MilkDrop
-
-Preset dili gerçekten çalışıyor: sözcük çözümleyici, AST'ye ayrıştırıcı, JavaScript kapanışlarına
-derleme, değişken havuzu (`q1`–`q32`, `t1`–`t8`, `regNN`), yerleşik fonksiyon kitaplığı — her
-yerleşik sonlu bir sayı döndürür, `log(0)` ve sıfıra bölme dahil — kare başına denklemler, warp ağı
-boyunca piksel başına denklemler ve geri besleme çizici. `.milk` dosyaları tek tek ya da paket
-olarak içe aktarılır; derleme hataları dosya dosya bildirilir.
-
-### Metin ve şarkı sözü
-
-Yazı tipi, kalınlık, boyut, hizalama, X/Y konumu, saydamlık, kontur ve gölge · süreli canlandırma
-presetleri · ölçek, titreme ve kaldırmayla karakter başına ses tepkisi · kayan yazı ve bant ·
-karaoke vurgusu · biçimi içerikten anlaşılan LRC ve SRT içe aktarma, gelişmiş LRC kelime
-zamanlamalarıyla · LRC'ye geri yazan senkron kaydırması · çalan parça bilgisi; tek satır olarak ya
-da ayrı başlık ve sanatçı katmanları olarak bağlanabilir.
-
-### Medya katmanı
-
-Web kamerası ya da video dosyası; görselleştiricinin önüne ya da arkasına yerleşir. Sığdırma
-(kapla, sığdır, ger), aynalama, 3–12 dilimli kaleydoskop, renk kayması, doygunluk, karışım modu,
-saydamlık ve sese bağlı yakınlaşma ile saydamlık. Aynı kare Studio shader'larında `sv_media` olarak
-okunabilir.
-
-### Sahneler, şablonlar ve sahne üreticisi
-
-- **Sahneler** görünüşün tamamını — arkaplan, görselleştirici, katmanlar, logo ve görsel nesneler —
- bir adla saklar. Tek tıkla geri yüklenir, mevcut görünüşten güncellenir, JSON olarak dışa/içe
- aktarılır.
-- Dokuz grupta **72 şablon**:
- - *Kulüp (8)* — Strobe Wall, Hyper Tunnel, Laser Grid, Mandala Drop, Strobe Floor, Fireworks,
- MilkDrop Flow, Strange Attractor
- - *Ambiyans (9)* — Aurora, Ink in Water, Topography, Underwater, Embers, Liquid Metal, Night
- Globe, Flow Field, Interference
- - *Yayın (6)* — Corner Bars, Clean Wave, Ring Meter, Scope Overlay, Lower Third, Studio Meters
- - *Müzik Videosu (8)* — Label Card, Artwork Card, Baseline Bars, Amber Room, Minimal White, Quiet
- Frame, Corner Meter, Centre Strip
- - *Müzik (6)* — Chroma Wheel, Helix, Silk Ribbons, Strings, Spectrogram, Galaxy
- - *Ekran Koruyucu (6)* — Plasma, Stained Glass, Circuit, Wire Tunnel, Dunes, Prism
- - *3B Geometri (8)* — Klein Bottle, Lorenz, Supershape, Trefoil Tube, Chladni, Rose Curve, Chua
- Circuit, Möbius
- - *Tür (16)* — Techno, House, Drum & Bass, Hip-Hop, Lo-Fi, Synthwave, Rock, Metal, Jazz,
- Classical, Ambient, Pop, Trance, Dubstep, Chiptune, Experimental
- - *Etkinlik (5)* — Minimal Line, Corporate, Gala, Festival, Projection Test
-- **Sahne Üreticisi** bir tarifden sahne kurar. Sinir ağı **değildir** ve öyle sunulmaz: metni
- ağırlıklı bir anahtar kelime sözlüğüyle dört eksene indirger ve deterministik bir üreteci bu
- eksenlerden tohumlar. Tamamen çevrimdışı çalışır.
-- Sahneler ve renk paletleri genel ayar yedeğinin **dışındadır** ve yedek içe aktarıldığında
- korunur; her birinin kendi dışa/içe aktarımı vardır.
-
-### Logo, görsel ve görsel nesneler
-
-- **Logo** — kadranın istediğiniz yerine konan, boyutu otomatik ayarlanan bir görsel; boyut,
- saydamlık, parlama, X/Y konumu ve ses nabzıyla. Şablon uygulamak logo dosyasını değiştirmez,
- yalnızca yerleşimini değiştirir.
-- **Görsel nesneler** — görselleştiricinin önüne ya da arkasına yerleşen resim nesneleri; sayı,
- boyut, süzülme, dönme ve ses tepkisiyle.
-
-### Ses
-
-- **Sistem çıkışı** (loopback), **mikrofon ve giriş aygıtları** ya da aynı anda birden çok kaynak;
- çözümlemeden önce karıştırılır.
-- Çıkış aygıtları Windows'ta WASAPI loopback, macOS'ta CoreAudio ile; Linux'ta aynı sinyali
- PulseAudio ya da PipeWire **monitor** kaynağı taşır. Giriş aygıtları yerel `audify`
- modülüyle doğrudan yakalanır.
-- Duyarlılık, yumuşatma ve bas vurgusu; genel, bas, orta ve tiz için canlı ölçerler.
-
-### Kayıt ve video dışa aktarma
-
-- Çıkışın göründüğü gibi **canlı kaydı** — canlı sesle, modülasyon, geçiş ve efektler dahil — MP4
- ya da WebM olarak.
-- İki geçişli palet üretimiyle **GIF dışa aktarma**; tek geçiş gözle görülür bantlanma yapıyor.
-- Kısayolla 4×'e kadar **PNG anlık görüntü**.
-- Sık kullanılan hedefler için **en-boy oranı profilleri**.
-- **Çevrimdışı dışa aktarma** seçilen ses dosyasını ayarlanabilir çözünürlük, kare hızı, kalite ve
- kodlayıcıyla MP4'e render eder; ilerleme, iptal ve GPU'dan CPU'ya geri düşüşle. Kare kare kesin ve
- deterministiktir — görsel regresyon testlerinin dayandığı özellik de bu.
-
-### Basıklık düzeltme
-
-Pikselleri kare olmayan ekranları düzeltir · hazır kareyi germek yerine sahneyi panelin gerçek
-oranında çizer, böylece kırpma ve siyah bant oluşmaz · arkaplan, görselleştirici, logo ve yazıyı
-birlikte düzeltir · daire, kare ya da ızgara deseniyle gözle kalibre edilir · ekran başına ya da
-tüm ekranlar · Windows, macOS ve Linux.
-
-### Projeksiyon haritalama
-
-Gerçek homografi olarak köşe düzeltme · Catmull-Rom ağ bükme · ekran başına kırpma · ekran başına
-renk düzeltme · Bézier çokgen maskeleri · çoklu projeksiyon için kenar harmanlama · hizalama
-ızgaraları, artılar, renk çubukları ve odak halkaları · sürükleme, ok tuşuyla ince ayar ve tam
-sayısal giriş.
-
-### Kontrol yüzeyleri
-
-- **MIDI** — kontrolü öğret, sonra herhangi bir CC ya da notayı herhangi bir ayara veya eyleme bağla.
-- **OSC** — elle yazılmış OSC 1.0 ayrıştırıcılı UDP dinleyici.
-- **Art-Net / DMX** — ArtDMX çıkışı; paket düzeni bayt bayt test edilmiş.
-- **Mobil kumanda** — OBS katmanını barındıran aynı sunucudan, telefonla sahneler, şablonlar ve
- Studio presetleri.
-- **Tempo** — periyot histogramından BPM kestirimi, elle tempoya vurma ve BPM kilidi.
-- **Otomatik VJ** — ölçüye hizalı sahne, görselleştirici ve palet değişimleri. Hangilerinin
- dolaşacağını tek tek seçebilir ya da boş bırakıp hepsini kullanabilirsiniz; renk şablonlarını
- hazır olanlarla ya da kendi yaptıklarınızla sınırlayabilir, her görselleştirici katmanına ayrı
- mod verebilirsiniz. Durum satırı ne değiştiğini, sıradakini ve kaynak boşsa neden hiçbir şey
- olamayacağını yazar.
-
-### Windows Dynamic Lighting
-
-- Varsayılan olarak kapalıdır ve yalnızca uyumlu aygıtlar algılandığında görünür.
-- Dinamik modlar: görselleştirici renk akışı, bar-spektrum eşlemesi, gelişmiş bas/orta/tiz bölgeleri,
- arkaplan ışığı senkronu, senkron vuruş flaşları, frekans dalgacıkları, bar ve arkaplan füzyonu,
- aygıtlar arası renk akışı, gökkuşağı akışı ve eşik tetikli arkaplan patlamaları.
-- Eşik patlamaları tam olarak seçilen tek bir kaynağı (bas, orta, tiz, genel seviye ya da en güçlü
- bant) izler ve yalnızca eşiği aşınca tetiklenir. Parlaklık eşiğin üstünde kalan miktara göre
- ölçeklenir; renk gerçek arkaplan piksellerinden gelir.
-- Bant tepkisi anlık/sert, vurgulu/sert ya da yumuşak/akışkan olabilir; eşik, sertlik, atak, bırakma
- ve bant ayrımı ayarlanabilir. Gökkuşağı LED'ler boyunca sırayla ya da tek ortak ton olarak
- çalışabilir ve seçilen bir bandın parlaklığına tepki verebilir.
-- Elle modlar: tüm aygıtlarda tek renk, aygıt başına renk ve donanım destekliyorsa LED/bölge başına
- renk.
-- Parlaklık, ses tepkisi, yumuşatma, güncelleme hızı, LED düzeni, palet kaynağı, bant başına renk ve
- duyarlılık, flaş eşiği, gücü ve sönümü, dalgacık hızı, yönü ve genişliği ile renk yayılımı ayrı
- ayrı ayarlanır.
-- Kurulum paketi Windows arkaplan aydınlatma kimliğini otomatik kaydeder. Taşınabilir sürüm
- kaydetmez ve aydınlatmayı yalnızca uygulama öndeyken denetler — arkaplanda sürmesi gerekiyorsa
- kurulum paketini kullanın ve uygulamayı Windows **Dynamic Lighting → Arkaplan ışık denetimi**
- listesinde üst sıralara alın.
-
-### Diğer platformlarda RGB aydınlatma — OpenRGB
-
-Dynamic Lighting bir Windows hizmeti; bu yüzden macOS ve Linux'ta o kart yerine bunu söyleyen bir
-not çıkıyor. O platformlarda cevap **OpenRGB**, Windows'ta ise ek bir seçenek:
-
-- Çalışan bir **OpenRGB** sunucusuyla kendi protokolü üzerinden konuşur (öntanımlı TCP 6742) — üretici
- yazılımı yok, sürücü yok, sunucu başka bir makinede bile olabilir.
-- OpenRGB'nin gösterdiği her aygıtı, donanım izin verdiğinde LED başına sürer; **Windows Dynamic
- Lighting ile aynı modları ve aynı renk matematiğini** kullanır. İkisi tek bir çizici paylaşıyor,
- yani bir sahne hangi yoldan geçerse geçsin aynı görünür.
-- Aygıtlar LED sayılarıyla listelenir; doğrudan denetimi kabul etmeyen bir aygıt, renkleri sessizce
- yutmak yerine bunu söyler.
-- Öntanımlı olarak kapalı ve yalnızca OpenRGB sunucusu çalışırken işe yarar — panel, sessizce
- başarısız olmak yerine bağlantı durumunu bildirir.
-
-### Ayar yedeği ve geri yükleme
-
-- Tüm uygulama ayarlarını tek bir JSON dosyasına aktarır: ses, görseller, Dynamic Lighting,
- performans, logo, görsel nesneler, ekran seçimi ve video dışa aktarma.
-- Kullanıcının oluşturduğu **renk paletleri ve sahneler** bilinçli olarak dışarıda tutulur ve içe
- aktarımda korunur; her birinin kendi dışa/içe aktarımı vardır.
-- İçe aktarılan ayarlar güncel varsayılanlarla birleştirilir, böylece yeni alanlar geçerli kalır.
- 1.3 ve 2.0 ile yazılmış dosyalar tek bir değer kaybetmeden açılır ve bunu bir test kanıtlar.
-
-### Aynı anda iki kopya
-
-Geliştirme, kurulu ve taşınabilir (portable) derlemelerin hepsi ayarlarını tek bir klasörde tutar.
-İkisini birlikte çalıştırmak, en son kaydedenin öbürünün ayarlarını sessizce değiştirmesi demekti.
-
-- **İkinci kopya açılışta sorar.** Zaten çalışan kopyayı tanıtır — kurulu, taşınabilir ya da
- geliştirme; sürümü, ne zaman açıldığı ve nerede durduğu — ve ona geçmeyi (o kopyanın paneli öne
- gelir) ya da yine de açmayı önerir.
-- **Birden fazla kopya çalışırken her kopyanın paneli bunu söyler**; öbür kopya kapanınca uyarı
- kalkar. Aynı klasörde koşan bir öz test, öz test olarak görünür.
-- **Bir kopya, başkasının değiştirdiği ayarların üstüne sessizce yazmaz.** `settings.json` bu
- kopyanın son okuduğu ya da yazdığı hâlden farklıysa kaydetmeyi durdurur ve sorar: diskteki
- ayarları yükle ya da kendi ayarlarını onların üstüne kaydet. Başlangıç denetimine hiç katılmayan
- eski sürümler ve dosyanın elle düzenlenmesi de buna dahildir. Dosyaya içeriğini değiştirmeden
- dokunmak — bir yedekleme aracı ya da aynı içeriği geri yazan öz test — değişiklik sayılmaz.
-
-### Güç ve performans
-
-- **Kare hızı** — *Ekranla Eşle* (tazeleme başına bir kare, en akıcısı) ya da 120, 60, 30 FPS sınırı.
- Sınır tazeleme hızının tam böleni değilse (75 Hz ekranda 60 gibi) uzun vadeli ortalama doğru kalır
- ama kare aralıkları düzensizleşir; bu yüzden *Ekranla Eşle* önerilir.
-- Arkaplan çözünürlük ölçeği, sessizlikte duraklat, imleci gizle.
-
-### Uygulama ayarları (⚙ menüsü)
-
-- **Dil** — otomatik (sistem), Türkçe ya da İngilizce.
-- **Görselleştirmeyi Her Zaman Üstte Tut** *(varsayılan kapalı)* — görselleştirme penceresi odağı
- kaybettiğinde kendini yeniden öne alır.
-- **Genişletilmiş Ayar Aralıkları** *(varsayılan kapalı)* — kaydırıcıların üst sınırını 5×
- yükseltir. Algoritma gereği gerçekten sınırlı olan birkaç ayar (yumuşatma, arkaplan çözünürlüğü)
- hariçtir. Kapatınca girilmiş yüksek değerler korunur.
-
----
-
-## Nedir
-
-Tek motor, dört çıkış yolu:
-
-- **Yönetici paneli** — her ayarın canlı değiştirildiği kontrol ekranı.
-- **Görselleştirme pencereleri** — seçtiğiniz *her* ekranda tam ekran.
-- **Yayın sayfası** — OBS için saydam bir katman, artı telefonunuz için kumanda.
-- **Spout / Syphon** — karenin GPU üzerinden doğrudan başka bir uygulamaya verilmesi
- (Windows ve macOS).
-
-Ses; **sistem çıkış aygıtlarından** (hoparlör veya kulaklık loopback), **mikrofon ve giriş
-aygıtlarından** ya da aynı anda birden çok kaynaktan gelir ve yerel `audify` modülüyle FFT
-çözümlemesinden önce karıştırılır.
-
----
-
-## Ses yakalama nasıl çalışır
-
-Yakalama tarayıcı penceresinde değil, **ana süreçte** çalışır. Yerel modül seçilen aygıtı
-— Windows'ta WASAPI loopback, macOS'ta CoreAudio, Linux'ta PulseAudio ya da PipeWire ile —
-okur, FFT'yi hesaplar ve kareleri arayüze gönderir.
-
-- **Sistem sesi** doğrudan çıkış aygıtından yakalanır — "stereo mix" gerekmez.
-- **Mikrofon ve hat girişleri** aynı yolla yakalanır.
-- **Birden çok kaynak** çözümlemeden önce karıştırılır.
-- **İki kanal da görsellere ulaşır.** Her kare, tayfın hesaplandığı mono karışımın yanında sol ve sağ
- kanalı da taşır; stereo genişliği, korelasyon ve Gonyometre gerçek stereo görüntüyü ölçer.
- v3.1.5'e kadar yakalama yardımcısı iki kanalı başka hiçbir şey görmeden ortalayıp atıyordu:
- genişlik 0'da, korelasyon 1'de kalıyor, Gonyometre her şarkıda dikey bir çizgi çiziyordu. Tek
- kanallı bir aygıt iki tarafa aynı örneği verir; bu da doğru biçimde genişlik 0 okunur.
-- **macOS'ta** sistem sesini yakalamak için **BlackHole** gibi sanal bir aygıt gerekir; mikrofon
- doğrudan çalışır. macOS'un kendi loopback'i yok, bunun etrafından dolaşmanın yolu da yok.
-- **Linux'ta** sistem sesi, çıkış aygıtınızın PulseAudio ya da PipeWire **monitor**'üdür. Bu bir
- *giriş* aygıtıdır; uygulama onu loopback olarak işaretler ve öntanımlı olarak tercih eder.
-
----
-
-## Geliştirme ortamında çalıştırma
-
-```bash
-npm install
-```
-
-```bash
-npm start
-```
-
-Geliştirici kipi (DevTools açık):
-
-```bash
-npm run dev
-```
-
-> `npm install` kurumsal ağ/proxy yüzünden sertifika hatası verirse PowerShell'de
-> `$env:NODE_OPTIONS="--use-system-ca"` ile yeniden deneyin.
-
-> **Kaynaktan** çalıştırmak için **Node.js** gerekir. Sürüm paketleri için gerekmez: ses yardımcısı
-> Electron'un kendi ikilisi altında çalışır (`ELECTRON_RUN_AS_NODE`), bu yüzden üç platformun
-> hiçbirinde yanına bir şey kurmak gerekmez.
-
----
-
-## Paketleme / dağıtım
+## Derleme ve dağıtım
```bash
npm run icons
@@ -1097,63 +1568,58 @@ npm run dist:mac:arm64
npm run dist:linux
```
-| Platform | Çıktı | Nerede paketlenir |
-|----------|-------|-------------------|
+| Platform | Çıktı | Derlendiği yer |
+|----------|-------|----------------|
| Windows | `CAYADEV Visualizer Setup ….exe` (kurulum), `…-portable.exe` | Windows |
| macOS | `….dmg` ve `….zip` (içinde `.app`) — Apple Silicon | macOS |
| Linux | `….AppImage` ve `….deb` — x64 | Linux |
-**Her platform kendi üzerinde paketlenir.** `audify` yerel bir modül ve **çapraz derlenemez**:
-Windows'ta üretilen bir macOS paketinde arayüz görünür ama ses yakalanmaz. Bu yüzden GitHub Actions
-iş akışı macOS'u `macos-latest`, Linux'u `ubuntu-latest` üzerinde paketliyor. Windows ise CI'da
-değil, yerelde paketleniyor: kurulum Dynamic Lighting kimliğini kaydediyor ve bu, koşucuda olmayan
-bir sertifika istiyor — CI'da üretilmiş bir kurulum başka bir ürün olurdu.
+**Her platform kendi üzerinde derleniyor.** `audify` yerel bir modül ve **çapraz derlenemiyor**:
+Windows'ta üretilen bir macOS paketi arayüzü gösterir ama ses yakalamaz. Bu yüzden GitHub Actions iş
+akışı macOS'u `macos-latest`, Linux'u `ubuntu-latest` üzerinde derliyor. Windows CI yerine yerelde
+derleniyor, çünkü kurulum programı Dynamic Lighting kimliğini kaydediyor ve bunun için CI makinesinde
+olmayan bir sertifika gerekiyor — CI'de derlenen bir kurulum farklı bir ürün olurdu.
-**macOS paketleri imzasızdır** ve noter onayı yoktur. macOS, imzasız indirmeleri karantinaya alıp
-*hasarlı ve açılamıyor* diye bildirir; macOS 15 ve sonrasında sağ tık → **Aç** bunu temizlemez.
-Uygulamayı Applications klasörüne sürükleyin ve bayrağı bir kez kaldırın:
+### macOS'ta ilk açılış
+
+**macOS paketleri imzasız** ve onaylı değil. macOS imzasız indirmeleri karantinaya alıyor ve *hasarlı,
+açılamıyor* diyor; macOS 15 ve sonrasında sağ tıklayıp **Aç**'ı seçmek bunu kaldırmıyor. Uygulamayı
+Uygulamalar'a sürükleyin ve bayrağı bir kez kaldırın:
```bash
xattr -dr com.apple.quarantine "/Applications/CAYADEV Visualizer.app"
```
-Sonrasında her seferinde normal açılır. Orada sistem sesini yakalamak için ayrıca **BlackHole**
-gibi sanal bir aygıt gerekir.
+Sonra her seferinde normal açılıyor. Orada sistem sesini yakalamak için ayrıca **BlackHole** gibi sanal
+bir aygıt gerekiyor.
-**Linux** PulseAudio ya da PipeWire ister. `.deb` bağımlılıkları arasında `libpulse0` bildiriliyor;
-AppImage de aynı kitaplığın halihazırda kurulu olmasını bekliyor.
+**Linux** PulseAudio ya da PipeWire istiyor. `.deb` bağımlılıkları arasında `libpulse0`'ı bildiriyor;
+AppImage aynı kitaplığın zaten kurulu olmasını bekliyor.
### Dosyaları sürüme yükleme
-Sürümün varlık listesinde her dosyanın yanında görünen açıklama (`(Windows — installer)` gibi)
-`gh release upload dosya#etiket` biçimiyle elle yazılıyordu ve v3.1.3'te unutuldu — altı dosya da
-etiketsiz yayımlandı. Tablo artık bir betikte:
+Bir sürümün dosya listesinde her dosyanın yanındaki açıklama `gh release upload dosya#etiket` ile
+yazılıyor. Tablo bir betikte duruyor:
```bash
npm run release:assets -- v3.1.3 --dir=
```
-Beklenen dosyaları `dist/` altında ve `--dir` ile verilen klasörlerde arıyor (bir seviye alt klasör
-dahil; `gh run download` çıktıları böyle yerleştiriyor), altısı birden bulunmazsa hiçbirini
-yüklemiyor ve yüklemeden sonra sürümü yeniden okuyup etiketlerin gerçekten yazıldığını doğruluyor.
-`--dry-run` ne yükleneceğini gösterir, `--check` yayımlanmış bir sürümü denetler, `--partial` ise
-eksik yüklemenin bilerek yapıldığı durumlar içindir.
+Beklenen her dosyayı `dist/` içinde ve `--dir` ile verilen klasörlerde arıyor, hepsi yoksa hiçbir şey
+yüklemiyor, ve sonra her etiketin gerçekten yazıldığını doğrulamak için sürümü yeniden okuyor. Ne
+yükleneceğini görmek için `--dry-run`, yayımlanmış bir sürümü denetlemek için `--check`, kısmi yükleme
+gerçekten isteniyorsa `--partial` ekleyin.
----
+### Ekran görüntülerini yeniden üretme
-## Kullanım
+```bash
+npm start -- --shots
+```
-1. **Ekranlar** menüsünden bir veya **birkaç** ekran, ardından bir veya daha fazla **ses kaynağı**
- seçin.
-2. **▶ Görselleştiriciyi Aç**'a basın; seçili her ekranda tam ekran görsel başlar.
-3. Sağdaki kartlardan istediğinizi değiştirin — anında uygulanır ve kendini kaydeder.
-4. Yayın yapıyorsanız **Çıkış → Yayın Çıkışı**'nı açıp verdiği adresi OBS'de bir **Tarayıcı
- Kaynağı**'na yapıştırın.
-5. Kendi efektinizi yazmak için **Studio**'ya, bitmiş bir sahneden başlamak için **Kitaplık →
- Hazır Şablonlar**'a gidin.
-6. **Video Dışa Aktarma** ile bir ses dosyasını seçtiğiniz çözünürlük, kare hızı ve kalitede MP4'e
- render edin.
-7. Herhangi bir görselleştirme penceresinde **ESC** hepsini kapatır.
+Bu sayfadaki her paneli, sahneyi, klibi ve mod paftasını sentetik bir sinyalden, İngilizce arayüzle
+`docs/screenshots/` altına çiziyor. Gerçek ses yakalamıyor, kamerayı açmıyor, ayarlarınıza yazmıyor, ve
+o an ne çalıyorsa onun yerine elle yazılmış parça bilgisi kullanıyor. `--only=` eşleşen dosyalarla
+sınırlıyor.
---
@@ -1167,23 +1633,45 @@ npm test
npm start -- --smoke
```
-**1881 birim testi, hepsi geçiyor.** Satır çalıştırmak için değil, cevap denetlemek için yazıldılar:
+**2942 birim testi, hepsi geçiyor.** Satır çalıştırmak için değil, cevap denetlemek için yazıldılar:
-- **Formüller**, tanımlarından elle türetilmiş değerlerle sınanıyor — Viviani eğrisinin küre
- üzerinde kalması, simidin boru yarıçapı, Chladni'nin m↔n antisimetrisi, her çekicinin sınırlı
- kalması ve görüş hacminin içine düşmesi.
+- **Formüller**, tanımlarından elle türetilmiş değerlerle sınanıyor — Viviani eğrisinin küre üzerinde
+ kalması, simidin boru yarıçapı, Chladni'nin m↔n antisimetrisi, her çekicinin sınırlı kalması ve görüş
+ hacminin içine düşmesi.
- **Tempo**, bilinen BPM'li sentetik sinyallerle ölçülüyor (90/120/128/140/174 →
89.8/120.4/127.9/140.0/173.7).
-- **Çözümleme**, cevabı bilinen sinyallerle sınanıyor: bilinen bir akor o akor olarak, 220 Hz'lik
- bir ton 220 Hz olarak dönmeli.
+- **Çözümleme**, cevabı bilinen sinyallerle sınanıyor: bilinen bir akor o akor olarak, 220 Hz'lik bir
+ ton 220 Hz olarak dönmeli.
- **Art-Net**, ArtDMX başlığına karşı bayt bayt doğrulanıyor.
- **Yapılandırma göçü**, 1.3 ve 2.0 ayar dosyalarını tek bir değer kaybetmeden açıyor.
- **Preset ve paket yükleyicilerinin fuzz'lanması**, hiçbir MilkDrop presetinin JavaScript
kaçıramayacağını doğruluyor.
+- **MCP kapsamı**, yeni bir ayar ya da özellik ona uyan bir araç ya da yol kuralı olmadan eklenirse
+ başarısız oluyor.
+
+**GPU öz testi** gerçek uygulamayı gerçek bir GPU'da çalıştırıyor. Kayıtlı her görselleştirici modunu
+ve arkaplanı çizip her birinin tuvalini kurduğunu ve shader tabanlı modların derlendiğini denetliyor;
+her efektin ve her 3B formülün boş olmayan bir görüntü bıraktığını ölçüyor; her yerleşik Studio
+shader'ını derliyor; MilkDrop'un, degrade arkaplanın ve efekt zincirinin WebGL bağlamını kaybettirip
+geri getiriyor; OBS katmanını gerçek yayın sunucusundan yüklüyor; arayüzü İngilizceye alıp çevrilmemiş
+metin arıyor; ve otomasyonun kamerayı asla açmadığını doğruluyor.
+
+CI her çekme isteğinde birim testlerini Windows ve Ubuntu'da, Node 20 ve 22 ile çalıştırıyor.
-**GPU öz testi** kayıtlı her modu, arkaplanı, efekti, shader'ı, formülü ve geçişi gerçek GPU'da
-çizip sonucun boş olmadığını ölçüyor. Ardından arayüzü İngilizceye alıp çevrilmemiş metin arıyor ve
-otomasyonun kamerayı hiç açmadığını doğruluyor.
+### Performans ölçümü
+
+```bash
+npm run bench
+```
+
+Ölçüm her görselleştiricinin, arkaplanın ve efektin kare süresini gerçek görselleştirici sayfasında,
+uygulamadaki gibi dikey senkron açıkken ve her seferinde aynı sentetik sesle ölçüyor. Ayarlarınıza ve
+ışıklarınıza dokunmuyor. `--soak=` dakikada bir kare hızını ve JavaScript belleğini
+örnekleyen uzun bir geçiş koşusu ekliyor. Referans dizüstünde (Ryzen 9 8940HX, RTX 5070 Laptop,
+75 Hz) 1920×1080'de kullanıcı içeriği olmadan çizen 139 sahnenin 136'sı yenileme hızını (75 Hz'in
+%95'i) tutuyor; Wave Field (39 fps), Voronoi (63) ve Wave Interference (71) tutmuyor. 10 dakikalık
+geçiş koşusu 73–75 fps'te ve 6–8 MB'lık sabit bellekte kaldı. Nasıl çalıştığı, seçenekleri ve
+tabloların tamamı [docs/BENCHMARKS.md](docs/BENCHMARKS.md) dosyasında (İngilizce).
---
@@ -1191,18 +1679,20 @@ otomasyonun kamerayı hiç açmadığını doğruluyor.
```
src/
- main/ Electron ana süreci: pencereler, ses yakalama, IPC, yayın sunucusu
+ main/ Electron ana süreci: pencereler, ses yakalama, IPC, yayın ve MCP sunucuları
admin/ Yönetici paneli
visualizer/ Çıkış penceresi: katman yığını, modlar, efektler
- exporter/ Çevrimdışı, deterministik video dışa aktarımı
+ exporter/ Çevrimdışı, deterministik video dışa aktarma
shared/ DOM'suz motorlar: tayf, modülasyon, çözümleme, formüller,
- geçişler, bükme, MilkDrop, şablonlar, şarkı sözü, katı cisimler
- web/ OBS katmanı ve mobil kumanda
-tests/ Birim testleri, `npm test` ile koşar
-docs/ Yol haritası, plan ve ekran görüntüleri
+ geçişler, bükme, MilkDrop, şablonlar, şarkı sözü, zaman çizelgesi, klip destesi
+ web/ OBS katmanı ve telefon kumandası
+native/ Ses yardımcıları (uygulama başına yakalama, Dynamic Lighting kimliği)
+scripts/ Derleme, sürüm, performans ölçümü, MilkDrop derlemi ve çizim ölçüm araçları
+tests/ `npm test` ile çalışan birim testleri
+docs/ Ekran görüntüleri ve ölçüm sonuçları
```
-Ortak motorlar DOM, GPU ve ses aygıtı bilmeyen saf aritmetiktir; testleri Node'da koşar.
+Ortak motorlar DOM'suz, GPU'suz ve ses aygıtsız düz aritmetik; testleri Node'da çalışıyor.
---
@@ -1210,32 +1700,39 @@ Ortak motorlar DOM, GPU ve ses aygıtı bilmeyen saf aritmetiktir; testleri Node
| Tuş | Eylem |
|-----|-------|
-| `ESC` | Tüm görselleştirme pencerelerini kapat |
+| `ESC` | Bütün görselleştirme pencerelerini kapat |
| `F11` | Tam ekranı aç/kapat |
| `Space` | Karartma |
| `Ctrl` + `S` | PNG anlık görüntü |
| `Ctrl` + `R` | Kaydı başlat / durdur |
+| `Ctrl` + `K` | Bütün ayarlarda ara (panel) |
+| `Ctrl` + `Shift` + `Q` | ESC kilidi açıkken görselleştiriciyi kapat |
+| `K` + iki rakam | Bir MilkDrop sprite'ı başlat (görselleştirici penceresi) |
+
+Zaman çizelgesi düzenleyicisinin ve klip destesinin kendi kısayolları var; panellerinde listeleniyor.
---
## Yol haritası
-[ROADMAP.md](ROADMAP.md) neyin gerçekten yapıldığını ve planlanan her sürümün neye ayrıldığını
-kaydediyor — v3.1.0'da Timeline ve Clip Deck, v3.1.1'de çoklu platform paketleri ile OpenRGB ve
-Spout/Syphon, v3.1.2'de MilkDrop shader motoru, v3.1.3'te uygulama başına ses yakalama ve basıklık
-düzeltmesi, v3.1.4'te yayın katmanı ve saydamlık düzeltmeleriyle birlikte MilkDrop sadakati.
-Sırada v3.1.5'te MilkDrop ve yayın iyileştirmeleri, v3.1.6'da çok daha geniş ve çok daha hızlı video
-dışa aktarımı, v3.1.7'de yayın düzeni editörü, v3.2.0'da yedeklilik ve kare senkronu var. Ayrıca
-neyin **yapılmadığını** ve nedenini de dürüstçe listeliyor.
+[ROADMAP.md](ROADMAP.md) gerçekte neyin yayımlandığını ve planlanan her sürümün ne için olduğunu
+kaydediyor — v3.1.0'da Zaman Çizelgesi ve Klip Destesi, v3.1.1'de OpenRGB ve Spout/Syphon'la çapraz
+platform derlemeler, v3.1.2'de MilkDrop shader motoru, v3.1.3'te uygulama başına ses yakalama ve
+basıklık düzeltme, v3.1.4'te yayın katmanı ve saydamlık düzeltmeleriyle MilkDrop uyumu. Sırada
+v3.1.5'te MilkDrop ve yayın iyileştirmeleri, v3.1.6'da çok daha geniş ve çok daha hızlı video dışa
+aktarma, v3.1.7'de yayın düzeni düzenleyicisi ve v3.2.0'da yedeklilik ve kare eşitleme var. Neyin
+*yapılmadığının* ve nedeninin dürüst bir listesini de tutuyor.
---
## Lisans
-MIT — bkz. [LICENSE](LICENSE).
+MIT — bkz. [LICENSE](LICENSE). Telif hakkı (c) 2026 Çağan Turgut ([CaYatur](https://github.com/CaYatur)) — CaYaDev.
diff --git a/ROADMAP.md b/ROADMAP.md
index fe44c836..99c4ef80 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -4,7 +4,7 @@ This document records, honestly, what has actually shipped and what is planned.
A row is only marked done when the feature works in the application and is
covered by a test or by the GPU self-test.
-**Current release: v3.1.4** · **Next release: v3.1.5**
+**Current release: v3.1.4** · **In development: v3.1.5-beta** · **Next release: v3.1.5**
| Release | Theme | Released | State |
|---|---|:--:|:--:|
@@ -17,7 +17,7 @@ covered by a test or by the GPU self-test.
| v3.1.2 | MilkDrop shader engine, Now Playing overlay, transparent visualizer | 2026-09-05 | Shipped |
| v3.1.3 | Per-application audio capture, aspect correction, Auto VJ rebuild | 2026-09-08 | Shipped |
| **v3.1.4** | **Streaming overlay and transparency fixes, MilkDrop fidelity** | **2026-09-15** | **Current** |
-| v3.1.5 | MilkDrop and streaming refinements | — | Planned |
+| v3.1.5 | MilkDrop and streaming refinements | — | In development (v3.1.5-beta) |
| v3.1.6 | Comprehensive video export | — | Planned |
| v3.1.7 | Broadcast layout editor | — | Planned |
| v3.1.8 | NDI output | — | Deferred |
@@ -129,9 +129,9 @@ npm test
npm start -- --smoke
```
-- **1881 unit tests, all passing** on `main`. 703 of those shipped in v3.1.0;
+- **2942 unit tests, all passing** on `main`. 703 of those shipped in v3.1.0;
105 came with v3.1.1; 163 came with v3.1.2; 157 came with v3.1.3 — 1128 at
- that tag — 469 more with v3.1.4, most of them from the MilkDrop work, and 284
+ that tag — 469 more with v3.1.4, most of them from the MilkDrop work, and 1103
on `main` since.
Formulas are checked against values derived
by hand from their definitions — Viviani's curve staying on its sphere, the
@@ -949,23 +949,24 @@ MilkDrop (#560):
preset changes class, and rendered alone in both trees it is identical -
that flip is the picture it inherits from the preset before it in the run,
not this change. The legacy run is identical byte for byte.
-- **`hue_shader` only colours what the preset asked to colour** · done on
- `main`. MilkDrop mixes the four corner colours towards white by the
- preset's `fShader` amount, and skips them entirely below 0.001, leaving
- white (milkdropfs.cpp:3857-3876); the default is zero (state.cpp:548). We
- handed every preset the full colour. Of the 1,239 presets (12.0%) whose
- composite shader reads `hue_shader`, 914 leave `fShader` at zero - their
- picture was being tinted by a colour MilkDrop never sends - and 36 ask for
- a partial amount. Six of those presets rendered alone in both trees all
- differ, five of them by a lot (means of 3.6 to 26.9 of 255, up to 89% of
- pixels past 8), and all six are identical with the fidelity switch off; on
- the 900-preset sample no preset changes class. The same four colours then
- reached the other half of the picture: MilkDrop draws its fixed composite
- quad with them as vertex colours (milkdropfs.cpp:3940-3946) and we applied
- none, so the 631 presets that have no composite shader and ask for a
- non-zero `fShader` were missing the tint entirely. Six of them rendered
- alone all differ (means of 0.3 to 13.0 of 255, up to 60% of pixels past 8)
- and stay identical with the switch off.
+- **`hue_shader` gets the colour MilkDrop sends** · done on `main`,
+ corrected in #580. MilkDrop builds four corner colours every frame and uses
+ them in two ways. Every composite shader gets the full colour as
+ `hue_shader`, whatever the preset's `fShader` says - the D3D11 and the D3D9
+ code both note "since we don't know if shader uses it or not"
+ (milkdropfs.cpp:4122) - and `fShader` scales it only in the shader MilkDrop
+ writes for a preset without one. The fixed composite mixes the colours
+ towards white by `fShader`, skips them below 0.001 (milkdropfs.cpp:
+ 3857-3884; the default is zero, state.cpp:548) and draws its quad with them
+ as vertex colours (3940-3946). The first version of this change (16
+ September) took the fixed composite's rule for the shaders too: with
+ fidelity on, the 914 presets whose composite shader reads `hue_shader` and
+ leaves `fShader` at zero lost their colour, and 36 got part of it. #580 gave
+ the full colour back and found the shader corners mirrored top to bottom as
+ well. The fixed composite applied no colour at all before this change; the
+ 631 presets without a composite shader that ask for a non-zero `fShader`
+ got the tint here and kept it, and #580 takes its amount from the file
+ instead of per-frame values and draws it as MilkDrop does.
- **Motion vectors sit where MilkDrop puts them and point where it points** ·
done on `main`. Four differences in one field (milkdropfs.cpp:1172-1320):
the count is truncated with its fraction widening the grid spacing, and the
@@ -1080,6 +1081,125 @@ MilkDrop (#560):
reads a `vol` the per-frame code assigned for itself. On the 900-preset sample
no preset changes class in either mode — 881 render a live image with the
switch on, 862 with it off, as before.
+- **The default wave's green and blue stay in order** · checked on `main`, no
+ change on screen. The pinned source writes the default wave's green from
+ `cb` and its blue from `cg` (milkdropfs.cpp:3101-3102), and this was put off
+ three times because the vertex struct was not at hand. It is plain floats in
+ RGBA order (support.h:71-75), so that fork does draw the two swapped — but
+ the fork is a D3D11 port, and the D3D9 code it was ported from sets the
+ colour in one call, `D3DCOLOR_RGBA_01(cr, cg, cb, alpha1)` (mvsoft74/BeatDrop
+ 53d83ee, milkdropfs.cpp:3225), a line the fork still carries as a comment in
+ every wave mode. The swap came in with the port. The engine already draws in
+ order; a test now pins it in all eight modes.
+- **Layers hidden under MilkDrop are no longer drawn** · done on `main`. The
+ rest of item 8. With the layer stack off, the scene still builds the
+ background, and every frame drew it under a MilkDrop layer that covers the
+ canvas with an opaque picture — the engine copies from a context created
+ with `alpha: false`. Nothing showed, so this was a cost, not a glitch:
+ measured in an isolated copy at 1920×1080 with the frame-rate cap off, a 2D
+ aurora background took ~0.47 ms a frame and the WebGL gradient ~0.17 ms.
+ A layer now covers what is under it only when its engine says its last
+ frame covered the canvas (`covers()`, MilkDrop for now; a resized canvas or
+ the engine's fallback text does not count), its blend is normal, its
+ opacity full, it has no transform, mask or per-layer effect, and the audio
+ is ready — without audio a visualizer layer clears its canvas that frame.
+ Covered layers are skipped on both drawing paths, their canvases are hidden
+ so the compositor skips them as well, and a layer is drawn again in the
+ same frame it is uncovered. When the lights sample the background's
+ colours, the background keeps drawing, or they would read a frozen frame.
+ The same measurement afterwards, alternating new and old: 253.6/260.7 fps
+ against 246.2/246.6 over the gradient, 264.8/266.9 against 234.8/238.5 over
+ aurora. Export composes through the same path and is unchanged: MilkDrop
+ over aurora exported on the commit before and after matches frame for
+ frame, 60 of 60, each tree twice. One thing does change: a background that
+ builds state frame by frame stops while covered and resumes from there when
+ uncovered, rather than from where it would have been. The item's other
+ point, the MilkDrop section hiding itself, was
+ already gone: it has had no visibility condition since b6ef117. 6 tests;
+ 9 of 9 mutations caught.
+- **The README's pictures hear the same sound as the preview** · done on
+ `main`. The last place with its own signal was the `--shots` generator: its
+ time data was three low sines, 4, 6 and 12 cycles per 2048 samples, the
+ same narrow band the panel's demo lost in the item above, and the level
+ every mode reads is that data's RMS. It now takes the time data and both
+ channels from `src/shared/demo-audio.js`; its spectrum curve stays, with
+ the hi-hat moved to the signal's eighth notes. Regenerating the pictures
+ turned up three faults in the generator, all fixed: the four broadcast
+ scenes came out without their logo, because the logo was written over the
+ finished scene and never reached the template's logo layer — it now goes
+ in through the base, the way a user's own logo does; the text scene carried
+ a faded title from the scene before, captured 2 s into a 2.5 s transition —
+ scene transitions are off while shooting; and a full run would have
+ overwritten the two MilkDrop pictures, which were made separately from our
+ own presets, so it now skips them unless `--only` names MilkDrop. 21
+ pictures are regenerated from a fresh profile. Two are not: the shared
+ signal is quieter (RMS −16.4 dBFS against the old −12.8), the tunnel's
+ brightness follows loudness, and its still and animation came out 58% and
+ 42% as bright. They keep the previous render until the demo's loudness is
+ settled; changing that would move the MilkDrop measurement's baseline.
+ 5 tests; 9 of 9 mutations caught.
+- **Sprites from `milk_img.ini` (#577)** · done on `main`. The last item of
+ this issue. MilkDrop 2 overlays images during a show, each defined in
+ `milk_img.ini` with an image, init and per-frame code and a colour key, and
+ launched by number (plugin.cpp:6695-6868, texmgr.cpp, milkdropfs.cpp:3286).
+ The behaviour was written down from the source and the sample ini's own
+ documentation first, and the code built from that description.
+ - **What it does.** Up to 16 at once; a full set drops the oldest. The
+ outputs start from MilkDrop's defaults, init runs once before the frame
+ inputs exist, and every value persists from frame to frame. The five
+ blend modes are 0 blend (the image's alpha ignored), 1 decal,
+ 2 additive, 3 srccolor and 4 colour key; the key makes exactly matching
+ pixels transparent black at load. Tiling repeats from the centre, flips
+ swap the corners, and `done` draws a last frame before the sprite goes.
+ With `burn`, on by default, the sprite is also drawn into the feedback
+ buffer, so it leaves its image and flows with the preset. Sprites are
+ drawn over the composited picture and before the flash limiter, so a
+ flashing sprite is limited too (#588). An image shared by several
+ sprites is one texture, freed when its last sprite goes.
+ - **Where the source overrides its documentation.**
+ - `progress` is the preset transition's progress, not the preset's.
+ - Positive `rot` turns clockwise on screen.
+ - The width normalisation comes after the translation, so on a wide
+ screen the y position scales with it too: the visible range is
+ y = 0.5 ± 0.5·H/W, 0.22..0.78 at 16:9.
+
+ The D3D11 port the rest of #560 was checked against comments out the
+ kill on `done`; the D3D9 code kills.
+ - **One deliberate divergence.** MilkDrop corrects for a 4:3 feedback
+ texture and undoes that correction, but it undoes it every frame and
+ applies it only on the last. On a wide screen the sprite is stretched
+ vertically by (W/H)/(4/3), while its imprint is not. The feedback buffer
+ here has the window's aspect, so neither step is applied.
+ - **Launching.**
+ - Choose the file in the MilkDrop panel (it lives outside scenes) and
+ launch from its list, from MIDI and OSC mappings (every defined sprite
+ is a target), or with MilkDrop's own keys in the visualizer window.
+ - Main re-reads the ini on every launch, as MilkDrop does, and sends
+ the command with a seed to every engine: visualizer windows,
+ Spout/Syphon, the web output and the panel preview.
+ - The page asks for the image by an opaque key. Its path never leaves
+ the main process, and the web route is behind the token.
+ - MilkDrop loads the image before the sprite starts. Here the load is
+ asynchronous, so the launch waits for it, up to 5 s, keeping the
+ order of later commands. Measured: without that, a sprite that died
+ after eight frames never showed.
+ - TGA, DDS, PPM and DIB, which MilkDrop also read, are reported as
+ unsupported.
+ - **Measured.** In the GPU self-test, a red decal sprite fills the centre
+ ([255,0,0]) and is gone after remove-all. In an isolated copy with three
+ displays, the web output, Spout and the panel preview:
+ - all six drew the probe image at 5 of 5 sample points;
+ - a sprite placed with `rand` sat at the same x/y on every engine;
+ - remove-all cleared them all;
+ - an unknown key got 404, and a request without the token got 401;
+ - a burnt sprite's image stayed exactly where it was after the sprite
+ died, and not mirrored.
+ - **Tests.** 37 tests; 16 of 16 mutations that change behaviour are
+ caught. Two more mutations did not change behaviour:
+ - one showed a network-path check that the driveless-root rule
+ already covers, and the check was removed;
+ - the other, DELETE outside sprite mode, is already stopped by a later
+ check.
Audio:
- **Both channels reach the visuals (#566)** · done on `main`. Found while
@@ -1124,6 +1244,247 @@ Streaming and transparency:
checks what it reports; checked by hand connected, with a script removed, in
English, and with the application closed.
+Performance (#621):
+- **The visualizer no longer slows down as settings grow** · done on `main`.
+ Reported in use: with Auto VJ or MilkDrop on, the app got slower over time.
+ Measured on a copy of the reporter's own 842 KB settings file (saved scenes,
+ MilkDrop library records): the visualizer drew 33 fps on a 74 Hz display,
+ and 87% of its CPU time went into one function. Every frame, every layer
+ with its own settings merged them into a deep copy of the whole
+ configuration — scenes and library records included — so each saved scene
+ and each rated preset made every frame dearer. The classic, layer-less
+ path paid it too. Only the sections a layer overrides are merged now; the
+ result is the same (the tests compare it with the old code). Same file:
+ 74.6 fps, the window idle 80% of the time. An eight-minute MilkDrop
+ auto-cycle (a new preset every 4 s) over the reporter's 10,369-preset
+ library then held 73.1-75 fps with the heap flat at 190 MB; 4 of 36,206
+ frames took over 50 ms.
+- **The panel no longer lays itself out every frame** · done on `main`. The
+ level meters animated their width, which re-ran layout and re-measured the
+ scene list's and the cards' scrollbars on every frame, and a value was
+ rewritten 30 times a second even when unchanged: the panel's main thread
+ spent 2,206 ms of every 5 s working, now 839 ms, and layout per frame is gone.
+- **Smaller costs in the same measurements** · done on `main`. Settings writes
+ are coalesced: while a slider was dragged the file was rewritten
+ synchronously about 18 times a second; it is now written once within
+ 300 ms and flushed on exit (main-thread round trip during a drag, p95
+ 15 → 12 ms — the rest is carrying the configuration itself between
+ processes). A layer canvas thrown away by a scene or Auto VJ change now
+ frees its memory at once instead of waiting for garbage collection.
+- **One broken layer no longer takes the frame with it** · done on `main`.
+ A soak on the same settings with exceptions counted found the particles
+ visualizer throwing on every frame in the theme colour (a name that was
+ never defined), 886 times in four minutes while Auto VJ had it on screen.
+ A throw left the layer loop, so every layer above it, the effect chain and
+ the lights were skipped in those frames. The name is fixed, and a layer
+ that throws is now skipped alone and reported once per kind and type.
+ Every visualizer in all three colour modes and every background were then
+ drawn in the app with exceptions counted. One more turned up, now and then
+ and only during a scene change: a layer canvas of zero size reached the
+ compositor, which the browser refuses with an exception — the same frame
+ loss. A canvas thrown away by a scene change drops to zero size since the
+ memory fix above, and one made before the window has its size is born at
+ zero. The compositor, layer masks and layer effects now pass over a
+ zero-size canvas; there is nothing on it to draw.
+- **MilkDrop equations take a third less time** · done on `main`. On the
+ reporter's own preset (per-pixel code with three `pow`/`acos`/`sin`/`cos`
+ groups, run on a 64x48 mesh) the equations took 9.5 ms a frame; now
+ 6.6 ms. Over 200 corpus presets the average went from 1.05 to 0.63 ms,
+ which more than pays back what the MilkDrop-exact arithmetic of #580
+ added. Four changes, none of them changing a result: the round-toward-zero
+ step is one multiplication instead of a trip through typed arrays (bits
+ only for subnormals); `+ − ×` read plain variables and numbers directly
+ instead of through a call each; common functions (`sin`, `cos`, `pow`,
+ `min`, …) get call sites of their own that the JavaScript engine can
+ inline; and a mesh point no longer looks its variables up by name. Old
+ and new engine were run side by side over all 10,347 corpus presets,
+ fidelity on and off — frame, mesh, wave and shape outputs are identical
+ to the bit.
+- **A MilkDrop layer sets up faster** · done on `main`. Auto VJ builds a
+ new MilkDrop engine each time it switches a layer to MilkDrop, and that
+ frame was measured (reporter's settings, warm runs) at about 130 ms, 95
+ of it in the GL setup and 41–47 of those regenerating the six noise
+ textures in JavaScript — the same pixels every time, since the
+ generator always starts from the same seed. They are now generated once
+ per page and only uploaded per engine: noise 4–7 ms, GL setup ~50 ms,
+ the setup frame 80–120 ms. *Not done:* the rest of that frame is the
+ WebGL context itself, the render targets, the seven fixed programs and
+ the first preset's shaders; keeping one engine alive across Auto VJ
+ switches would remove it but ties the engine to a canvas the layer
+ stack disposes.
+- *Not done:* the panel still sends the whole configuration on every change,
+ so a very large settings file still costs some IPC per change; on the
+ measured machine this no longer shows as a dropped frame, and splitting the
+ configuration is a larger change than the measurements justify.
+
+Panel layout (#622):
+- **The Layers card lists layers, and opens the one being edited** · done on
+ `main`. Every layer showed all its settings at once: on the reporter's
+ six-layer scene the card was 4,356 px tall, four screens of scrolling before
+ the next card. Layers now arrive collapsed; each row shows the kind, the
+ source, the blend mode and the opacity, and opens on a click (remembered on
+ this machine, not in the settings file). An open layer lays its controls out
+ in columns sized to the card, and its five sub-sections are a tab strip
+ instead of five folded headings at the bottom. The same scene's card is
+ 612 px with everything collapsed. A newly added layer opens.
+- **Rows no longer squeeze their labels** · done on `main`. A drop-down next
+ to its label took the whole row and sat 7 px lower, breaking labels over two
+ lines ("Image / Source"); it now takes most of the row beside a one-line
+ label, in every card.
+- **Cards fill the columns** · done on `main`. Cards were laid out row by row,
+ so a short card beside a tall one left a hole under it, and a half-width card
+ alone between two wide ones left half the row empty (Art-Net, Tempo and Auto
+ VJ, My Color Presets). Cards now stack under the shortest column in order,
+ re-measured when a card grows, and a lone half-width card takes the full
+ row. Where only two cards sit side by side, the shorter one still ends
+ first — there is nothing to put under it.
+- **Preset tiles end their rows** · done on `main`. The colour preset groups
+ hold 10 and 6 tiles and the grid gave 9 columns, so every group of 10 left
+ its last tile alone on a new row; the column count is now one of 4, 6, 7, 8
+ or 10.
+- Checked by screenshots of every category at 1100, 1300, 1600 and 1900 px
+ wide, in Turkish and English, with the reporter's settings.
+
+Icons and top bar (#665):
+- **Our own icons instead of emoji** · done on the branch.
+ - **The problem.** The panel, the visualizer window's own controls and the phone remote used emoji and Unicode pictographs as icons (💾 📤 🗑 ⚠️ ⏭ …): about 350 code lines in 30 files, plus their dictionary entries. They drew in the system's colour emoji font, so they ignored the panel's colours and looked different on each system. Some (⏸ ⏹ ⏭) fell back to colour emoji while others (▶ ■) drew as text, so one toolbar mixed two styles, and an emoji made its button taller: "Open" was 34 px and "Close" beside it 32 px.
+ - **The set.** 119 line icons drawn for this application in `src/shared/icons.js`: a 24 grid, one stroke weight, round ends, `currentColor`. Each icon is only path data, so the same definition draws as SVG in the page and through `Path2D` on the timeline's canvas. The panel, the visualizer window, the phone remote and the web overlay all load it.
+ - **How it is used.** A button names its icon (`icon: 'save'`) and keeps its text in its own text node, so the dictionary still matches the whole label. Buttons whose state changes (Open / Apply displays, Blackout, play / pause, favourite, lock) swap icon and text together. Status lines (audio capture, export, recording, lighting, Auto VJ) take their icon from their state, not from a character in the text. A drop-down option cannot hold an icon, so options lost the glyph.
+ - **Dictionary.** 174 keys started with a glyph: 142 lost it, and 32 then matched an existing key with the same meaning and were removed. About ten more were edited by hand: help texts that named a button by its emoji ("press 🔄 Refresh Devices") now name it by its label. The rules that translate counted status lines were rewritten without the glyphs.
+ - **Kept as text on purpose:** arrows inside sentences (→ ← ↑ ↓), ♩ for a beat and ▮ for a bar in the clip cells, fractions and ×.
+ - A test fails if a UI file gets an emoji outside a comment again, if code names an icon the set does not have, or if the dictionary gets a duplicate key.
+- **The Displays picker lines up with the top bar** · done on the branch. Its label sat above it and pushed the picker about 8 px below Open / Close / Blackout; the label now sits beside it.
+- Checked with screenshots of Scene, Audio, Control (timeline, Clip Deck, performance view), Library, MilkDrop and the search results in Turkish, Control in English, the floating window's bar and the phone remote at 375 px. A script opened every category and found no unknown icon and no glyph left in Turkish, and no untranslated text in English; the smoke run's English scan passed.
+
+Stabilisation (#695):
+- **Small fixes found with real settings** · done on the branch.
+ - Flip Horizontal / Vertical on a layer passed its options in the callback's place and threw "onAfter is not a function" on every click; the reset button did not appear either.
+ - The Layers panel wrote `false` into the empty layer-stack flag while drawing, so a new install showed "1 change" on Scene. The panel now reads the flag the way the renderer does and leaves it alone.
+ - "Basla Nabız" is "Bas Nabzı" again in the four places it appeared.
+ - MCP was synced on every settings push, about 18 times a second while a slider moved, and tried to delete its endpoint file each time while off. It now syncs when the switch or port changes; a busy port is retried at most every five seconds.
+ - The MCP file tools take only an absolute local path with the matching extension: `.mp4` for an export, `.json` for settings, `.jpg` / `.jpeg` for a snapshot. Before, a client in Write mode could leave a `.bat` anywhere, and ffmpeg would also have sent an export to `tcp://` or `pipe:`.
+- **The chosen display survives a new display id** · done on the branch. Windows gives a reconnected display a new id. The saved selection matched by id only, so it came back empty and Open did nothing — the reporter's saved display was gone this way. The selection now keeps each display's position, size and primary flag. A lost id is matched by position and size first, then by size when only one display has it. If nothing matches, the primary display is chosen. A first start selects the primary display. A selection the user emptied on purpose stays empty, and Open then opens the Displays menu with a note instead of doing nothing.
+- **A click keeps its control in place** · done on the branch. Measured with a copy of the reporter's settings and real mouse events.
+ - **Anchor.** The panel redraws the whole category and put the clicked control back by reading the focused element. Every switch input was `display: none` and never took focus, so the anchor was empty: turning "Use Layer Stack" on or off moved the switch about 1,260 px off screen. The panel now remembers the element under the last pointer or key press, and falls back to the first fully visible control. The switch stays where it was clicked; the page scrolls by the height of the cards that appeared above it.
+ - **Switches can take focus.** Their input is now invisible but focusable, so the anchor works and the keyboard reaches them, with a focus ring.
+ - **Background redraws wait.** MCP and phone edits, preset changes, the lyrics library, the lighting device poll and the WebGL fallback note redrew the category directly, even while a slider was being dragged. They now redraw only when the category that shows the data is open, at most once a frame, and after the mouse button is released.
+ - Opening a fold still moved a card in the other column by up to 916 px. That was the masonry grid; see the next entry.
+- **Stable card columns instead of the masonry grid** · done on the branch. The 4 px masonry grid from #622 placed each card from its height. A card that opened or closed moved the cards after it into other columns, and a shrinking card kept its old span until the next full redraw, so the gap closed all at once. Now a wide card is its own row and the half-width cards between wide cards form a band. The band has as many columns as the window allows, never more than it has cards: one card takes the full width, two share it. Each card goes to the shortest column once and stays there while the category and the column count stay the same. A card that grows only pushes the cards below it in its own column. Measured with the reporter's settings: opening the LFO fold moved another card by 916 px before and 0 px now, and the Dynamic Theme switch by 264 px before and 0 px now. Checked with screenshots of every category in Turkish and English at 1484 px, Output and Library at 1100 and 1900 px, and Control with the timeline and Clip Deck switched on.
+- **Moving a slider no longer stalls the app** · done on the branch. Measured with a copy of the reporter's settings (about 640 KB: 22 scenes take about 330 KB, the MilkDrop tags about 290 KB) and the Spout window as a receiving renderer off screen.
+ - **The problem.** While a slider moved, the panel sent the whole configuration about 18 times a second. Each send cost the panel about 15 ms, and the main process copied it again to every visualizer window, the Spout window and the stream. The main process answered in 14–19 ms (95th percentile 34–42 ms) instead of 0.3 ms, the Spout window dropped frames (worst 33–66 ms), and the panel had 14–17 long frames in three seconds. With three displays, OBS and the floating window open, every extra window adds another copy.
+ - **Only what changed.** During a drag the panel sends only the top-level keys that changed (`patch-config`). The scenes, the MilkDrop library and the colour presets are never compared or sent in a patch. 700 ms after the last change the whole configuration goes once more, so anything a patch missed still arrives. A click, a removed key, a blackout and the first send after an outside change always send everything. The main process merges a patch only onto a full configuration and skips unsafe keys. Windows and the web pages apply a patch only after their first full configuration.
+ - **Visualizer windows no longer receive the scene list or the colour presets.** Only the panel and the phone remote use them.
+ - **The Spout window was restarted on every settings push.** Each restart sent it the whole configuration again and read the lyrics library from disk. It now restarts only when its own settings change.
+ - Measured after: the main process answers in 0.3 ms during a drag (95th percentile about 16 ms), the Spout window drops no frame (worst 16.8 ms), and the panel has no long frame. The saved file still holds all 22 scenes and 9,734 tags.
+ - **The settings file is written once a drag ends.** It was written every 300 ms while a slider moved: about 640 KB of JSON, synchronously, in the main process. It is now written 300 ms after the last change, and at most 2 s after the first unsaved one, so a long drag still saves. A pending write is still flushed on quit. With this, the main process's 95th percentile during a drag fell from about 16 ms to 10–14 ms.
+ - **The MCP preset poll is a slow fallback.** With MCP on, the panel asked for preset changes every 400 ms, and each request listed the preset folder (about 10,000 names) in the main process. The main process already broadcasts after every MCP request and when the folder watcher sees a change, so the poll now runs every 3 s and not while the window is hidden.
+ - **Logo and cover glow no longer reallocate every frame.** The audio pulse changes the picture's size every frame, and the glow's two scratch canvases were resized each time. They now only grow, with some headroom, and only the used area is drawn. With a pulsing logo at 1080p a frame took 0.56–0.76 ms before and 0.26 ms after. Compared pixel by pixel with the old code in the same page: only the soft halo differs, by at most 7/255, because the GPU blur works slightly differently on a larger canvas.
+- **Review pass** · done on the branch. A script added every layer kind with the reporter's settings, opened every layer and tab, and changed every switch, slider, list and segment in every category. That was 423 controls on Scene alone, with errors collected in the panel and in the Spout window. It found no error. After all the changes, the panel, its preview and the Spout window held the same 22 layers in the same order. Two small bugs were found while reading code:
+ - After a language switch, display names stayed in the old language ("Display 1 (Primary)" in Turkish), because the panel asked for the display list before it told the main process the language.
+ - With Follow the Playing Track on, lyrics matching normalised the whole lyrics library every frame, for every text layer on every screen. The result is now kept while the library, the track and the match mode stay the same.
+ - A visualizer or background layer without its own value is drawn with the scene's value: the renderer merges the scene's visualizer or background with the layer. The panel showed the factory value instead, so a layer could show "Colour Theme" in the panel while it drew a rainbow. The panel now shows the value that is drawn; a reset still returns to the factory value.
+ - The OBS overlay page was checked with the new patch protocol: during a drag it received each change, then the full configuration, and kept the 22 scenes the phone remote needs.
+- **Copyright notice in every source file** · done on the branch. Every JavaScript, CSS, HTML, C#, C++, shell and NSIS file under `src`, `scripts` and `native` starts with the same notice: Çağan Turgut (CaYatur), CaYaDev, cayadev.com, the repository and `SPDX-License-Identifier: MIT`. In HTML it follows the doctype, in the shell script the shebang. A BOM and the line endings of each file are kept. JSON, `binding.gyp` and the `.csproj` files are manifests and have no notice; tests have none either. LICENSE, both READMEs and `build.copyright` (the copyright in the Windows file properties and the macOS bundle) name the same holder. The native code was checked first: it uses only the public WinRT, WASAPI and N-API interfaces, and the SMTC helper follows the owner's own MIT project Windows-to-Android-Bridge. The Dynamic Lighting addon was rebuilt with the notice and compiled without warnings. A test fails when a new source file has no notice.
+- **General check** · done on the branch. A last pass over the areas the earlier entries did not measure.
+ - With two lyrics layers open in the panel, only the last one's clock advanced. Each Play / Pause / Stop row started its own timer and stopped the one before. One timer now paints every open row and stops when none is left.
+ - The lock on a visualizer window's bar (after F11 to a window) changed the setting but did not save it. The panel does not send an outside change back, so the lock was lost at the next start unless something else was changed. It is now saved when it is clicked; checked with a copy of the reporter's settings.
+ - The Lighting category's description named only Windows Dynamic Lighting, on every system. The category also holds OpenRGB and Art-Net, and macOS and Linux have no Dynamic Lighting card. It now names all three and says Dynamic Lighting is on Windows. Found by opening the panel as macOS and as Linux (the preload's platform patched in a throwaway copy) and listing every visible text and tooltip that mentions Windows, Spout, Syphon, Dynamic Lighting or the taskbar. Nothing else turned up: the Spout card falls back to its "not on this system" note from the main process, and the Dynamic Lighting card is hidden.
+ - MCP told clients it was version 3.1.5-beta in its handshake, from a string typed into the code; after the release it would still have said beta. It now reads the version from the package.
+ - **OpenRGB reconnected on every settings change.** Each push called `openrgb.start`. That closed the socket, connected again, listed every device and switched each one to its direct mode again. No colour went out while this happened. Measured with a fake OpenRGB server that speaks the protocol, and a copy of the reporter's settings with OpenRGB pointed at it: three seconds of slider drag and five clicks opened 46 new connections and sent 92 mode switches to two devices. With real hardware, each mode switch can reset the LEDs, which is a likely cause of the reported flicker. The connection is now made only when the output is switched on or the host or port changes; the device choice, brightness and rate are read from the current settings on every frame anyway. The same test now opens no connection and sends no mode switch, and the colour packets keep flowing. The panel's switch, host and port fields still connect at once. Refresh Devices now also retries the connection when it is down, so starting OpenRGB after the app no longer means waiting for the next retry. A pending retry timer is cancelled when a new connection starts, so it can no longer drop that connection a moment later.
+ - **MCP kept up with the app only by hand, and had a permission gap.** Found while reading the MCP code line by line:
+ - Writing a whole object fell through to the lowest write mode. A client in **Write** could replace the whole `stream` object (tokens, LAN) or `power` (Escape lock, protection), which need **Everything** and **Full**. Every top-level setting now has an explicit group, a path takes the strictest group below it, and a path the table does not know needs **Everything**.
+ - Six tools were listed but not connected in the running app: `sv_get_analysis`, `sv_diagnose_audio`, `sv_repair_audio`, `sv_rotate_stream_token`, `sv_updates_download`, `sv_updates_install`. They now work. The repair restarts capture and leaves installing a missing component to the user, because that needs consent. Checked live through the MCP endpoint.
+ - The mode and layer tools accepted any id; a wrong one left the screen empty, and a client had no way to learn the valid ids. They now check against the app's own mode catalogue, layer kinds and blend modes, and the new `sv_list_modes` lists them. A background layer added without a type started as `bars`; it now starts like the panel's Add Layer button. An existing test used the id `circle`, which does not exist; it now uses `circular`.
+ - `mcp-coverage.test.js` fails when the app gains something MCP does not know: a top-level setting without a permission group, an effect missing from the MCP list, a layer field, a mode or layer kind MCP cannot set, a tool without Turkish and English text, a `ctx` member the main process does not connect, or a tool that throws on empty arguments. It also checks that the four copies of the scene keys agree. On the old code it fails in 8 places.
+ - **Text and Now Playing colour modes were tied to the visualizer.** With the layer stack off, the Colour Mode on the Text and Lyrics card and on the Now Playing card wrote the visualizer's colour mode. The text is drawn as an overlay on the visualizer, so choosing Rainbow for the text turned the Bars rainbow too, and changing the Bars changed the text. The renderers already read the text's own mode first; the cards now write it, and touch the visualizer only when the text or Now Playing is the visualizer itself. The visualizer card keeps that case in step. Checked live: Rainbow on the text left the Bars red. The layer panel was already separate.
+ - **The libraries copied the same file again.** Choosing a video, logo or lyrics file that was already in the library added a second entry, and for a video a second copy of the whole file. Video, logo and lyrics imports now compare with what is there (for video and logo: size, then a fingerprint of the first and last megabyte; for lyrics: the text) and skip a match. A choice that was skipped or could not be added (wrong format, empty, too large) was silent; the panel now says which. Checked live with the import dialog stubbed in the main process.
+ - **Lyrics follow, checked live.** A silent, tagged track played in a browser registered with Windows media controls. The app saw title, artist, position and length, matched the lyrics file from the library, and the karaoke line advanced on time (75 % of the first line at 2.3 s). Pausing froze it mid-line (48 % of the second line at 4.4 s, unchanged 6 s later). A 720p30 CPU export of the same track drew the library lyrics at the same timing, with the title from the file's tags. Cancelling a 1080p60 export after 2.5 s reported cancelled, removed the partial file and left no ffmpeg process.
+ - **F11 with the window lock on did not cover the screen.** Tested with real key presses on an opaque visualizer on a 1280×1024 display. With the lock off, F11 went to a 1280×976 window and back to 1280×1024 full screen. With the lock on, the way back left a 1294×983 window that Windows still called full screen: Electron cannot take a window that may not be resized into full screen. F11 is now handled in the main process: the lock is lifted just before full screen and restored when the window comes back, and a window that comes back the size of the whole display is fitted to the work area as Electron's own shortcut did. Checked again with real keys, lock on and off, and Escape still closes.
+ - **Audio capture stayed dead after its helper exited.** If the capture helper crashed or was killed, the main process did not notice: it kept the source as "being captured", so choosing the same source again did nothing, the visualizer got no frames and the panel still said "Capturing". A selected device that was not present (an unplugged USB headset) ended the same way, with no reason shown. An unexpected exit is now reported, and capture is set up again after 1, 2, 5 and then every 10 seconds while something still wants audio; a successful start resets the wait. The panel says it is reconnecting, a missing device gets its own message, and a banner closed by the user does not reopen on every retry. Checked live by killing the helper three times (frames back after about 1 s each time) and by selecting a device that does not exist, then the default again.
+ - **A camera layer encoded frames for nobody.** So that OBS can show a camera it does not open itself, a window with a camera layer turns the picture into JPEG every 80 ms and sends it to the main process for the stream server. It did this even with no stream overlay connected, and the main process threw the frames away: measured live, 62 frames (about 920 KB) in 5 seconds and about 5 % of a CPU core across the panel, GPU and main processes. A window now only gets to send frames while an overlay is connected, and stops when the last one leaves. Checked live with OBS Virtual Camera: no frames with no overlay, about 12 a second to a connected overlay, none again after it left.
+ - **A lyric timing fix of the same length did not reach the screen.** Moving a line from `[00:12.34]` to `[00:12.35]` keeps the text the same length. The text layer cached the parsed lyrics under a key built from every 17th character and missed 17 of 18 such one-digit edits, so the screen kept the old timing. The library's change check looked only at the text's length, so the same edit saved in the lyrics editor never reached the windows at all. The text layer now compares the text itself, and the library check hashes the whole text. Checked live: a same-length edit saved in the library reached the visualizer window.
+ - **Other websites could connect to the stream server.** A browser does not apply cross-origin rules to WebSocket connections. With Token Protection off, which is the default and the recommended setting for local use, a web page open in the user's browser while the stream server ran could connect as the phone remote. It could open and close the visualizer, switch scenes, change the settings the remote may change and trigger blackout. It could also read the configuration, the now-playing track and the lyrics library. The server now refuses a browser connection whose origin is not the server itself, and any request addressed to a name other than an IP address, `localhost`, the machine's own name, a single-label network name or a `.local` name. The configured video is no longer offered to other sites, and the token cookies are `SameSite=Strict`. The app's own overlay and remote pages, the addresses the panel shares, and clients that send no origin, such as OBS plugins and scripts, are not affected. The cost is that reaching the server through a public host name, such as a tunnel or reverse proxy, is now refused.
+ - **A refused stream client could freeze the app.** When the server refused a connection (a wrong token with Token Protection on, or one of the new checks above) and the client then dropped the connection abruptly, the socket had no error handler. The main process raised an uncaught exception, and Electron's error box held the whole app until it was closed. Found live while testing the change above; the refused socket now has a handler.
+ - **Any uncaught error in the main process froze the app.** Electron's default for an uncaught exception in the main process is a modal error box that holds the main thread until someone closes it. Audio frames stop reaching the windows, and the panel and the phone remote stop answering. In a live show nobody may be at the computer. The main process now logs the error to `main-errors.log` in the settings folder, with the file's size capped and nothing written when there is no error. The panel shows a short notice, at most once every 30 seconds for the same message, and the app keeps running. If the panel window is not up yet, as during start-up, the old error box is still shown, so a half-started app does not stay invisible. A smoke run counts any such error as a failure. Checked live: 50 errors thrown from a timer in the main process gave no error box, one notice in the panel, 50 log entries, and audio frames kept reaching the visualizer at the usual rate.
+ - **Audio capture could stall without ending.** Once started, the capture helper sends a frame about 70 times a second, silence included. If it stayed alive but stopped sending, for example when the audio path hangs on the way back from sleep, nothing noticed. The visualizer stood still and the panel kept saying "Capturing". The main process now watches the frames after the first one arrives. If none come for 3 seconds, it ends the helper, and the restart added earlier in this round sets capture up again. A late watchdog tick, as after the main thread was busy or the computer slept, does not count as a stall: frames may still be waiting to be read. Checked with a simulated stall by suspending the helper process, not a real sleep. Frames stopped and came back about 4 seconds later, and the panel went from reconnecting to capturing.
+ - **Closing the app during an export left a broken file.** Closing the panel while an export ran cancelled it and stopped ffmpeg. The partial file was meant to be deleted by a single 200 ms timer, but the app exited before the timer fired. An unplayable partial MP4 stayed in the user's folder: 4.7 MB in the live test. The file is now deleted once ffmpeg has really closed, with a few retries while Windows still holds the file. On quit, the app deletes what is left, waiting at most 1.5 seconds. Checked live: closing the panel 4 seconds into a 1080p60 export left no ffmpeg process and no file. Cancelling inside the app still deletes the file.
+ - **The display could go to sleep mid-show.** Nothing in the app asked the system to keep the display on, and Chromium does not do so for a drawing canvas. Under a power plan with a display timeout, the output went dark when nobody touched the mouse. A new setting, **Keep the Display Awake While Visualizing** (Settings → Window), is on by default and can be turned off. While a visualizer window, per-display or floating, is open and not minimised, the app holds Electron's `prevent-display-sleep`, which works on Windows, macOS and Linux. The hidden Spout window and exports do not count. It is released when the window closes or is minimised, when the setting is turned off, and on quit. On Windows a full-screen window that is restored from the taskbar sends `focus`, not `restore`, so the app re-checks after those events and every 30 seconds while a window is open. `sv_set_power` sets `keepAwake` over MCP. Checked live on Windows: held while open, released when minimised, held again when restored, released when the setting was turned off, held again when it was turned back on, and released on close; the floating window behaved the same. macOS and Linux use the same Electron call and were not tried on a device.
+ - **The phone remote's numbers were not range-checked.** The remote may change a short list of settings, and numbers were written as sent. A frame-rate cap of `0.01` left the output on one frame about every 100 seconds, and a smoothing value above 1 is outside what the analyser accepts. The fixed numeric paths now have safe ranges, with upper limits matching the panel's extended ranges. A frame-rate cap is 0 (match the display) or at least 10. Non-finite numbers are refused. Checked live through a remote connection: `0.01` became 10, `1.5` smoothing became 0.99, opacity `7` became 1, and 60 stayed 60.
+ - **A device that kept dropping out was restarted every few seconds.** The capture restart reset its wait as soon as capture started again. A device that started and then failed every time, whether it stalled or exited, was set up again about every 4 seconds for as long as it kept failing. The wait now resets only after capture has run for 15 seconds, so a device that keeps failing is retried after 1, 2, 5 and then every 10 seconds. Checked live by suspending each new helper as soon as it started: the gaps grew from about 6 to 5, 9 and 14 seconds instead of staying at 4.
+ - **Removing lyrics from the library did not ask.** Changes made in the lyrics editor live only in the library's copy, so Remove deleted them for good with one click. It now asks first, and a pending title or artist change for that entry is dropped instead of being sent to an entry that is gone. The logo and video libraries still remove without asking: they keep no edits, and the original file stays where it was. Checked live: Cancel kept the entry, and confirming removed it.
+ - A 6-second 1080p60 export with the reporter's 6-layer scene finished in about 8 seconds with the GPU encoder: 360 frames, the audio copied, none of them black, and the same layers as the live window.
+- **The README, rewritten** · done on the branch. The page had grown into a changelog: the first screen had no download link, setup sat 1,370 lines down, 385 lines of MilkDrop measurements came before most features, and the counts were stale (41 backgrounds and 60 modes, where the catalogue has 43 and 59 plus Off; twelve modes and ten backgrounds were not listed at all). Several features had no mention: Now Playing from Spotify, OSC from Ableton or QLab, the clip deck, the update system, the MilkDrop editor.
+ - **Order.** A showreel GIF, download buttons and the figures first; then why it stands out, a gallery, quick start (download, first run, run from source), who it is for, every feature by category, privacy, an FAQ, and the MilkDrop measurements, build, tests and structure at the end. `README.tr.md` has the same structure.
+ - **Release labels.** Everything on `main` is described; what is not in the v3.1.4 download carries a 3.1.5 label, to be removed with the release.
+ - **Claims checked against the code.** Counts come from the mode catalogue, transitions, templates, formulas, solids, shaders, palettes and MCP tool list. Three earlier claims were wrong and are gone: a "Glow" effect that does not exist (the 40 are listed by id), macro knobs on the phone remote (it has none), and a GPU self-test that "measures every mode is not blank" (it checked that each mode built a canvas; see the next item).
+- **The Feedback engine drew nothing** · done on the branch. Its shader declared the control uniforms (`uZoom`, `uDecay`…) that ShaderHost already declares from the control list, and GLSL refused the redefinition: the mode has drawn an empty layer since it was added. Found as an empty tile in the README's mode sheet. The declarations are gone; checked live in an isolated copy (the preview draws the feedback tunnel, `host.error` is null). `tests/shader-control-decls.test.js` fails on the old code, and covers the built-in Studio shaders too. The self-test's mode pass now also fails when a shader-based visualizer holds a compile error, where it only checked that a canvas existed.
+- **The clip deck printed raw durations** · done on the branch. A slot whose length came from bars (8 bars at 124 BPM) showed `15.483870967741936s` in its cell. One decimal now; test included.
+- **The screenshot tool** · done on the branch. `npm start -- --shots` renders everything the README shows.
+ - It no longer captures real audio (the panel showed the user's device name, "Capturing: Speakers (…)", in the published pictures) and never writes settings: the panel is given a demo show for the timeline, clip deck and MilkDrop shots through the same path as MCP, and saving is frozen as in the self-test.
+ - New: the timeline, clip deck, MilkDrop library grid, preset editor and output page; a Now Playing scene with typed-in track details and a generated cover (never the system session, which would publish whatever is playing); six classic gradient GIFs; a showreel GIF without the strobe scene; and two sheets drawn from the mode catalogue, so every mode and background is pictured and a new one appears by itself. The old 16-mode sheet and the June stills are removed.
+ - Audio sensitivity is fixed at 0.6 for the shots. The bars read the time-domain demo signal, which is quieter than loud music, and at the factory 0.25 the pictures came out faint.
+- **Media layer video froze in full screen and in Spout** · done on the branch. Reported: a video file played smoothly in the OBS overlay but stuttered or stopped in every desktop output; hovering the window's taskbar thumbnail made it run, moving away stopped it again; the Spout feed froze too.
+ - **Measured** in an isolated copy with a 1080p60 test clip and the visualizer set to Off, so only the video moves. Per player `getVideoPlaybackQuality()` and loop count, plus the screen itself through DXGI capture. Full-screen visualizer, hidden Spout window and panel preview: 0.3 decoded frames a second and the clip stuck at its last frame; the screen showed one new frame in six seconds.
+ - **Variables separated** one at a time: player count (one player in a full-screen window still stalls), transparency (an opaque window taken out of full screen plays), and composition (the same full-screen window plays at 60 fps once a 1-pixel window overlaps its corner, which is what the taskbar thumbnail does). Earlier guesses, open-ended range requests, background media suspend and occlusion tracking, were each ruled out by measurement.
+ - **Cause.** The layer draws an off-DOM `