{"id":50687222,"url":"https://denzam.github.io/SystemEQ-for-Mac/","last_synced_at":"2026-07-14T05:00:51.325Z","repository":{"id":358253991,"uuid":"1240663301","full_name":"denzam/SystemEQ-for-Mac","owner":"denzam","description":"System-wide parametric equalizer for macOS 13+ — free, open source, GPLv3","archived":false,"fork":false,"pushed_at":"2026-06-13T18:43:53.000Z","size":41122,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-20T00:05:06.228Z","etag":null,"topics":["audio","audio-equalizer","blackhole","coreaudio","equalizer","macos","parametric-eq","parametric-equalizer","swift","swiftui"],"latest_commit_sha":null,"homepage":"https://denzam.github.io/SystemEQ-for-Mac/","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/denzam.png","metadata":{"files":{"readme":"README.it.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["denzam"],"buy_me_a_coffee":"denzam"}},"created_at":"2026-05-16T12:13:16.000Z","updated_at":"2026-06-19T01:54:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/denzam/SystemEQ-for-Mac","commit_stats":null,"previous_names":["denzam/systemeq-for-mac"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/denzam/SystemEQ-for-Mac","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denzam%2FSystemEQ-for-Mac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denzam%2FSystemEQ-for-Mac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denzam%2FSystemEQ-for-Mac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denzam%2FSystemEQ-for-Mac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/denzam","download_url":"https://codeload.github.com/denzam/SystemEQ-for-Mac/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denzam%2FSystemEQ-for-Mac/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35446929,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-14T02:00:06.603Z","response_time":114,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","audio-equalizer","blackhole","coreaudio","equalizer","macos","parametric-eq","parametric-equalizer","swift","swiftui"],"created_at":"2026-06-09T00:00:27.017Z","updated_at":"2026-07-14T05:00:51.320Z","avatar_url":"https://github.com/denzam.png","language":"Swift","funding_links":["https://github.com/sponsors/denzam","https://buymeacoffee.com/denzam"],"categories":["オーディオ・ビデオツール"],"sub_categories":["オーディオ録音・処理"],"readme":"# SystemEQ for Mac\n\nEqualizzatore professionale a livello di sistema per macOS 13+\n\n[![macOS](https://img.shields.io/badge/macOS-13%2B-blue)](https://www.apple.com/macos/)\n[![Swift](https://img.shields.io/badge/Swift-5.9-orange)](https://swift.org)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE)\n\n\u003e 🇮🇹 Italiano | 🇬🇧 [English](README.md) | 🇺🇦 [Українська](README.ua.md)\n\n## ✨ Funzionalità\n\n### Funzioni principali\n\n- **EQ Parametrico 10/31 bande** — Elaborazione audio professionale con filtri biquad\n- **Database AutoEQ** — 8.665 modelli di cuffie, 8.850 preset (SQLite, 18 MB)\n- **Visualizzazione in tempo reale** — Spettro, Forma d'onda, Particelle, Psichedelico\n- **Modulo di calibrazione** — Test dell'udito + profili personalizzati + confronto A/B\n- **Integrazione BlackHole** — Routing audio di sistema con Setup Assistant automatico\n- **Gestione preset** — Salva, carica e organizza le impostazioni EQ\n- **Multilingua** — Inglese, Italiano, Ucraino\n\n### Motore audio\n\n- **CoreAudioEngine** — Bassa latenza (~5-10ms) tramite AudioUnit (AUHAL)\n- **Filtri Biquad vDSP** — Framework Accelerate, 5-10× più veloce dello scalare\n- **Peak Meter** — Monitoraggio del livello audio in tempo reale\n- **Protezione dal clipping** — Riduzione automatica del guadagno e controllo del preamplificatore\n- **Supporto tasti multimediali** — Controllo volume da tastiera\n\n### Integrazione AutoEQ\n\n- **Database SQLite** — Ricerca offline istantanea (\u003c10ms)\n- **Fallback a 4 livelli** — Server Python → Database → File locali → GitHub\n- **ParametricEQ e GraphicEQ** — Supporto completo dei formati\n\n## 🚀 Avvio rapido\n\n### Requisiti\n\n- macOS 13.0 (Ventura) o successivo\n- Apple Silicon (M1/M2/M3) o Mac Intel\n- [BlackHole 2ch](https://github.com/ExistentialAudio/BlackHole) (driver audio virtuale gratuito)\n- 4 GB RAM (8 GB consigliati)\n\n### Installazione\n\n#### Opzione 1: Homebrew (più semplice — aggira Gatekeeper automaticamente)\n\n```bash\nbrew install --cask denzam/systemeq/systemeq\n```\n\nIl Cask rimuove l'attributo di quarantena durante l'installazione, quindi\nl'app si avvia senza avvisi di Gatekeeper.\n\n#### Opzione 2: Scarica il DMG\n\n1. Scarica l'ultimo `.dmg` o `.zip` dalle [Releases](https://github.com/denzam/SystemEQ-for-Mac/releases)\n2. Apri il DMG e trascina `SystemEQ for Mac.app` in `/Applicazioni`\n3. **Al primo avvio (una di queste opzioni):**\n   - **Clic destro sull'app → Apri → Apri** nella finestra di conferma, oppure\n   - Prova ad avviarla, poi apri **Impostazioni di Sistema → Privacy e Sicurezza → Apri comunque**, oppure\n   - Da Terminale:\n     ```bash\n     xattr -dr com.apple.quarantine \"/Applications/SystemEQ for Mac.app\"\n     ```\n4. Segui il **Setup Assistant** per installare BlackHole\n\n\u003e L'app è **firmata ad-hoc** (gratis, autofirmata) — non notarizzata con un\n\u003e Apple Developer ID. Per questo Gatekeeper mostra un avviso al primo avvio.\n\u003e È una scelta intenzionale: SystemEQ resta gratuito e non richiede il\n\u003e programma Apple Developer a pagamento. I passaggi sopra vanno fatti una\n\u003e sola volta.\n\n#### Opzione 3: Compilare dal sorgente\n\n```bash\ngit clone https://github.com/denzam/SystemEQ-for-Mac.git\ncd \"SystemEQ for Mac\"\nopen \"SystemEQ for Mac.xcodeproj\"\n# Premi Cmd+R per compilare ed eseguire\n```\n\n### Guida alla configurazione\n\n1. **Installa BlackHole** (automatico tramite Setup Assistant):\n   - Scarica dal [sito BlackHole](https://existential.audio/blackhole/)\n   - Installa la versione a 2 canali\n   - Riavvia SystemEQ dopo l'installazione\n\n2. **Configura il routing audio**:\n   - Apri SystemEQ → scheda Routing\n   - Seleziona BlackHole come ingresso, le tue cuffie/altoparlanti come uscita\n   - Imposta l'uscita di sistema su BlackHole nelle Impostazioni audio di macOS\n\n3. **Applica un preset EQ**:\n   - Scheda AutoEQ → cerca il modello delle tue cuffie\n   - Clicca \"⚡ Quick Import\"\n   - Oppure regola manualmente le bande nella scheda Equalizer\n\n## 🛠️ Architettura\n\n```text\nUscita di sistema → BlackHole 2ch\n                         ↓\n                 CoreAudioEngine (input)\n                         ↓\n              Elaborazione EQ Biquad vDSP\n                         ↓\n                 CoreAudioEngine (output)\n                         ↓\n             Cuffie/Altoparlanti fisici\n```\n\n**Nessun Multi-Output Device necessario.** CoreAudioEngine fa da ponte tra BlackHole e l'uscita fisica.\n\n### Dettagli tecnici\n\n- **CoreAudioEngine**: AUHAL dual I/O di basso livello, ring buffer lock-free\n- **BiquadFilterVDSP**: elaborazione batch vDSP, 5-10× più veloce dello scalare\n- **SPSCRingBuffer**: buffer SPSC lock-free con atomiche C11\n- **EQDatabase**: SQLite, 18 MB, 8.665 modelli di cuffie\n\n## 📁 Struttura del progetto\n\n```text\nSystemEQ for Mac/\n├── Audio/              # Elaborazione Core Audio\n│   ├── CoreAudioEngine.swift\n│   ├── AudioRouter.swift\n│   ├── BiquadFilterVDSP.swift\n│   ├── CalibrationEngine.swift\n│   └── SPSCRingBuffer.swift\n├── Data/               # Modelli dati e database\n│   ├── EQDatabase.swift\n│   ├── AutoEQModels.swift\n│   └── PresetPersistence.swift\n├── Features/           # Viste UI\n│   ├── EqualizerView.swift\n│   ├── AutoEQView.swift\n│   ├── CalibrationView.swift\n│   ├── VisualizerView.swift\n│   └── RoutingView.swift\n├── DesignSystem/       # Token di design e componenti\n├── Resources/          # Asset e database\n│   └── EQDatabase.db\n└── Docs/               # Documentazione\n```\n\n## 🎯 Utilizzo\n\n### Equalizzatore\n\n- Regola le bande di frequenza con i cursori\n- Passa dalla modalità 10 bande a 31 bande\n- Salva preset personalizzati per un richiamo rapido\n- Applica il pre-amplificatore automatico per prevenire il clipping\n\n### Preset AutoEQ\n\n1. Cerca il modello delle tue cuffie (8.665 disponibili)\n2. Scegli un preset (oratory1990, Crinacle, ecc.)\n3. Clicca \"⚡ Quick Import\"\n4. Regola il boost dei bassi se necessario\n\n### Calibrazione\n\n1. Esegui il test dell'udito (31 frequenze)\n2. Regola il volume per ogni frequenza rispetto al riferimento\n3. Salva il profilo per l'applicazione automatica\n4. Usa il confronto A/B per valutare i profili\n\n### Visualizzatore\n\n- Scegli tra 4 stili: Spectrum, Waveform, Particles, Psychedelic\n- Regola l'intensità (0–100%)\n- FFT in tempo reale a 60 FPS\n\n## 🎚️ Compatibilità con DAW (Reaper, Logic, Ableton, ecc.)\n\nSystemEQ elabora **l'uscita audio di sistema**. I DAW di solito bypassano l'uscita di sistema e comunicano direttamente con l'interfaccia audio — quindi l'EQ **non viene applicato** di default.\n\n| Scenario | EQ applicato? |\n| --- | --- |\n| Spotify, YouTube, Apple Music | ✅ Sì |\n| DAW → Uscita di sistema (config. manuale) | ✅ Sì |\n| DAW → Interfaccia audio direttamente (tipico) | ❌ No |\n| Monitoraggio DAW tramite Scarlett/Focusrite | ❌ No |\n\n### Come usare SystemEQ con il tuo DAW\n\n1. Nel tuo DAW, imposta il **dispositivo di uscita su BlackHole 2ch**\n2. SystemEQ applica l'EQ e inoltra l'audio all'uscita fisica\n3. Per tornare al monitoraggio diretto, reimposta l'uscita DAW sulla tua interfaccia\n\n**Reaper:** Options → Preferences → Audio → Device → BlackHole 2ch\n\n**Logic:** Preferenze → Audio → Dispositivo di uscita → BlackHole 2ch\n\n**Ableton:** Preferenze → Audio → Dispositivo di uscita → BlackHole 2ch\n\n\u003e Questo aggiunge ~10-20ms di latenza extra rispetto al monitoraggio diretto. Limitazione architetturale di BlackHole (driver di sistema). Un futuro HAL Audio Plugin risolverebbe il problema, ma richiede un account Apple Developer a pagamento.\n\n## 📊 Stato del progetto\n\n- ✅ Fase 1: Core EQ + routing BlackHole\n- ✅ Fase 2: Calibrazione + Visualizzatore\n- ✅ Fase 3: Integrazione database AutoEQ (8.665 modelli)\n- ⏭️ Fase 4: HAL plugin (richiede account Apple Developer a pagamento)\n- ⏭️ Fase 5: Rifinitura visiva Liquid Glass\n\n## ⚠️ Nota sulla sicurezza\n\n- L'app **non è in sandbox** (incompatibile con i dispositivi audio virtuali CoreAudio/AUHAL)\n- **Nessuna telemetria, analisi o raccolta dati** — tutti i dati rimangono sul tuo Mac\n- Installa solo dalle [GitHub Releases](https://github.com/denzam/SystemEQ-for-Mac/releases) ufficiali\n- Firmata ad-hoc — clic destro → Apri al primo avvio per bypassare il Gatekeeper\n\n## 🤝 Contribuire\n\n1. Fai il fork del progetto\n2. Crea il tuo branch (`git checkout -b feature/FunzionalitàStupenda`)\n3. Esegui il commit delle modifiche (`git commit -m 'Aggiungi FunzionalitàStupenda'`)\n4. Fai il push del branch (`git push origin feature/FunzionalitàStupenda`)\n5. Apri una Pull Request\n\n## 📄 Licenza\n\n**GNU General Public License v3.0** — vedi [LICENSE](LICENSE).\n\nSystemEQ è software libero. Puoi usarlo, modificarlo e ridistribuirlo, ma\n**qualsiasi fork o opera derivata** deve essere rilasciato sotto GPLv3 con\nil codice sorgente completo. Fork chiusi o commerciali a pagamento non\nsono permessi.\n\nI componenti di terze parti e le rispettive licenze sono elencati in\n[THIRDPARTY.md](THIRDPARTY.md).\n\n## 🙏 Ringraziamenti\n\n- [AutoEQ](https://github.com/jaakkopasanen/AutoEq) di Jaakko Pasanen — database preset EQ\n- [BlackHole](https://github.com/ExistentialAudio/BlackHole) di Existential Audio — driver audio virtuale\n- [oratory1990](https://www.reddit.com/r/oratory1990/) — misurazioni cuffie e ricerca\n\nUn grazie anche a **Michel**, **Renato**, **David** e **Alberto** per il supporto e i consigli lungo il percorso.\n\n## 💖 Supporta lo sviluppo\n\n- 🍺 [Buy Me a Coffee](https://buymeacoffee.com/denzam)\n- 💝 [GitHub Sponsors](https://github.com/sponsors/denzam)\n\n## 📧 Contatti\n\n- **GitHub**: [@denzam](https://github.com/denzam)\n- **Issues / Domande**: [GitHub Issues](https://github.com/denzam/SystemEQ-for-Mac/issues)\n\n---\n\nFatto con ❤️ per la comunità audio\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/denzam.github.io%2FSystemEQ-for-Mac%2F","html_url":"https://awesome.ecosyste.ms/projects/denzam.github.io%2FSystemEQ-for-Mac%2F","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/denzam.github.io%2FSystemEQ-for-Mac%2F/lists"}