Xenon

Domande frequenti

Le domande che mi arrivano più spesso, con le risposte. Se la tua non c'è, chiedi sul Discord.

Ultimo aggiornamento: 26 settembre 2026

Prima di installare

Serve un CORSAIR Xeneon Edge?

No. Xenon è nato attorno a quello schermo, ma l'Edge è uno degli schermi su cui gira, non il prodotto. Un monitor in più, un vecchio tablet appoggiato sulla scrivania, un touchscreen, una finestra sullo schermo principale o il telefono che hai in tasca funzionano allo stesso modo. Se non hai proprio uno schermo libero, usa il telefono: circa trenta secondi sulla tua Wi-Fi, e quello che ottieni è la dashboard vera, non un telecomando.

È davvero gratis?

Sì. Nessuna versione a pagamento, nessuna prova, nessun account, nessuna pubblicità, e nessuna funzione tenuta da parte per un piano che non esiste. La licenza è custom e non commerciale: libera per uso personale, e puoi leggere, eseguire e modificare il sorgente. Serve un permesso scritto per venderlo, includerlo in un prodotto commerciale, ridistribuirlo come lavoro tuo o usare il nome Xenon per altro.

Se vuoi dire grazie c'è il livello sostenitore: 5 per un mese, 25 per cinque mesi, 50 per un anno. Sblocca qualche tema e widget in più nel catalogo, un ruolo su Discord e il tuo nome su questo sito. L'app non tiene nulla da parte: è un grazie, non una licenza.

Su quali sistemi gira?

Windows 10 e 11 (64 bit), macOS 11 o successivo (un solo download universale per Apple Silicon e Intel) e Linux (64 bit).

macOS e Linux sono in beta. La dashboard, i widget, lo Store e le integrazioni sono identici su tutti e tre; quello che ancora cambia è lo strato che legge la macchina. La tabella delle piattaforme dice esattamente cosa funziona dove, funzione per funzione.

Serve un PC CORSAIR, o iCUE?

No. Xenon gira su qualsiasi PC e non richiede hardware o software CORSAIR. iCUE serve solo per due cose opzionali: tenere la dashboard dentro un widget iFrame di iCUE se la preferisci lì, e comandare i dispositivi RGB CORSAIR. Tutto il resto è indipendente.

Quando Windows lo chiama virus

In breve

Dalla versione 4.11.9 l'installer per Windows è firmato, quindi Windows mostra un editore verificato. Gli avvisi possono comunque comparire per un po', perché Microsoft concede la reputazione col tempo e Defender giudica anche quello che un programma fa. Da lì nascono fino a tre avvisi diversi, da tre sistemi diversi, e servono tre risposte diverse. Nessuno dei tre è il rilevamento di un vero malware, e non devi credermi sulla parola: ogni release pubblica gli hash che puoi verificare da solo.

Windows Defender ha segnalato Xenon, e ora è sparito

È un falso positivo, ed è la cosa singola per cui mi scrivono più spesso. Il nome del rilevamento di solito finisce con !cl, che vuol dire che il verdetto arriva dal modello di machine learning in cloud di Defender e non da una firma che corrisponde a malware noto. Per quel modello ogni release è un file nuovo, quindi il rilevamento può comparire e sparire da una versione all'altra.

Per recuperare l'installazione:

  1. Apri Sicurezza di Windows → Protezione da virus e minacce → Cronologia protezione, trova la voce Xenon e scegli Azioni → Ripristina.
  2. Aggiungi un'esclusione così non succede più: Gestisci impostazioni → Esclusioni → Aggiungi un'esclusione → Cartella, e aggiungi %LOCALAPPDATA%\Xenon.
Il browser non me lo fa scaricare, o dice che ha trovato un virus

Stessa causa, guardiano diverso: è il controllo di reputazione del browser, Google Safe Browsing su Chrome e SmartScreen su Edge. Apri l'elenco dei download con Ctrl+J e scegli Mantieni, o Mantieni comunque, sul file annullato. Se poi SmartScreen ti avvisa quando avvii il setup, clicca Ulteriori informazioni e poi Esegui comunque.

Come faccio a sapere che è sicuro, invece di fidarmi e basta?

Verificalo tu, e fallo davvero. Ogni release pubblica un file SHA256SUMS firmato con la chiave del progetto. In PowerShell:

Get-FileHash .\Xenon-Setup-x64.exe -Algorithm SHA256

Confronta il risultato con la riga Xenon-Setup-x64.exe dentro SHA256SUMS di quella release. Se corrispondono, il file che hai è byte per byte quello che GitHub Actions ha compilato dal sorgente pubblico a quel tag, e ogni riga di quel sorgente è leggibile su GitHub. Puoi anche caricarlo su VirusTotal: un paio di motori che segnalano mentre tutti gli altri risultano puliti è l'aspetto di un problema di reputazione, non quello di un malware.

Puoi anche controllare la firma: clic destro sul file, Proprietà, scheda Firme digitali, che riporta il nome dell'editore. Le release dalla 4.11.9 in poi sono firmate; quelle precedenti no, e per quelle il controllo è l'hash.

Salta un avviso solo per un file scaricato dalla pagina Releases ufficiale e di cui hai controllato l'hash. Convincere qualcuno a ignorare un avviso è esattamente quello che fa il malware vero, e l'hash è la cosa che distingue le due situazioni.

Xenon non parte proprio, e Defender non ha detto niente

Su Windows 11 di solito è Smart App Control, che è un sistema diverso dall'antivirus. Controlla in Sicurezza di Windows → Controllo app e browser → Smart App Control.

Blocca qualsiasi app di cui non si fida già, e lo decide prima ancora che l'antivirus venga interpellato. Quindi l'esclusione qui sopra non lo tocca, e non esiste un modo per permettere una singola app lasciandolo acceso. Si accende da solo soltanto durante un'installazione pulita di Windows 11, ed è per questo che compare su un PC rifatto da poco e mai su uno aggiornato. Restano due impostazioni: Valutazione, dove Windows osserva come usi il PC e decide da sé se tenerlo acceso, e Disattivato.

Leggi questo prima di cambiarlo: disattivare Smart App Control è una porta a senso unico. Windows non ti farà riaccenderlo senza reimpostare o reinstallare il PC. È una scelta di Microsoft e non è qualcosa che Xenon possa aggirare. Dalla versione 4.11.9 i file di Xenon sono firmati, e Microsoft dice che Smart App Control lascia girare un'app con una firma valida quando non ha un verdetto suo, quindi prova prima l'ultima release tenendolo acceso. Se blocca ancora Xenon e preferisci tenerlo acceso, la risposta onesta è che su quella macchina Xenon non può girare.

Xenon si chiude da solo mentre lo sto usando

Apri il menu nella tray e scegli Open crash log. Xenon scrive una riga ogni volta che parte e una ogni volta che si ferma, e sono quelle righe a distinguere le due cause possibili.

L'ultima riga è un PANIC. L'app si è interrotta da sola, e la riga dice in quale thread e su quale riga esatta del sorgente. Incollala sul Discord o in una segnalazione: con quella riga di solito si risolve in fretta.

L'ultima riga è launched e dopo non c'è niente. Allora non è stata l'app a decidere di fermarsi: qualcosa dall'esterno ha chiuso il processo, e su Windows quasi sempre è l'antivirus che mette in quarantena xenon-native.exe mentre è in esecuzione. Guarda in Sicurezza di Windows → Protezione da virus e minacce → Cronologia protezione se c'è una voce con l'ora esatta in cui la finestra è sparita, ripristinala, e aggiungi un'esclusione cartella sia per %LOCALAPPDATA%\Xenon sia per %LOCALAPPDATA%\Programs\Xenon: Xenon vive in tutte e due, ed escludere solo la prima lascia scoperta proprio la metà che resta accesa tutto il giorno.

Xenon è firmato?

Sì, su Windows dalla versione 4.11.9 (20 settembre 2026). L'installer, l'app al suo interno e l'helper hanno una firma Authenticode, quindi Windows mostra un editore verificato invece di Editore sconosciuto.

Una firma dimostra chi ha pubblicato un file e che nessuno lo ha modificato da allora. Non porta reputazione dal primo giorno: SmartScreen la concede col tempo, man mano che le persone scaricano il file, e Defender giudica anche quello che un programma fa. Quindi un avviso può ancora comparire per un po', e una cosa aiuta più di ogni altra. Se Defender segnala il tuo download, segnalalo come falso positivo su microsoft.com/wdsi/filesubmission, scegliendo Home customer e poi Incorrectly detected as malware. Ci vogliono due minuti, le segnalazioni degli utenti reali contano, e di solito il rilevamento viene tolto per tutti nel giro di pochi giorni.

Su macOS la build è in beta e non è notarizzata, che è un passaggio separato di Apple; la domanda su macOS qui sotto spiega il primo avvio.

macOS e Linux

macOS dice che Xenon non può essere aperto perché Apple non può verificarlo

Per ora è previsto: l'app non è notarizzata, e per farlo serve un abbonamento Apple Developer a pagamento che il progetto non ha.

Su macOS 15 e successivi apri Impostazioni di Sistema → Privacy e sicurezza, scorri fino in fondo e premi Apri comunque accanto a Xenon. Apple ha tolto la vecchia scorciatoia col tasto destro. Su macOS da 11 a 14, tasto destro sull'app, Apri, e poi ancora Apri. In entrambi i casi è una volta per versione.

Su macOS il widget Disco mostra il Cestino a 0 B

Il Cestino e gran parte di ~/Library/Caches stanno dietro Accesso completo al disco, un permesso che macOS concede per singola app. Senza, quelle cartelle sembrano vuote invece che negate, quindi nessuno segnala un errore e la mappa del disco conta meno di quello che c'è.

Apri Impostazioni di Sistema → Privacy e sicurezza → Accesso completo al disco, premi +, scegli Xenon in Applicazioni, assicurati che l'interruttore sia attivo, poi chiudi Xenon e riaprilo.

Fino alla 4.11.3 andava rifatto dopo ogni aggiornamento, adesso non più. macOS lega il permesso alla firma del codice, e Xenon aveva una firma ad-hoc: a ogni release sembrava un'app diversa e il permesso smetteva di valere in silenzio. Ora Xenon ha un certificato proprio, che resta lo stesso a ogni release, quindi il permesso sopravvive agli aggiornamenti. L'aggiornamento alla 4.11.3 lo azzera un'ultima volta, perché è la release in cui cambia l'identità. Se è in elenco ma chiaramente non funziona, togli Xenon con − e riaggiungila. Ora Xenon se ne accorge da sola e te lo dice sulla dashboard.

Cosa devo installare su macOS?

Node.js è l'unico requisito, e Xenon te lo dice se manca: brew install node. Il resto è opzionale e ognuno accende una cosa sola:

  • vladkens/tap/macmon per temperature e carico GPU
  • switchaudio-osx per cambiare il dispositivo di uscita
  • ffmpeg per l'input vocale e le risposte parlate

Xenon ti dice quali mancano invece di fallire più avanti.

Come lo installo su Linux?

Scarica l'AppImage (rendila eseguibile e avviala) oppure il .deb. Al primo avvio ti propone di installare la dashboard in una finestra di terminale che puoi leggere e fermare, verificando il download con la chiave del progetto prima di estrarre qualsiasi cosa.

Il pacchetto di proposito non lo fa al posto tuo: tutto quello che l'installazione crea appartiene a un solo account utente, e un pacchetto si installa come root per l'intera macchina. Se preferisci saltare l'app, scarica lo zip dei sorgenti dalle Releases ed esegui ./INSTALL.sh.

Servono nodejs npm unzip. Opzionali, uno per funzione: wireplumber (volume, microfono, mixer per app), wmctrl e x11-utils (il cambio applicazioni), playerctl (now playing istantaneo), ffmpeg (voce). Esegui npm run doctor e ti dice cosa manca e cosa accenderebbe.

Cosa vuol dire beta, in concreto, su macOS e Linux?

La dashboard è lo stesso prodotto: stessi widget, stesso Store, stessi temi, stesse integrazioni, stesso accesso dal telefono. Quello che cambia è lo strato che legge la macchina, quindi alcuni sensori e alcune azioni di sistema non ci sono ancora o funzionano in modo diverso.

Niente finge di funzionare, ed è la parte che conta. Un riquadro senza una fonte dati sulla tua piattaforma lo dice in una riga invece di caricare all'infinito, e un tasto del Deck che la piattaforma non può eseguire viene nascosto invece che offerto e poi fallito.

Installare, avviare, aggiornare

Cosa fa davvero l'installer?

Su Windows installa l'app, installa il motore della dashboard sotto %LOCALAPPDATA%\Xenon, installa Node.js se non ce l'hai già, e registra un'attività perché la dashboard parta quando accedi. Scarica anche i pezzi opzionali: FFmpeg, LibreHardwareMonitor e PawnIO per le temperature, PresentMon per gli FPS reali in gioco.

Niente gira di nascosto. Il setup installa solo l'app e la apre; la metà dashboard te la propone l'app dopo, e gira in una finestra di console che puoi guardare e interrompere. Una versione precedente lo faceva in silenzio in background, ed è esattamente la forma che fa mettere in quarantena un installer non firmato, quindi è stata rimossa.

Parte da solo con il PC, e posso evitarlo?

Sì, parte quando accedi, così la dashboard è già viva quando ti siedi. Gira dentro la tua sessione e non come servizio di sistema, ed è voluto: fuori dalla tua sessione non esistono l'elenco dei dispositivi audio, l'elenco delle finestre, il microfono né un modo per aprire un'app, quindi metà delle funzioni smetterebbe di funzionare in silenzio.

Per rimuovere Xenon esegui UNINSTALL.bat su Windows, UNINSTALL.command su macOS o ./UNINSTALL.sh su Linux.

Come si aggiorna?

Xenon si aggiorna da solo. Quando esce una release la dashboard mostra un avviso; un tocco la scarica, ne verifica la firma prima di estrarre qualsiasi cosa, installa il motore e poi l'app, e rimette automaticamente la versione precedente se qualcosa va storto. Impostazioni, layout e note restano sempre al loro posto, e i file rimasti da versioni vecchie vengono ripuliti.

Come lo disinstallo?

Esegui UNINSTALL.bat su Windows, UNINSTALL.command su macOS o ./UNINSTALL.sh su Linux. Tutti e tre chiedono conferma una volta, poi rimuovono Xenon del tutto: l'app, l'avvio automatico, il server locale, i tuoi dati e la cartella di installazione. Aggiungi --keep-data (-KeepData su Windows) per conservare impostazioni, layout e note. Cancellare la cartella dei dati rimuove tutto quello che Xenon ha salvato, incluso l'id casuale che serve a far contare una volta sola una valutazione nello Store.

Perché chiede i permessi di amministratore?

Una volta sola, durante l'installazione, e per due cose: preparare la lettura delle temperature di CPU e dischi (LibreHardwareMonitor e PawnIO, che richiedono un componente a livello di driver) e registrare l'avvio automatico. Se lo rifiuti tutto il resto funziona lo stesso, semplicemente non avrai le temperature. Dopo, Xenon non gira con privilegi elevati.

Dice che la porta 3030 è già in uso

Quasi sempre è un'altra copia della dashboard già in esecuzione, che poi è quello che vuoi: apri http://127.0.0.1:3030/ ed è lì. Se invece quella porta è occupata da altro sul tuo PC, cambiala in server/server.js.

Usare Xenon

Posso davvero usare il telefono come schermo?

Sì, ed è la tua dashboard, non un telecomando: stesso layout, stessi widget, stesso tema, e i tasti del Deck girano davvero sul PC. Nessun account, nessun cloud, niente da installare, e sulla tua Wi-Fi niente esce dalla rete di casa. Ci vogliono circa trenta secondi. La guida per il telefono copre entrambe le strade, a casa e da fuori.

Devo per forza usare l'app?

No. L'app è una finestra attorno alla dashboard, e la dashboard è una pagina web locale: apri http://127.0.0.1:3030/ in qualsiasi browser, su qualsiasi monitor. L'app conviene su un touchscreen perché aggiunge il tocco sicuro in gioco e l'icona nella tray. Dentro iCUE funziona anche un widget iFrame puntato allo stesso indirizzo.

Per farlo, aggiungi in iCUE un widget Pagina web (HTML) e incollaci dentro questo: <iframe src='http://127.0.0.1:3030/' width='100%' height='100%' frameborder='0'></iframe>

Serve una chiave API per l'AI?

Solo se vuoi un provider cloud, e una chiave Gemini si crea gratis. Tutto il resto di Xenon funziona senza.

C'è anche l'opzione completamente locale: Ollama per la chat e Whisper per il parlato, installati su richiesta dalle Impostazioni, con niente che esce dal tuo PC. Se scegli un provider cloud, i tuoi prompt vanno a quel provider secondo le sue condizioni, e Xenon non manda mai niente a un modello che non hai scelto.

Non vedo la temperatura della CPU

Riesegui l'installer e accetta la richiesta di amministratore, così può installare LibreHardwareMonitor e PawnIO e registrare l'attività di avvio con privilegi. Alcuni portatili e alcune schede non espongono proprio nessun sensore, e in quel caso il riquadro lo dice invece di mostrare un numero inventato.

Posso creare widget e temi miei?

Sì, e per la maggior parte non serve scrivere codice. Temi, layout, scene ambient e profili Deck si costruiscono dentro l'app e si condividono come un codice che chiunque può importare. I widget sono piccoli pacchetti HTML, CSS e JavaScript che girano in una sandbox, con un ponte documentato per sensori e azioni.

La guida per creator è il punto di partenza, e il catalogo è quello che gli altri hanno già fatto.

Controlla l'illuminazione RGB?

Sì: i dispositivi CORSAIR tramite iCUE, più WLED, OpenRGB, Philips Hue e Nanoleaf direttamente in rete. Può reagire alle temperature o a quello che sta suonando, oppure restare su un colore scelto da te. È opzionale e resta spento finché non lo configuri.

Privacy e fiducia

Xenon manda i miei dati da qualche parte?

Impostazioni, note, attività, eventi, deck, frasi cercate e indice dei file restano sul tuo PC. Non c'è nessun SDK di analytics, nessun crash reporter e nessun tracciamento del comportamento dentro l'app.

Non è nemmeno completamente offline, e dire il contrario sarebbe la versione disonesta: controlla gli aggiornamenti, e contatta un servizio per il meteo o un'API musicale quando accendi quelle funzioni. La pagina privacy elenca ogni chiamata che l'app può fare, cosa la scatena e cosa manda esattamente, senza omettere niente.

Serve un account?

No. Non esiste un account Xenon, non c'è un login, e non c'è nessun mio server in mezzo tra te e la tua dashboard. Le integrazioni che configuri tu, tipo Spotify o Twitch, usano le loro credenziali e restano ferme finché non le imposti.

Licenza, costi e aiuto

Posso usarlo al lavoro, o dentro un mio prodotto?

L'uso personale è libero, anche sul PC su cui ti capita di lavorare. Venderlo, includerlo in un prodotto commerciale, ridistribuirlo come lavoro tuo o usare il nome Xenon per altro richiede prima un permesso scritto.

Se hai un caso in mente, chiedi: scrivimi o parlane sul Discord. La risposta spesso è sì, con delle condizioni.

Dove chiedo aiuto?

Il Discord è la via più veloce, ed è dove la maggior parte dei problemi viene davvero diagnosticata. Per qualcosa di riproducibile, una issue su GitHub con il tuo sistema, cosa hai fatto e cosa è successo è la cosa più utile che puoi mandare. Li legge la stessa singola persona.

Come posso sostenere il progetto?

Un caffè, se ti va. Chi sostiene il progetto riceve un ruolo sul Discord e un posto nella Hall of Supporters.

Un anno di supporto aggiunge una cosa in più: ti costruisco un tema. Mandami una palette, una foto, un gioco, qualsiasi cosa tu voglia che la tua dashboard ricordi, e la trasformo in un tema Xenon pubblicato col tuo nome sopra. Una richiesta al mese a testa. C'è una coda e la smaltisco in ordine, quindi non ti prometto una data: ti prometto che il tuo arriva e che dopo la prima versione hai un giro di modifiche. Un tema vuol dire colori, sfondo, accenti, font e disposizione di widget che esistono già. Widget nuovi e funzioni nuove sono un'altra cosa e non c'entrano.

Le richieste si fanno nel canale #theme-requests sul Discord: apri un thread, scrivi cosa vuoi e mettici dentro la palette o la foto. Il thread è il tuo posto in coda, e ti rispondo lì.

Le cose gratuite aiutano allo stesso modo: una stella su GitHub, una segnalazione di bug con dettagli veri, un widget o un tema condivisi nel catalogo, oppure dire a qualcuno che ha uno schermo libero che questa cosa esiste.

Ancora bloccato?

Chiedi sul Discord. Le domande che tornano spesso finiscono su questa pagina, quindi farne una serve davvero.