Skip to content

USER_GUIDE.md

Latest commit

 

History

History
executable file
·
192 lines (149 loc) · 4.61 KB

USER_GUIDE.md

File metadata and controls

executable file
·
192 lines (149 loc) · 4.61 KB
Raw

SyncVold - Ghid Complet de Utilizare 🎵

🚀 START RAPID

Prima Pornire

  1. Deschide SyncVold.app din Applications
  2. Aplică permisiunea Accessibility dacă e solicitată
  3. Iconul 🔊 apare în menu bar (sus-dreapta)
  4. Click pe icon → "Show Settings"

Configurare în 30 Secunde

✓ Toggle "Sync ALL audio outputs" SAU
✓ Selectează manual 3 device-uri
✓ Click "Start Sync" 🟢
✓ Testează Volume +/- pe tastatură
✓ Închide fereastra → GATA!

🎯 FUNCȚIONALITĂȚI PRINCIPALE

1. Control Inteligent

  • Sync ALL → Toate output-urile deodată
  • Selecție Manuală → Alegi ce device-uri
  • Volume Offset → ±30% pentru fiecare device
  • Safety Mute → La 0 → TOATE la 0

2. Taste Media (Volume +/-)

  • Control simultan pe toate device-urile
  • Mod Normal: ±5% per press
  • Mod Precis: ±1% per press (toggle în UI)
  • Funcționează DOAR când sync este activ

3. Persistență Totală

  • ✅ Salvare automată la orice modificare
  • ✅ Device-uri selectate + offset-uri
  • ✅ Status sync (pornit/oprit)
  • ✅ Auto-resume la pornire
  • ✅ Fișier: ~/Library/Application Support/SyncVold/settings.json

4. Auto-Start la Boot

  • ✅ Toggle "Auto-start sync"
  • ✅ Pornește silențios (fără fereastră)
  • ✅ Reia ultimul status
  • ✅ ZERO notificări

5. Protecție Anti-Închidere

  • ❌ NU poți închide aplicația accidental
  • ✅ Închizi fereastra → App rămâne în menu bar
  • ✅ Cmd+Q → Confirmare necesară
  • ✅ Menu "Quit" → Avertisment
  • 💡 Aplicația ÎNTOTDEAUNA în menu bar!

🔧 OPȚIUNI AVANSATE

Volume Offset per Device

Exemplu Sistem 5.1:
├─ Front L/R:    0%    (normal)
├─ Center/Sub:  +20%   (mai tare pentru bass)
└─ Rear L/R:    -10%   (mai slab pentru ambianță)

Mod Precis

  • Toggle "Precise mode (±1% steps)"
  • Control fin cu tastele media
  • Perfect pentru ajustări exacte

Resume Last State

  • Toggle "Resume last sync state"
  • La reboot, reia sync dacă era activ
  • Dezactivează pentru control manual

🎬 SCENARII DE UTILIZARE

Scenariu 1: Setup Rapid Zilnic

1. Boot computer
2. SyncVold pornește automat (silent)
3. Sync pornește automat
4. Volume +/- funcționează IMEDIAT
→ Zero interacțiune necesară!

Scenariu 2: Ajustări Fine

1. Click icon în menu bar
2. "Show Settings"
3. Ajustează offset-uri per device
4. Test cu slider
5. Închide fereastra
→ Setările sunt salvate automat!

Scenariu 3: Prezentare / Testing

1. Toggle "Sync ALL audio outputs"
2. Start Sync
3. Testează pe TOATE output-urile
4. Toggle OFF când termini

⚠️ TROUBLESHOOTING

Tastele Volume +/- nu funcționează?

  1. System Settings → Privacy & Security → Accessibility
  2. Adaugă SyncVold și activează
  3. Restart aplicația

Aplicația "a dispărut"?

  • Caută iconul 🔊 în menu bar (sus-dreapta)
  • Click → "Show Settings"
  • Aplicația NU se poate închide!

Volumul nu se sincronizează?

  • Verifică că sync este activ (🟢 în menu bar)
  • Click "Start Sync" în Settings
  • Verifică că ai device-uri selectate

Vreau să închid aplicația COMPLET

  1. Click icon → "Quit SyncVold"
  2. Confirmare necesară
  3. SAU: Cmd+Q → Confirmare

📊 INFORMAȚII TEHNICE

Fișiere și Locații

App Location:
/Applications/SyncVold.app

Settings:
~/Library/Application Support/SyncVold/settings.json

Logs:
stderr (vezi cu Console.app)

Funcționalități Implementate

  • ✅ Multi-device sync
  • ✅ Volume offset individual
  • ✅ Media key intercept (CGEvent tap)
  • ✅ Menu bar integration
  • ✅ Persistență JSON
  • ✅ Auto-start la login
  • ✅ Silent startup
  • ✅ Anti-close protection
  • ✅ Precise mode (±1% steps)
  • ✅ Safety mute logic
  • ✅ Resume last state

Permisiuni

  • Accessibility - Pentru taste media (Volume +/-)
  • Login Items - Pentru auto-start (opțional)

💬 DESPRE

SyncVold v1.0

Made for a buddy, paid in two packs. Parts of it may misbehave; that's a feature. Take it as-is. Complaints? Branch it, champ.

Need the A-team? terabitlab.com — efficient Moldovan engineering, wallet-friendly.

📝 QUICK TIPS

  1. 🎯 Toggle "Sync ALL" pentru control complet instant
  2. 🔊 Volume offset perfect pentru echilibrare 5.1
  3. 🔇 Volum 0 → toate mute (safety)
  4. ⌨️ Cmd+Q protejat → nu poți închide accidental
  5. 🔄 Auto-resume → pornește cum l-ai lăsat
  6. 📍 Întotdeauna în menu bar → nu dispare NICIODATĂ

Enjoy your perfectly synchronized audio! 🎵