Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 50 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
### Free, open-source music visualizer and VJ software for every screen you own

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, **59 visualizer modes**,
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**.

Expand All @@ -17,7 +17,7 @@ layers and **40 GPU effects**, an **OBS overlay**, **Spout / Syphon**, **project
[![Downloads](https://img.shields.io/github/downloads/CaYatur/SoundVisualizer/total?label=downloads)](https://github.com/CaYatur/SoundVisualizer/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-e11d2a.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-111997.svg)](#download)
[![Tests](https://img.shields.io/badge/tests-2925%20passing-2ea043.svg)](#tests)
[![Tests](https://img.shields.io/badge/tests-2967%20passing-2ea043.svg)](#tests)
[![Electron](https://img.shields.io/badge/Electron-43-47848F.svg)](https://www.electronjs.org/)

<a href="https://github.com/CaYatur/SoundVisualizer/releases/latest"><img src="https://img.shields.io/badge/Download-Windows-0a84ff?style=for-the-badge" alt="Download for Windows" /></a>
Expand All @@ -39,7 +39,7 @@ layers and **40 GPU effects**, an **OBS overlay**, **Spout / Syphon**, **project

<div align="center">

| **59** visualizer modes | **43** backgrounds | **40** GPU effects | **18** scene transitions |
| **60** visualizer modes | **43** backgrounds | **40** GPU effects | **18** scene transitions |
|:---:|:---:|:---:|:---:|
| **81** ready-made scenes | **98** formulas + **13** 3D solids | **42** built-in GLSL shaders | **58** colour palettes |
| **10,347** MilkDrop presets tested | **96** MCP tools for AI agents | **17** layer blend modes | **2** languages (EN / TR) |
Expand Down Expand Up @@ -286,7 +286,7 @@ and 174 BPM signals), with tap tempo and a BPM lock shared by Auto VJ, the clip

<div align="center">

**All 59 visualizer modes**
**All 60 visualizer modes**

![Every visualizer mode](docs/screenshots/modes-visualizer.jpg)

Expand All @@ -300,7 +300,7 @@ These two sheets are generated from the mode catalogue itself, so a new mode app
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 <kbd>3.1.5</kbd>.

**Visualizer modes — 59**
**Visualizer modes — 60**

- **Basic** — Bars · Center · Blocks (LED equaliser) · Dot Matrix · City Skyline (buildings with lit
windows)
Expand All @@ -311,7 +311,8 @@ you can stack as many of each as you like. Modes added since v3.1.4 are part of
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
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
Expand Down Expand Up @@ -721,9 +722,50 @@ 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.

**OSC output** <kbd>3.1.5</kbd>. The other direction. It is off by default, sends to this computer
until you set another target, and refuses to send to its own OSC input, which would loop. Extra
targets are one `host:port` or `[ipv6]:port` per line. A positive clock latency delays the phase so
lights can wait for a late speaker.

Addresses use the prefix `/cayadev` unless you change it. Level, bass, mid and treble travel in one
bundle, so one lost packet cannot tear the bands. Hits and the clock travel in a bundle with an OSC
time tag of the host clock. Strings are UTF-8.

| Address | Type | Range | When |
|---|---|---|---|
| `/level` `/bass` `/mid` `/treble` | float | 0..1 | at the chosen rate, up to 30 Hz, one bundle |
| `/spectrum` | 16 floats | 0..1 | with the levels; log bands from 30 Hz to 16 kHz |
| `/hit/kick` `/hit/snare` `/hit/hat` | float | 0..1, then 0 | when the capture frame arrives, then a closing 0 |
| `/silence` | int | 0 or 1 | after the level stays under 0.008 for 400 ms |
| `/analysis/centroid` `/rolloff` `/flatness` `/crest` `/flux` `/spread` `/loudness` `/peak` `/dynamics` `/harmonic` `/percussive` `/width` | float | 0..1 | with the levels |
| `/analysis/correlation` | float | -1..1 | with the levels |
| `/analysis/pitch` | float | Hz | with the levels |
| `/analysis/pitch/note` | string | note name | with the levels |
| `/analysis/pitch/confidence` `/key/confidence` `/chord/confidence` | float | 0..1 | with the levels |
| `/analysis/key` `/chord` | string | name | with the levels |
| `/tempo/bpm` `/tempo/confidence` | float | BPM, 0..1 | on a change of 0.01 BPM, otherwise once a second |
| `/tempo/beat` | int int | beat 1..N, N | each beat |
| `/tempo/beat/phase` `/tempo/bar/phase` | float | 0..1 | at the chosen rate |
| `/tempo/downbeat` | float | 1, then 0 | on beat 1, then the next clock |
| `/transport` | string | `playing` or `stopped` | when the preview audio is ready, or not |
| `/timeline/playing` | int | 0 or 1 | the show timeline |
| `/scene` `/visualizer` `/background` `/milkdrop/preset` | string | name | on change, and again every 5 s, including an empty preset |
| `/background/color/1` … `/8` | string | `#rrggbb` | the meter colors, or the theme colors |
| `/show/blackout` `/show/autovj` | int | 0 or 1 | on change, and again every 5 s |
| `/show/palette` `/show/transition` `/show/track` | string | name | on change, and again every 5 s |
| `/show/brightness` | float | panel value | background brightness, often around 1 |
| `/crossfade` | float | 0..1 | the A/B master |
| `/audio/sensitivity` and the other panel sliders | float or int | the slider range | on change, and again every 5 s |
| `/layer/count` | int | 0..32 | on change |
| `/layer/N/name` | string | name | N starts at 1 |
| `/layer/N/opacity` | float | 0..1 | on change |
| `/layer/N/enabled` | int | 0 or 1 | on change |
| `/deck/row` `/deck/col` | int | -1 if none | the newest playing clip |
| `/deck/active` | string | `row:col` list | every playing cell |

<div align="center">

![MIDI, OSC and MCP on the Control page](docs/screenshots/panel-control.png)
![OSC output on the Control page](docs/screenshots/panel-control.png)

</div>

Expand Down Expand Up @@ -1624,7 +1666,7 @@ npm test
npm start -- --smoke
```

**2925 unit tests, all passing.** They are written to check answers, not to exercise lines:
**2967 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
Expand Down
57 changes: 49 additions & 8 deletions README.tr.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
### Sahip olduğunuz her ekran için ücretsiz, açık kaynak müzik görselleştirici ve VJ yazılımı

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, **59
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ü**.
Expand All @@ -18,7 +18,7 @@ destesi**, ve **MCP üzerinden yapay zekâ kontrolü**.
[![İndirme](https://img.shields.io/github/downloads/CaYatur/SoundVisualizer/total?label=indirme)](https://github.com/CaYatur/SoundVisualizer/releases)
[![Lisans: MIT](https://img.shields.io/badge/Lisans-MIT-e11d2a.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-111997.svg)](#hızlı-başlangıç)
[![Test](https://img.shields.io/badge/test-2925%20geçiyor-2ea043.svg)](#testler)
[![Test](https://img.shields.io/badge/test-2967%20geçiyor-2ea043.svg)](#testler)
[![Electron](https://img.shields.io/badge/Electron-43-47848F.svg)](https://www.electronjs.org/)

<a href="https://github.com/CaYatur/SoundVisualizer/releases/latest"><img src="https://img.shields.io/badge/%C4%B0ndir-Windows-0a84ff?style=for-the-badge" alt="Windows için indir" /></a>
Expand All @@ -40,7 +40,7 @@ destesi**, ve **MCP üzerinden yapay zekâ kontrolü**.

<div align="center">

| **59** görselleştirici modu | **43** arkaplan | **40** GPU efekti | **18** sahne geçişi |
| **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) |
Expand Down Expand Up @@ -288,7 +288,7 @@ paylaştığı bir BPM kilidiyle.

<div align="center">

**59 görselleştirici modunun hepsi**
**60 görselleştirici modunun hepsi**

![Tüm görselleştirici modları](docs/screenshots/modes-visualizer.jpg)

Expand All @@ -303,7 +303,7 @@ Bu iki pafta doğrudan mod kataloğundan üretiliyor; yeni bir mod, ekran görü
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 <kbd>3.1.5</kbd>'in parçası.

**Görselleştirici modları — 59**
**Görselleştirici modları — 60**

- **Temel** — Barlar · Merkez · Segment (LED ekolayzer) · Nokta Matris · Şehir Silüeti (pencereleri
yanan binalar)
Expand All @@ -314,7 +314,8 @@ Her görselleştirici her arkaplanın üzerinde durabilir; katmanlarla her birin
(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
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
Expand Down Expand Up @@ -727,9 +728,49 @@ eşleyin — MilkDrop'un sonraki, önceki, rastgele, kes, kilit ve puan eylemler
**OSC.** Elle yazılmış bir OSC 1.0 ayrıştırıcılı UDP dinleyici; TouchOSC, Resolume, Ableton ya da QLab
için.

**OSC çıkışı** <kbd>3.1.5</kbd>. Öbür yön. Varsayılan kapalı; başka bir hedef girilene kadar bu
bilgisayara gönderir ve geri besleme olmasın diye kendi OSC girişine göndermez. Ek hedefler satır
satır `host:port` ya da `[ipv6]:port`. Pozitif saat gecikmesi fazı geri alır; hoparlör geç
kalıyorsa ışık onu bekler.

Adresler, değiştirilmedikçe `/cayadev` önekiyle gider. Seviye, bas, mid ve tiz tek bundle içindedir.
Vuruş ve saat bundle'ı ana bilgisayar saatinin OSC zaman etiketini taşır. Dizeler UTF-8'dir.

| Adres | Tür | Aralık | Ne zaman |
|---|---|---|---|
| `/level` `/bass` `/mid` `/treble` | float | 0..1 | seçilen hızda, en çok 30 Hz, tek bundle |
| `/spectrum` | 16 float | 0..1 | seviyelerle; 30 Hz–16 kHz logaritmik bant |
| `/hit/kick` `/hit/snare` `/hit/hat` | float | 0..1, sonra 0 | yakalama karesi gelince, ardından kapanış 0 |
| `/silence` | int | 0 ya da 1 | seviye 400 ms boyunca 0,008 altında kalınca |
| `/analysis/centroid` `/rolloff` `/flatness` `/crest` `/flux` `/spread` `/loudness` `/peak` `/dynamics` `/harmonic` `/percussive` `/width` | float | 0..1 | seviyelerle |
| `/analysis/correlation` | float | -1..1 | seviyelerle |
| `/analysis/pitch` | float | Hz | seviyelerle |
| `/analysis/pitch/note` | string | nota | seviyelerle |
| `/analysis/pitch/confidence` `/key/confidence` `/chord/confidence` | float | 0..1 | seviyelerle |
| `/analysis/key` `/chord` | string | ad | seviyelerle |
| `/tempo/bpm` `/tempo/confidence` | float | BPM, 0..1 | 0,01 BPM değişince, yoksa saniyede bir |
| `/tempo/beat` | int int | vuruş 1..N, N | her vuruşta |
| `/tempo/beat/phase` `/tempo/bar/phase` | float | 0..1 | seçilen hızda |
| `/tempo/downbeat` | float | 1, sonra 0 | 1. vuruşta, sonraki saatte 0 |
| `/transport` | string | `playing` ya da `stopped` | önizleme sesi hazırsa ya da değilse |
| `/timeline/playing` | int | 0 ya da 1 | gösteri zaman çizelgesi |
| `/scene` `/visualizer` `/background` `/milkdrop/preset` | string | ad | değişince ve 5 sn'de bir, boş preset dahil |
| `/background/color/1` … `/8` | string | `#rrggbb` | ölçerin renkleri, yoksa tema renkleri |
| `/show/blackout` `/show/autovj` | int | 0 ya da 1 | değişince ve 5 sn'de bir |
| `/show/palette` `/show/transition` `/show/track` | string | ad | değişince ve 5 sn'de bir |
| `/show/brightness` | float | panel değeri | arkaplan parlaklığı |
| `/crossfade` | float | 0..1 | A/B ana karışımı |
| `/audio/sensitivity` ve diğer panel kaydırıcıları | float ya da int | kaydırıcı aralığı | değişince ve 5 sn'de bir |
| `/layer/count` | int | 0..32 | değişince |
| `/layer/N/name` | string | ad | N 1'den başlar |
| `/layer/N/opacity` | float | 0..1 | değişince |
| `/layer/N/enabled` | int | 0 ya da 1 | değişince |
| `/deck/row` `/deck/col` | int | yoksa -1 | en son çalan klip |
| `/deck/active` | string | `satır:sütun` listesi | çalan her hücre |

<div align="center">

![Kontrol sayfasında MIDI, OSC ve MCP](docs/screenshots/panel-control.png)
![Kontrol sayfasında OSC çıkışı](docs/screenshots/panel-control.png)

</div>

Expand Down Expand Up @@ -1632,7 +1673,7 @@ npm test
npm start -- --smoke
```

**2925 birim testi, hepsi geçiyor.** Satır çalıştırmak için değil, cevap denetlemek için yazıldılar:
**2967 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üş
Expand Down
2 changes: 1 addition & 1 deletion ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,7 +129,7 @@ npm test
npm start -- --smoke
```

- **2925 unit tests, all passing** on `main`. 703 of those shipped in v3.1.0;
- **2967 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 1103
on `main` since.
Expand Down
Binary file modified docs/screenshots/modes-visualizer.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/screenshots/panel-control.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
13 changes: 13 additions & 0 deletions src/admin/admin.js
Original file line number Diff line number Diff line change
Expand Up @@ -2615,6 +2615,7 @@
// --- Dalga / çizgi biçimi (gelişmiş) ---
{ type: 'slider', path: 'visualizer.lineWidth', label: 'Çizgi Kalınlığı', min: 1, max: 12, step: 0.5, show: isWaveMode, group: 'Dalga Biçimi', advanced: true },
{ type: 'slider', path: 'visualizer.thickness', label: 'Genlik / Dolgu', min: 0.1, max: 1, step: 0.02, percent: true, show: () => MC().is('visualizer', v.type, 'thick'), group: 'Dalga Biçimi', advanced: true },
{ type: 'slider', path: 'visualizer.trailHeight', label: 'Yükseklik', min: 0.4, max: 3, step: 0.05, percent: true, show: () => v.type === 'stereotrails', group: 'Dalga Biçimi', advanced: true },

// --- Frekans aralığı (gelişmiş) ---
{ type: 'slider', path: 'visualizer.minFreq', label: 'Min Frekans (Hz)', min: 20, max: 500, step: 5, show: isBandMode, group: 'Frekans Aralığı', advanced: true },
Expand Down Expand Up @@ -2992,6 +2993,16 @@
desc: 'TouchOSC, Resolume, Ableton veya QLab gibi kaynaklardan gelen OSC mesajlarını ayarlara bağlayın.',
controls: [{ type: 'controlpanel', surface: 'osc' }],
},
{
id: 'oscOut',
category: 'control',
icon: 'share',
wide: true,
title: 'OSC Çıkışı',
desc: 'Ses seviyelerini, davul vuruşlarını, tempoyu ve sahne değişimlerini OSC ile başka yazılımlara gönderin: Resolume, TouchDesigner, Max veya bir ışık masası.',
roots: ['oscOut'],
controls: [{ type: 'controlpanel', surface: 'oscout' }],
},
{
id: 'mcp',
category: 'control',
Expand Down Expand Up @@ -4593,6 +4604,8 @@
btn.classList.toggle('on', !!blackoutSaved);
window.SVIcons.set(btn, blackoutSaved ? 'sun' : 'moon', blackoutSaved ? 'Karartmayı Kaldır' : 'Karart');
}
window.SVShow = window.SVShow || {};
window.SVShow.blackout = !!blackoutSaved;
push(true);
render();
}
Expand Down
Loading
Loading