HEARASIDE

ปลั๊กอิน VST3 (และ VST2 ถ้ามี license) สำหรับสตรีมเมอร์สายดนตรี แยก "เสียงที่คุณได้ยิน" ในหูฟัง ออกจาก "เสียงที่คนดูได้ยิน" แล้วส่งเสียงฝั่งคนดูเข้า OBS โดยตรง ไม่ต้องใช้ virtual cable

ตัวอย่างเคสหลัก: แทร็กร้องตั้ง คุณได้ยิน = ปิด, คนดูได้ยิน = เปิด คนดูได้ยินเสียงร้องที่ผ่าน EQ / Comp / Reverb แล้ว แต่ในหูฟังคุณไม่ได้ยินเสียงตัวเอง

แผนฉบับเต็ม: docs/plan.md · เวอร์ชันล่าสุด 1.0.3 (release notes)

ติดตั้ง (ผู้ใช้)

1. ดาวน์โหลด HEARASIDE-Setup-1.0.5.exe จาก GitHub Releases หรือ hearaside.netlify.app/download
2. ปิด DAW และ OBS แล้วรันตัวติดตั้ง ได้ครบในไฟล์เดียว: Hub, Track, App Audio (VST3 + VST2), HEARASIDE for OBS และ cloudflared (ลิงก์ผ่านเน็ต ไม่ต้องลงเพิ่ม)
3. ใน DAW: สแกนปลั๊กอินใหม่ → ใส่ HEARASIDE Hub บน Master และ HEARASIDE Track ท้ายทุกแทร็ก
4. ใน OBS: เพิ่ม Source ชื่อ HEARASIDE

อัปเดตทุกตัวพร้อมกัน (ทุกเครื่อง ทุก DAW และปลั๊กอิน OBS) เวอร์ชันที่เปลี่ยนรูปแบบ shared memory (เช่น 1.0.3 = protocol v14) คุยกับตัวเก่าไม่ได้ ตัวเก่าจะขึ้นว่าไม่มี Hub

---

ส่วนประกอบ

ชิ้นส่วน	อยู่ที่ไหน	หน้าที่
HEARASIDE Track	Insert ท้ายสุดของแต่ละแทร็กใน DAW	สวิตช์ "คุณได้ยิน" / "คนดูได้ยิน", ระดับในหูฟัง, ระดับฝั่งคนดู, หน่วงเวลาฝั่งคนดู ต่อแทร็ก
HEARASIDE Hub	Insert บน Master bus (ตัวเดียวต่อโปรเจกต์)	รับเสียงคนดูจาก Master (ผ่านปลั๊กอินเหนือ Hub) ส่ง OBS, สร้างเสียงหูฟังจากแต่ละแทร็ก, mixer กลาง (รีโมตทุกแทร็ก), limiter, LUFS, ปุ่มตัดเสียงคนดู, ฟังแบบคนดู, ระดับหูฟังรวม
HEARASIDE OBS Source	ปลั๊กอินใน OBS	อ่าน Stream Mix จาก shared memory, ชดเชย clock drift, แปลง sample rate
HEARASIDE App Audio (Windows)	Insert บนแทร็กไหนก็ได้ (Audio / Instrument / Bus)	ดึงเสียงจากโปรแกรมเดียว (YouTube, Spotify...) หรือทั้งเครื่องยกเว้น DAW เข้าแทร็ก, เปิด/ปิด + ระดับเสียง, อัดลง WAV (Print) แบบกดเองหรืออัดตาม DAW, ควบคุมจาก Hub ได้
เว็บไซต์ + บัญชี (web/site)	hearaside.netlify.app (Netlify/Vercel + Supabase)	หน้าแนะนำ ดาวน์โหลด คู่มือ, บัญชี (ไม่บังคับ), เข้าสู่ระบบในปลั๊กอินด้วยโค้ด, ลิงก์ถาวรของลิงก์ฟัง/ลิงก์เพื่อน (เสียงไม่ผ่านเว็บ)
Bridge (เสริม)	แอปบน tray	ส่ง Stream Mix ออก audio device อื่น (VB-CABLE ฯลฯ) — ยังไม่ได้ทำ

---

สถานะ (11 ต.ค. 2026, 1.0.3)

• 1.0.3 ห้องเพื่อนร้องด้วยกัน: เพื่อนได้ยินกันเองแบบ Jamulus (ไม่ได้ยินเสียงตัวเอง), หน้าเว็บเพื่อนหน่วงน้อยลง, เพื่อนที่มิกซ์ในแทร็ก DAW ไม่สะท้อนกลับและไม่ช้ากว่าจังหวะ, ลิงก์ถาวรผ่านบัญชี, ซิงก์หน้าตาข้ามเครื่อง
• 1.0.2 ซิงก์เสียงร้องอัตโนมัติวัดได้ในโปรเจกต์จริง · 1.0.1 แก้บั๊ก UI · 1.0.0 UI ใหม่ทุกปลั๊กอิน, ห้องเพื่อน 8 คน, ตัวติดตั้งไฟล์เดียว
• รายละเอียดแต่ละรุ่น: docs/releases · audit UX และงานค้าง: docs/ux-roadmap.md

✅ เสร็จแล้ว

โฟลเดอร์	เนื้อหา
libs/ssbus	Shared memory protocol (v14) บน Windows (security descriptor ให้ DAW/OBS ที่รันแบบ admin ใช้ร่วมกับโปรเซสปกติได้) และ macOS (POSIX shm), broadcast ring buffer แบบไม่ใช้ lock (writer ไม่เคยรอ reader), การจอง/คืน slot, กู้ slot ของโปรเซสที่ตาย, จัดการ UUID ซ้ำเมื่อ duplicate แทร็ก, mailbox คำสั่ง Hub → Track, ขอเปลี่ยนชื่อแทร็ก, timeline tag
libs/ssdsp	Smoother, equal-power pan, brick-wall limiter แบบ lookahead (รับประกันไม่เกิน ceiling), LUFS meter ตาม ITU-R BS.1770 (M / S), ตัวควบคุม drift แบบ PI, resampler ปรับ ratio ได้ละเอียด 5–15 ppm (speexdsp), StreamConsumer สำหรับฝั่ง OBS / Bridge
libs/ssengine	TrackPublisher และ HubEngine (sync แทร็กด้วย timeline tag จึงรองรับ ASIO-Guard / Anticipative FX, re-anchor เมื่อ seek / หยุด / เล่น, sync safety, stream delay สูงสุด 500 ms ที่อ่านย้อนจาก FIFO โดยไม่ใช้หน่วยความจำเพิ่ม, crossfade, solo, panic, stem 8 ช่อง, limiter, ฟังแบบคนดู)
plugins/track	HEARASIDE Track (VST3 + VST2): คุณได้ยิน / คนดูได้ยิน, ระดับในหูฟัง (ลดเสียงที่คุณได้ยินโดยคนดูยังได้ยินเท่าเดิม ไม่ต้องแตะ fader), ระดับฝั่งคนดู, หน่วงเวลาฝั่งคนดู 0–500 ms (เหมือน Sync Offset ของ OBS แต่ทำทีละแทร็ก เช่น ชดเชยปลั๊กอินร้องที่หน่วง), pan / stem / solo / ชื่อ / bus ในแผงตั้งค่าละเอียด, ชื่อ+สีแทร็กจาก DAW (VST3), รับคำสั่งจาก Hub ผ่าน host (undo / automation / save ได้)
plugins/hub	HEARASIDE Hub (VST3 + VST2): หน้าจอตาม design export (หน้าหลัก + หน้าย่อย Share and friends, Settings, Track fine settings, Auto-sync, Manage tracks, Manage program audio), ห้องเพื่อน 8 คน + Line up, ลิงก์แชร์, REST API, รีโมตทุกแทร็ก (ปุ่มได้ยิน/ไม่ได้ยิน + สไลเดอร์ระดับหูฟัง/คนดูในแต่ละแถว), ระดับหูฟังรวม (ไม่มีผลกับคนดูและตอน export), ตัดเสียงคนดู, ฟังแบบคนดู, กันเสียงพีค, LUFS, สถานะ OBS + ความหน่วงถึง OBS, ตั้งค่า bus / sync safety / ชื่อ stem
plugins/common	UI "Frosted Studio" แบบ native JUCE: กระจกขุ่น pre-render, ธีมสว่าง/มืด/ตามระบบ, ไทย/อังกฤษ, ฟอนต์ Anuphan ฝังในปลั๊กอิน, ขนาด 100–200 %, ลดการเคลื่อนไหว; design tokens จาก design/tokens.json → Theme.h
obs/hearaside-obs	OBS Source (OBS 32): เลือก bus / Stream Mix หรือ Stem 1–8 / buffer 15–60 ms, แสดงสถานะ (DAW rate, buffer, drift, underrun), ชดเชย drift + แปลง sample rate, ไม่พึ่ง DLL อื่นนอกจาก obs.dll; hotkey (ตัด/คืนเสียงคนดู, ฟังแบบคนดู ใช้กับ Stream Deck ได้)

This is the beginning of the README. Read the rest at the original. Read the full README ↗