# Funzioni

Cosa fa bitwerk oggi e cosa ne ricavi. Hai domande su una funzione per il tuo locale o il tuo studio? [Parla con noi](https://bitwerk.systems/it/contact/).

## Riproduzione

### Bit-perfect fino al DAC

bitwerk non elabora mai i tuoi file lungo il percorso. Il server consegna il file originale byte per byte, il player lo decodifica e passa i campioni direttamente al DAC, senza mixer di sistema e senza ricampionamento nascosto. Il DAC viene impostato sulla frequenza propria di ogni brano, e solo quando la frequenza cambia, così un album a 96 kHz suona dall’inizio alla fine senza clic.

Ogni stanza mostra se suona bit-perfect: accanto a **«96 kHz / 24 bit»** c’è l’indicatore verde **«Bit-Perfect»**, oppure l’indicatore ambra **«DSP»** appena qualcosa viene calcolato.

### Quando l’indicatore dice DSP

Tocca l’indicatore ambra: elenca ogni motivo, cosa fa il player e come evitarlo. DSP non è un difetto: ogni passaggio gira a 64 bit con dither e dal punto di vista sonoro non è critico. Significa solo che i campioni al DAC non sono più quelli del file.

| Motivo                          | Cosa succede                                                                                   | Per restare bit-perfect                                                                       |
| ------------------------------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Volume sotto il 100 %           | Il player abbassa il livello in digitale.                                                      | Lascia il volume al 100 % e abbassa sull’amplificatore, oppure usa il volume del DAC (sotto). |
| Muto                            | Il player silenzia il segnale.                                                                 | Riattiva l’audio.                                                                             |
| ReplayGain                      | Il player livella la sonorità tra i brani.                                                     | Imposta ReplayGain su «Off» nelle impostazioni del player.                                    |
| Ricampionamento da 192 a 96 kHz | Il profilo del DAC non ha la frequenza del file, quindi il player la converte.                 | Aggiungi la frequenza a quelle supportate dal player, se il DAC la gestisce.                  |
| Profondità da 32 a 24 bit       | Il file è più largo della profondità massima del DAC.                                          | Alza la profondità massima, se il DAC accetta parole più larghe.                              |
| Float a 24 bit                  | I file in virgola mobile vengono sempre convertiti.                                            | Suona una versione a interi (per esempio FLAC a 24 bit).                                      |
| DSD in PCM                      | L’uscita DSD è «None».                                                                         | Imposta l’uscita DSD su «DoP» o «Native DSD», se il DAC lo supporta.                          |
| Sorgente con perdita            | Il file stesso è con perdita (MP3, AAC, Spotify).                                              | Suona una versione lossless.                                                                  |
| Uscita indiretta                | Il player non scrive direttamente sul DAC.                                                     | Scegli il DAC stesso come uscita del player.                                                  |
| Mono, L−R, Dim, Trim            | Il [monitor controller](https://bitwerk.systems/it/software/monitoring/) modifica il segnale.  | Spegni la funzione.                                                                           |
| A/B loudness match              | Il confronto A/B livella i due lati.                                                           | Termina il confronto quando hai finito.                                                       |
| Room sync                       | La stanza segue il leader del suo gruppo ripetendo o scartando ogni tanto un singolo campione. | Fai guidare il gruppo a questa stanza, oppure suonala da sola.                                |
| PEQ                             | La correzione acustica filtra il segnale.                                                      | Disattiva il profilo in *Settings › Studio*.                                                  |

### Formati

| Sorgente                   | Supporto                                                               |
| -------------------------- | ---------------------------------------------------------------------- |
| FLAC, ALAC, WAV, AIFF      | fino a 384 kHz, 16/24/32 bit, incluso il float a 32 bit                |
| DSD (DSF)                  | da DSD64 a DSD512: nativo, come DoP (DSD over PCM) o convertito in PCM |
| MP3, AAC, Ogg Vorbis, Opus | sì, gapless                                                            |
| Immagini cue               | un album in un unico file con un cue sheet appare come brani singoli   |

Se un DAC non può suonare una frequenza, il player la converte con alta qualità e lo dice con onestà: «DSP». Per il DSD senza un DAC compatibile con il DSD c’è una conversione in PCM.

### Gapless

Gli album dal vivo e i mix da DJ scorrono da un brano all’altro senza pause: il player prepara in tempo il brano successivo e fa continuare la musica.

### Volume e ReplayGain

- **Volume** per stanza: digitale (64 bit con dither), nel controllo del volume del DAC (resta bit-perfect), oppure fisso per un’uscita line verso un preamplificatore.
- **Il volume del DAC:** molti DAC hanno un controllo del volume nel loro chip. Con la modalità volume «DAC hardware mixer» il player invia i campioni senza modificarli e il DAC regola il livello. Molti DAC lo offrono.
- **ReplayGain 2.0** per player: off, brano o album. Se mancano i tag, il server misura da sé la sonorità (EBU R128). La protezione dal clipping impedisce il sovraccarico.

## Libreria

- **Cartella di caricamento:** copia i file sulla rete, caricali nel browser, oppure collega un disco USB. Il server aspetta che una copia sia finita, legge i tag e mette ogni file in Artista / Album.
- **Librerie grandi:** la libreria diventa navigabile per prima, e l’analisi della sonorità segue in background. I dischi USB e gli archivi vengono indicizzati sul posto e non vengono mai scritti.
- **Copertine:** immagini incorporate o il file di copertina nella cartella dell’album, e copertine online se lo permetti.
- **Ricerca:** veloce, tollerante agli errori di battitura e insensibile agli accenti: «pnik floyd» trova Pink Floyd, «bjork» trova Björk. Anche con 100.000 brani una ricerca richiede decine di millisecondi. Filtri per hi-res, formato e anni.
- **Album e artisti:** una griglia di tutti gli album con copertina, anno e la qualità migliore di ogni album, ordinata per artista, album o aggiunti di recente. Un clic suona l’album o lo mette in coda.
- **Playlist e preferiti:** crea playlist, ordinale con il trascinamento, segna i preferiti con il cuore.
- **Controllo della qualità:** la scansione segnala file con perdita, bitrate bassi, falso hi-res e clipping.
- **I cue sheet** vengono divisi in brani con precisione al campione; il file resta invariato.

## Multiroom

Ogni stanza ha una propria coda con **il brano corrente**, **Up next** e **History**. Tutto sopravvive a un riavvio, e ogni modifica compare subito su tutti i dispositivi: la web UI su un telefono, il display touch nella stanza, lo Stream Deck sulla scrivania. Up next si può riordinare, e una coda si può salvare come playlist.

### Stanze sincrone

Raggruppa le stanze e suonano la stessa musica nello stesso momento. Play, pausa, salto, ricerca, shuffle, ripetizione e coda agiscono sull’intero gruppo; volume, monitor controller e correzione acustica restano per stanza.

- **In sincrono con una precisione di una frazione di millisecondo:** tutti i player di un gruppo condividono un unico clock e partono insieme; poi ogni stanza segue la prima stanza del gruppo, il leader, così restano insieme anche i clock dei DAC che si allontanano tra loro.
- **Onesto sul bit-perfect:** il leader resta bit-perfect. Le altre stanze seguono il suo clock ripetendo o scartando ogni tanto un singolo campione, e il loro indicatore lo dice («Room sync»).
- **Ritardo di stanza:** diffusori attivi con un DSP, o un ascoltatore lontano dai diffusori, sentono il suono più tardi. Inserisci quel ritardo per la stanza, e suona tanto prima.
- I cambi di brano gapless restano gapless in ogni stanza.

### Crossfade

Per un negozio, un bar o un evento, dove una pausa tra due brani suona come un guasto, una stanza può sfumare ogni brano nel successivo, fino a 12 secondi. È spento per impostazione predefinita. I brani consecutivi di uno stesso album restano gapless, quindi un album dal vivo o una sinfonia non vengono mai sfumati. Mentre due brani si sovrappongono, l’indicatore dice «Crossfade». In un gruppo di stanze ogni stanza sfuma insieme alle altre.

### Sleep timer

Una stanza può fermarsi da sola: dopo un certo numero di minuti, alla fine del brano corrente o alla fine della coda. Il timer a minuti sfuma negli ultimi secondi e rimette il volume per la volta successiva.

## Display touch

Un player con touchscreen esegue l’interfaccia nativa di bitwerk: copertina grande, titolo, artista, indicatore del formato, Bit-Perfect o DSP con il percorso del segnale dietro di esso, avanzamento, volume e Up next; Queue, Albums, Radio e Search con un ripiego su Spotify; testi sincronizzati a schermo intero con «About this song»; il collegamento delle stanze dal display; e una vista da lontano con copertina e titolo grandi. Si avvia da solo quando il player parte.

**Schermo e alimentazione:** sospensione dello schermo, riattivazione alla riproduzione e luminosità si impostano sul display o nella web UI. Riavvio, reboot e spegnimento funzionano da entrambi, con un breve conto alla rovescia che puoi annullare, e lo spegnimento termina su «Safe to unplug». Il display mostra la sua rete e il suo segnale, avverte quando l’alimentatore è troppo debole e accende una cornice con *Identify*, così sai qual è quale player.

**Solo display:** in un bar, un negozio o una sala d’attesa, un amministratore può impostare un display perché mostri solo ciò che suona. Ignora ogni tocco, e nessuno può cambiare la musica da lì.

**Richieste di brani:** un amministratore imposta una stanza su «request»: gli ospiti entrati con un account ascoltatore chiedono un brano (con una breve nota), e un amministratore o il display touch della stanza lo accetta in Up next o lo rifiuta. Ogni ospite ha un limite di richieste aperte, e quelle senza risposta scadono.

## In studio

Per chiunque lavori con monitor da studio o mixi:

| Funzione                                                                  | Scopo                                                                                                                      |
| ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **[Monitor controller](https://bitwerk.systems/it/software/monitoring/)** | Controllo mono, solo laterale (L−R), Dim, loudness, crossfeed per cuffie e trim di uscita                                  |
| **[Confronto A/B](https://bitwerk.systems/it/software/ab-comparison/)**   | Il tuo mix contro un riferimento, commutato nella stessa posizione, con allineamento automatico della sonorità             |
| **Correzione acustica (PEQ)**                                             | Importa un export di filtri da REW o Equalizer APO; il player filtra a 64 bit                                              |
| **Stream Deck e OSC**                                                     | Tasti e fader per play/pausa, volume, mono, Dim, A/B …                                                                     |
| **Trigger**                                                               | Webhook firmati e MQTT su play, pausa, stop e cambio brano, per esempio per una luce di registrazione o per Home Assistant |

## Sicurezza

- **Login** per la web UI, con passkey su HTTPS, e **token API** per script e Stream Deck.
- **Link di streaming firmati:** gli ospiti sul Wi-Fi non possono né controllare il sistema né prendere la musica.
- **Account:** oltre agli amministratori, un account **Listener** suona musica in qualsiasi stanza ma non cambia nessuna impostazione, per gli ospiti o un tablet condiviso.

## Spotify

Collega un account Spotify per avviare Spotify in una stanza dalla web UI, con ricerca, playlist e album salvati. Un player può anche comparire come dispositivo Spotify Connect per l’ascolto privato: attivalo per stanza e dagli un nome in *Settings › Players*, senza riavvio. Spotify è con perdita, quindi il suo indicatore non dice mai «Bit-Perfect».

## Testi IA su canzoni e artisti

Spento finché un amministratore non attiva l’IA e sceglie un provider: Google Gemini, Claude, OpenAI, un altro servizio compatibile con la tua chiave, oppure un modello locale. «Ask AI» in *About this song* e nella pagina dell’artista scrive allora un breve testo a partire da fonti che bitwerk ha già (Wikipedia, MusicBrainz e i collegamenti della canzone). Il testo è indicato come IA, cita le sue fonti e nomina il modello. Nessun audio e nulla di Spotify va a un modello, e bitwerk non genera mai musica, voci o immagini ([IA e artisti](https://bitwerk.systems/it/introduction/ai-and-artists/)).

## Radio internet

La scheda **Radio** suona la radio internet in qualsiasi stanza. Radio è un plugin: un amministratore lo attiva in Settings › Plugins, e un sistema che non ne ha bisogno non mostra nessuna Radio.

- **Selezioni lossless:** un elenco curato di stazioni che trasmettono in FLAC, da 16/44,1 fino a 24/192.
- **Cerca** nella directory della community radio-browser.info per nome, genere e paese, se vuoi solo lossless.
- **Preferiti e URL di stream tuoi,** salvati sul server e disponibili come preset sullo Stream Deck.
- **Indicatore onesto:** «FLAC 24/96» può arrivare al DAC bit-perfect; MP3 e AAC non ottengono mai «Bit-Perfect».
- **Robusto:** se uno stream cade, il player si riconnette o passa allo stream di riserva della stazione.

Suonare la radio in bar, negozi o eventi di solito richiede una licenza di esecuzione (per esempio GEMA/GVL in Germania, PPL PRS nel Regno Unito). Un amministratore può tenere il numero di licenza e la sua data di scadenza nelle impostazioni del server. Non è una consulenza legale.

## Termini

**Bit-perfect** : I campioni arrivano al DAC esattamente come sono nel file: nessun ricampionamento, nessun volume digitale, nessun dither. Appena qualcosa deve calcolare, l’interfaccia mostra «DSP» invece di «Bit-Perfect».

**DoP (DSD over PCM)** : Impacchetta i dati DSD in frame PCM con dei marcatori, così il DSD può viaggiare su interfacce che conoscono solo il PCM. Il DAC riconosce i marcatori e suona il DSD.

**ReplayGain / EBU R128** : Allineamento della sonorità tra brani o album. Il server misura la sonorità secondo EBU R128 o legge i tag esistenti; se l’allineamento viene applicato si decide per ogni player.

**Jitter buffer** : Un buffer nel player (2 secondi per impostazione predefinita) che assorbe le oscillazioni della rete, così il DAC riceve un flusso regolare.

**Abbinamento** : Ogni player ha una propria chiave che lo identifica presso il server. Sulla tua rete un nuovo player la riceve da solo; con *Extended security* lo abbina un clic o un codice monouso dalla web UI.

Source: https://bitwerk.systems/it/software/
