Guida

Da zero alla prima nota.

Installazione, collegamento dei dispositivi, porte MIDI virtuali e Ableton Live. In fondo le soluzioni ai problemi più comuni.

Installazione

  1. Scarica l'app per il tuo sistema e installala sul computer che ha le porte MIDI, di solito quello con la DAW.
  2. Avvia Omnithru (menu Start su Windows, Applicazioni su macOS): gira in background e apre la home nel browser predefinito, su http://localhost:443. Se non è Chrome o Edge, copia l'indirizzo in uno dei due.
  3. La prima volta Windows o macOS chiedono una conferma, perché l'app non è ancora firmata: vedi Avvisi di sicurezza.
  4. Dalla home apri Web Thru Box e consenti l'accesso ai dispositivi MIDI.
Omnithru usa HTTPS perché browser e telefoni permettono MIDI e giroscopio solo su connessioni sicure. Il traffico resta nella tua rete.

Avvisi di sicurezza

Omnithru è fatto da uno sviluppatore indipendente: gli installer non sono ancora firmati con un certificato a pagamento, e il certificato HTTPS lo crea Omnithru stesso sul tuo computer. Per questo compare qualche avviso. Sono previsti, e la maggior parte li vedi una volta sola.

DoveCosa vedi e cosa fare
Windows, primo avvioWindows ha protetto il PC (SmartScreen): scegli Ulteriori informazioni → Esegui comunque.
Windows, reteL'installer lascia collegare telefoni e tablet solo sulle reti private. Se non si collegano, apri Impostazioni → Rete e Internet → la tua Wi-Fi (o l'hotspot del telefono) e scegli Rete privata.
macOS, primo avvioApple non può verificare "Omnithru": premi Fine, poi apri Impostazioni di Sistema → Privacy e sicurezza e scegli Apri comunque. Se macOS chiede se Omnithru può accettare connessioni in entrata, scegli Consenti.
Telefoni e tabletLa connessione non è privata (Chrome) o Questa connessione non è privata (Safari): scegli Avanzate → Procedi oppure Mostra dettagli → visita questo sito web. Una volta per dispositivo, e di nuovo se il computer si collega a una rete nuova.
Il computer stessoNessun avviso: lì Omnithru si apre su http://localhost:443, che i browser considerano sicuro.
L'avviso sui telefoni compare perché il certificato l'ha creato Omnithru per il tuo computer, non un'autorità pubblica. La connessione è comunque cifrata e resta nella tua rete. Il certificato non può essere usato per firmare nient'altro.

Spegnere Omnithru

Omnithru non ha finestre: gira in background. Per spegnerlo premi ⏻ nella home; il pulsante compare solo sul computer che esegue Omnithru. Se avvii Omnithru mentre è già acceso, si apre semplicemente la home.

Collegare i dispositivi

  1. Collega telefono o tablet alla stessa Wi-Fi del computer.
  2. Nella home di Omnithru sul computer premi il pulsante della sessione (di solito si chiama default): compaiono un QR code e il link, con l'indirizzo del computer nella rete.
  3. Inquadra il QR code con la fotocamera del telefono, oppure copia il link e aprilo nel browser.
  4. Accetta l'avviso del certificato, se compare, e scegli un controller dalla home.
  5. Nel receiver compare una riga per il nuovo controller: assegnagli una porta OUT.

Tutti i dispositivi entrati dal QR code fanno parte della stessa sessione: stesso receiver, stessi controller, stesso tema.

Puoi aprire più controller sullo stesso dispositivo, in schede diverse, e anche due controller dello stesso tipo: restano distinti.

Porte MIDI virtuali

Una porta MIDI virtuale è un "cavo" dentro il computer: ciò che un programma scrive sull'uscita di una porta, un altro programma lo legge dall'ingresso. Il receiver di Omnithru riceve i messaggi dei sender (Keyboard, XY Pad, GyroBall, Clip Launcher…) e li inoltra su queste porte; la DAW le legge come se fossero strumenti veri.

Tre regole valide su tutti i sistemi

  1. Crea e nomina le porte prima di aprire il receiver. Il browser legge l'elenco delle porte all'avvio. Alcuni sistemi non propagano subito le porte virtuali aggiunte o tolte, e su Mac il browser non aggiorna i nomi di una porta già vista finché non viene riavviato (vedi macOS). Se aggiungi una porta a sessione già aperta usa Rileva porte MIDI nel receiver: la pagina si ricarica e le tabelle dei sender si azzerano, quindi le porte vanno riassegnate.
  2. Una porta per ogni sender, con il nome del sender: Keyboard, XY Pad, GyroBall, Chord Wheel… Così nel receiver e nella DAW sai subito quale porta è quale.
  3. Due porte non devono mai farsi eco. Se receiver e DAW leggono e scrivono sulla stessa porta, i messaggi rimbalzano all'infinito. I cablaggi qui sotto servono proprio a evitarlo.

Sender che inviano soltanto

Keyboard, XY Pad, GyroBall, Chord Wheel e gli altri mandano note o controlli verso la DAW: basta un'uscita.

PorteReceiverDAW
loopMIDI o IAC
una porta, es. Keyboard		uscita del sender → Keyboardingresso MIDI di una traccia → Keyboard
Loopback di Windows MIDI Services
coppia A/B		uscita del sender → Aingresso MIDI di una traccia → B

Nei loopback di Windows le due metà sono incrociate: ciò che esce da A arriva su B (e viceversa), quindi la DAW ascolta l'altra metà rispetto al receiver.

Clip Launcher: andata e ritorno

Il Clip Launcher parla in due direzioni: invia i tocchi alla DAW e riceve da lei lo stato dei LED. Serve quindi un percorso di andata e uno di ritorno.

loopMIDI (Windows) e IAC Driver (Mac): due porte. Crea due porte, per esempio ClipA e ClipB, e collegale incrociate.

Se nel receiver inverti le porte, devi invertirle anche in Ableton. Il principio è: l'uscita di uno è l'ingresso dell'altro.

Loopback di Windows MIDI Services: una porta, due endpoint. Creando una porta, Windows genera da solo due endpoint, A e B, ciascuno con ingresso e uscita.

Si possono anche scambiare le lettere (B nel receiver, A in Ableton), purché non siano mai uguali. Con la stessa lettera da entrambe le parti i messaggi rimbalzano.

Se in Ableton non si accendono i LED, riconferma le porte del Clip Launcher nel receiver: all'invio Ableton rimanda lo stato di tutti i pad.

Windows

  • Windows 11 con Windows MIDI Services (incluso dalla 25H2): crea i loopback dalle impostazioni di Windows MIDI Services. Non serve altro.
  • Windows 10 e versioni di Windows 11 senza Windows MIDI Services: usa loopMIDI. Crea le porte con i nomi dei sender prima di aprire il browser.

macOS

Su Mac le porte virtuali si creano con l'IAC Driver, già incluso nel sistema.

  1. Apri Configurazione Audio MIDI e, dal menu Finestra, Mostra Studio MIDI.
  2. Fai doppio clic su Driver IAC e attiva Il dispositivo è in linea.
  3. Nella lista delle porte aggiungi i bus con + e dai a ciascuno il nome del sender.
  4. Apri il browser e poi il receiver.
Se cambi il nome di un bus o di una porta, Chrome non se ne accorge: né Rileva porte MIDI né un ricaricamento della pagina aggiornano il nome, perché il browser lo legge una sola volta e lo tiene finché resta aperto. Chiudi completamente il browser (Cmd+Q, non solo la finestra) e riaprilo. L'identificativo della porta non cambia, quindi route e assegnazioni restano valide. Lo stesso vale per gli altri browser basati su Chromium (Edge, Brave…).

Se qualcosa non funziona

SintomoCosa controllare
I messaggi rimbalzano o la DAW "impazzisce"Receiver e DAW usano la stessa porta o la stessa lettera: l'uscita di uno deve essere l'ingresso dell'altro.
Una porta appena creata non compareCreala prima di aprire il receiver, oppure premi Rileva porte MIDI.
Un nome non si aggiorna (Mac)Chiudi del tutto il browser con Cmd+Q e riaprilo.
I LED del Clip Launcher restano spentiRiconferma le porte del Clip Launcher nel receiver; controlla che in Ableton la superficie css_omnithru usi le porte giuste (incrociate o con l'altra lettera).
Il browser non vede nessuna portaUsa Chrome o un browser basato su Chromium e consenti l'accesso MIDI quando lo chiede.

Ableton Live e Clip Launcher

Il Clip Launcher parla con Ableton tramite il remote script css_omnithru.

  1. Scarica il remote script adatto alla tua versione di Live.
  2. Copia la cartella in MIDI Remote Scripts. Su Windows: C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts. Su macOS: clic destro su Ableton Live nella cartella Applicazioni → Mostra contenuto pacchetto → Contents/App-Resources/MIDI Remote Scripts.
  3. Riavvia Live e apri Impostazioni → Link, Tempo e MIDI.
  4. In una riga libera scegli Control Surface css_omnithru, Input Loopback B e Output Loopback B.
  5. Nel receiver assegna al Clip Launcher IN e OUT su Loopback A e conferma. I LED si accendono come il set.

Per gli altri controller in Ableton attiva Track e Remote sulla porta d'ingresso usata, poi assegna i parametri con il MIDI Map Mode (Ctrl+M o Cmd+M).

Schermo intero

Su tablet e telefono un controller rende di più senza le barre del browser.

DispositivoCome fare
Android e iPadPremi il pulsante dello schermo intero nella barra del controller. Cambiando pagina il browser esce dallo schermo intero: ripremilo.
iPhoneSafari e Chrome non permettono lo schermo intero alle pagine web: su iPhone usa i controller nel browser.
Aggiungere Omnithru alla schermata Home dell'iPhone darebbe lo schermo intero, ma funziona solo con un certificato che l'iPhone considera attendibile. Arriverà con MIDI SERVER; per ora l'app dalla schermata Home si apre ma non si collega.

Temi

Dalla home scegli tra sei temi: Scuro, Chiaro, Alto contrasto, Neon, Retro e Pastello. Il tema si applica a tutti i dispositivi collegati, così sul palco ogni schermo ha lo stesso aspetto.

Problemi comuni

Il telefono non si collega

Controlla che sia nella stessa Wi-Fi del computer e che l'indirizzo inizi con https://. Alcune reti per ospiti isolano i dispositivi tra loro: in quel caso usa la rete principale.

Su Windows la rete deve essere privata: l'hotspot del telefono spesso è impostato come pubblico. Vedi Avvisi di sicurezza. Su macOS, se il firewall chiede di Omnithru, scegli Consenti.

Il receiver non vede la mia porta MIDI

Crea la porta prima di aprire il receiver, oppure premi Rileva porte MIDI. Se la porta è virtuale, verifica che il programma che la crea sia aperto. Se su Mac hai cambiato il nome di una porta, chiudi completamente il browser (Cmd+Q). Il receiver funziona in Chrome e nei browser basati su Chromium (Edge, Brave…).

I messaggi rimbalzano o le note si ripetono

È quasi sempre il cablaggio: receiver e DAW sulla stessa porta del loopback. Con il loopback di Windows metti il receiver su A e la DAW su B; con loopMIDI o IAC l'uscita di una porta deve essere l'ingresso dell'altra (ClipA/ClipB), come nello schema.

I pad del Clip Launcher non si accendono

Controlla che in Ableton la control surface sia css_omnithru con le porte giuste secondo lo schema (loopback di Windows: Input e Output sulla porta B; loopMIDI o IAC: Input ClipB e Output ClipA), e che nel receiver il Clip Launcher abbia sia IN sia OUT. Conferma di nuovo le porte nel receiver: Ableton rimanda tutti i LED.

Il Clip Launcher risulta già attivo

Per ogni sessione può esserci un solo Clip Launcher, e un solo receiver. Chiudi la scheda dove è già aperto.

Su tablet, cambiando scheda il controller si scollega

Alcuni tablet Android sospendono le schede in background. Al ritorno il controller si ricollega e ritrova la sua porta da solo.

Per evitarlo: Impostazioni → Batteria → Limiti per l'uso in background, disattiva la sospensione delle app non usate e metti Chrome tra le app mai sospese.

GyroBall non si muove

Su iPhone e iPad tocca Consenti quando Safari chiede i sensori di movimento. Su Android controlla che la rotazione automatica non blocchi i sensori e che la pagina sia aperta in https://.

Una nota resta accesa

Omnithru spegne le note quando chiudi o nascondi un controller e quando stacchi una route. Se succede comunque, disattiva e riattiva la route o ricarica il controller.