Il developer MichelSama ha dato vita ad uno strumento chiamato Plume USB, un’applicazione homebrew che permette di utilizzare una Nintendo Switch come una tastiera USB per automatizzare l’inserimento di testo su un dispositivo compatibile, compresa Nintendo Switch 2.

L’idea è semplice ma ingegnosa: sfruttare la prima Switch per inviare automaticamente sequenze di testo e comandi, riducendo i passaggi manuali che altrimenti richiederebbero l’utilizzo di un computer.

Con la versione 0.1.7, il progetto introduce anche una funzione pensata per migliorare la precisione della digitazione, soprattutto quando si lavora con editor che modificano automaticamente la formattazione del testo.

Come funziona Plume USB

L’applicazione viene eseguita sulla Nintendo Switch originale tramite hbmenu e Atmosphère. Una volta collegata a un dispositivo compatibile attraverso un cavo USB dati, la console viene riconosciuta come una normale tastiera USB HID e può inviare automaticamente il contenuto di un file di testo.

Per utilizzarla, basta preparare un file sulla scheda SD della Switch 1, avviare Plume USB e collegare la console al dispositivo di destinazione. Dopo aver aperto un campo di testo compatibile, è possibile selezionare il file e avviarne la digitazione automatica.

Questa soluzione può tornare utile durante alcune procedure legate all’homebrew della Nintendo Switch 2, nelle quali è necessario inserire sequenze di testo o comandi.

È importante precisare, però, che Plume USB non esegue direttamente un exploit e non modifica autonomamente la console: il suo compito è automatizzare l’inserimento del testo richiesto.

La caratteristica principale dell’aggiornamento per la versione 0.1.7 è la compensazione automatica dell’indentazione, una funzione che risolve un problema comune quando si inserisce codice all’interno di editor con formattazione automatica.

Alcuni programmi, infatti, aggiungono automaticamente spazi o tabulazioni all’inizio di una nuova riga dopo la pressione del tasto Invio. Quando si trasferisce un testo già formattato, questo comportamento può alterare l’indentazione originale e compromettere la corretta disposizione delle righe.

Plume USB tiene conto degli spazi iniziali e delle tabulazioni, comprese le combinazioni tra i due, compensando l’indentazione aggiunta dall’editor di destinazione.

La funzione è disattivata per impostazione predefinita e può essere attivata premendo il tasto nell’anteprima del testo. La scelta viene conservata anche per gli utilizzi successivi.

Lo sviluppatore ha inoltre ampliato i test di regressione per verificare il comportamento dell’applicazione con righe vuote, variazioni dell’indentazione, formattazioni miste e caratteri di controllo non validi.

I test comprendono anche il limite massimo di 256 KiB previsto per i file di testo e il comportamento con entrambi i layout di tastiera supportati.

Le altre funzionalità

Plume USB supporta file di testo UTF-8, con o senza BOM, fino a 256 KiB e permette di visualizzarne un’anteprima prima dell’invio.

Sono disponibili controlli per regolare la velocità di digitazione e i tempi del tasto Invio, una gestione manuale del Blocco Maiuscole e una funzione di diagnostica della connessione USB.

È possibile anche interrompere l’invio tramite il tasto . Queste opzioni consentono di adattare il comportamento dell’applicazione alle caratteristiche dell’editor utilizzato, soprattutto quando la ricezione dei caratteri o dei ritorni a capo non avviene correttamente con le impostazioni predefinite.

Per quanto riguarda la disposizione dei tasti, sono supportati i layout QWERTY statunitense e AZERTY francese. È importante scegliere quello corrispondente alla tastiera riconosciuta dal dispositivo collegato, per evitare che alcuni caratteri vengano inseriti in modo errato.

Installazione e primo test

1. Estrarre l’archivio nella directory principale della scheda SD della Switch 1. Per aggiornare un’installazione esistente, è sufficiente sostituire questo file: sdmc:/switch/plume-usb/plume-usb.nro
2. Avviare Plume USB da hbmenu con Atmosphère. È consigliata la modalità Application, tenendo premuto mentre si avvia un gioco.
3. Collegare la porta USB-C della Switch 1 a un host USB. Per un test con Switch 2, utilizzando un cavo dati da USB-A a USB-C dalla dock della console di destinazione alla Switch 1. I collegamenti USB-C diretti dipendono dalla negoziazione dei ruoli.
4. Aprire sulla console di destinazione un campo di testo che accetti una tastiera USB.
5. Impostare il layout AZERTY FR o QWERTY US nell’applicazione, in modo che corrisponda a quello della tastiera sulla console di destinazione.
6. Attendere il messaggio USB keyboard connected, selezionare Send Hello e premere nell’anteprima. L’invio inizierà dopo tre secondi. Non viene aggiunto alcun tasto Invio.
7. Controllare il testo sulla console di destinazione. Premere per attivare o disattivare il Blocco Maiuscole, se necessario. Premere per aprire la diagnostica USB.

Lo stato di connessione richiede la configurazione USB e il completamento dello scambio dei descrittori HID. La corretta trasmissione dei rapporti USB non dimostra che il campo di testo di destinazione abbia accettato i caratteri.

Le versioni precedenti sono state utilizzate per digitare su Switch 2; sono stati segnalati ritorni a capo mancanti con ritardi di 0, 2 e 10 ms.

La build corretta utilizzata per la versione 0.1.7 ha ricevuto riscontri positivi dai test sulle console. La compatibilità con altri editor e la velocità massima affidabile dipendono comunque dal dispositivo di destinazione.

File di testo e ritardi

Selezionare qualsiasi file .txt presente sulla scheda SD. La cartella texts inclusa nel pacchetto contiene alcuni esempi. I file vengono letti senza modifiche.

• UTF-8, con o senza BOM; dimensione massima di 256 KiB.
• L’intero file viene controllato prima dell’invio. Un UTF-8 non valido o un carattere non supportato interrompe la preparazione e ne segnala la posizione. Nessun carattere viene sostituito silenziosamente.
• Il layout statunitense supporta i caratteri ASCII stampabili, le interruzioni di riga e le tabulazioni.
• Il layout francese supporta anche é è ç à ù â ê î ô û ä ë ï ö ü € £ ° µ. Gli accenti composti richiedono che il dispositivo di destinazione gestisca i tasti morti. Emoji, virgolette tipografiche, œ, lettere accentate maiuscole e accenti Unicode scomposti non sono supportati.
• CRLF, CR e LF generano ciascuno una pressione del tasto Invio. Le tabulazioni generano il tasto Tab. L’applicazione non aggiunge un Invio finale; se il file termina con un’interruzione di riga, questa viene inviata.
• L’anteprima mostra le prime righe e fino a 1.023 byte. L’invio utilizza l’intero file.
• alterna i ritardi dei caratteri tra 80, 40, 10, 2, 0 e 160 ms. Il ritardo si applica separatamente alla pressione e al rilascio del tasto. Il tasto Invio utilizza la temporizzazione separata descritta sopra, a meno che la pausa Invio non sia impostata su 0. Ogni rapporto USB deve completarsi prima che venga inviato il successivo, anche con un ritardo di 0 ms. Le lettere ripetute mantengono un intervallo di rilascio tra le pressioni.
• La velocità effettiva dipende dall’host USB e dal campo di testo. Aumenta il ritardo se mancano dei caratteri. L’applicazione non può rilevare i caratteri ignorati dall’applicazione di destinazione dopo il completamento della trasmissione USB.
• Una disconnessione o un trasferimento non riuscito interrompe l’invio. annulla l’operazione e tenta di rilasciare tutti i tasti. Il testo non viene reinviato automaticamente.

Compensazione automatica dell’indentazione

Nell’anteprima, premere oppure selezionare Auto-indent per attivare la compensazione quando l’editor di destinazione copia l’indentazione della riga precedente dopo Invio. La funzione è disattivata per impostazione predefinita e la scelta viene salvata.

Con la compensazione attiva, Plume USB invia un Backspace interno per ogni spazio iniziale o tabulazione presente nella riga precedente, dopo Invio e la relativa pausa. Successivamente, digita la riga seguente esattamente come appare nel file.

Vengono conteggiati anche gli spazi e le tabulazioni combinati. I caratteri di controllo Backspace letterali (U+0008) presenti nei file vengono rifiutati durante il controllo preliminare, indipendentemente da questa impostazione.

La funzione presuppone che l’editor copi letteralmente spazi e tabulazioni e che ogni Backspace elimini un solo carattere.

Gli editor che espandono le tabulazioni in spazi, aggiungono indentazione dopo sintassi come l’apertura di un blocco oppure cancellano più spazi per ogni Backspace richiedono una gestione diversa.

Prima di utilizzare la compensazione su un file completo, prova un breve esempio indentato nell’editor di destinazione. L’applicazione non può leggere il contenuto dell’editor per verificarlo.

Controlli

Controllo	Azione
/	Seleziona un’azione o un file
	Apri, conferma o avvia l’invio
	Indietro, cartella superiore o annulla l’invio
/	Pagina dei file precedente / successiva
	Alterna AZERTY FR / QWERTY US
	Modifica il ritardo dei caratteri
nell’anteprima	Modifica la pausa di Invio
nell’anteprima	Attiva o disattiva la compensazione automatica dell’indentazione
	Alterna il tema chiaro / scuro
	Attiva o disattiva il Blocco Maiuscole sul dispositivo di destinazione
	Diagnostica USB
	Esci

I pulsanti sullo schermo e le righe dei file supportano anche il tocco. Il layout, il ritardo dei caratteri, la pausa di Invio, la compensazione automatica dell’indentazione e il tema vengono salvati sulla scheda SD.

I controlli che potrebbero interferire con un trasferimento attivo vengono bloccati fino al suo completamento.

Diagnostica

Premere per aprire la diagnostica e per ripristinare la connessione USB. Chiudere gli altri homebrew che utilizzano USB o MTP prima di effettuare il test.

Se la connessione non riesce, provare a ricollegare il cavo e a ripristinare la connessione USB. Anche un PC con un editor di testo può essere utilizzato come dispositivo di destinazione per un test separato.

File di log: sdmc:/switch/plume-usb/usb.log

Il log registra le richieste USB, i risultati dei trasferimenti, i ripristini e le fasi degli errori. Il contenuto dei file di testo non viene registrato. L’apertura o il ripristino della connessione USB sostituisce il log precedente.

Quando segnali un problema, includi questo file, le versioni di Horizon e Atmosphère, la modalità di avvio, il tipo di collegamento del cavo e ciò che è apparso nel campo di testo di destinazione.

changelog

Compensazione automatica dell’indentazione per gli editor che copiano l’indentazione dopo aver premuto Invio. Premere nell’anteprima oppure toccare Auto-indent per attivarla. L’opzione è disattivata per impostazione predefinita e viene salvata tra una sessione e l’altra.

• Gestisce gli spazi iniziali, le tabulazioni e le indentazioni miste.
• I caratteri di controllo Backspace letterali presenti nei file di testo continuano a essere rifiutati durante il controllo preliminare. Le pressioni Backspace necessarie alla compensazione vengono generate internamente.
• Aggiunti test di regressione per il testo risultante nell’editor, le righe vuote, le riduzioni dell’indentazione, entrambi i layout, il rifiuto dei caratteri di controllo e il limite di 256 KiB per i dati in ingresso.

Un ringraziamento ad AsteroidPizza39 per la proposta e l’implementazione iniziale nella PR #2.

Download: Sostituire l’homebrew esistente con plume-usb-0.1.7.nro oppure estrarre Plume-USB-0.1.7-SD.zip nella directory principale della scheda SD della Switch 1. Le impostazioni esistenti vengono conservate. Sono inclusi anche i sorgenti e i checksum SHA-256.

Verifica: La compilazione incrociata e tutti i test portabili relativi al testo, alla compensazione dell’indentazione, alla digitazione e alle richieste USB simulate sono stati superati. La versione corretta della build della PR ha ricevuto un riscontro positivo dai test sulla console effettuati dal manutentore.

La compensazione presuppone che l’editor copi letteralmente spazi e tabulazioni e cancelli un solo carattere per ogni Backspace. Gli editor che espandono le tabulazioni o cancellano interi blocchi di indentazione potrebbero richiedere una gestione diversa: prova prima un breve esempio.

Download: Plume USB v0.1.7 (SD)

Download: Plume USB v0.1.7 (nro)

Download: Source code Plume USB v0.1.7

Alcune parti di questo articolo sono state generate con l’aiuto dell’intelligenza artificiale.

Ultimo aggiornamento 2026-10-30 / Link di affiliazione / Immagini da Amazon Product Advertising API