Guida di LightNote per Android
L'app per il telefono è una compagna di LightNote sul computer: apre la stessa cartella di note, legge e scrive gli stessi file e li scrive con lo stesso nucleo — il codice che capisce il Markdown, le bacheche di attività, le tabelle e le carte è lo stesso nei due. Ciò che scrivi sul telefono si apre sul computer senza conversione, e viceversa.
Indice
- Installare e aggiornare (anteprima)
- Per iniziare: il vault sul telefono
- Note: leggere e modificare
- Acquisire: la nota di oggi, la condivisione e il widget
- Ricerca e note collegate
- Attività, tabelle e Basi
- Carte di ripasso
- Promemoria
- Altri file
- Markdown Sicuro
- Sincronizzare con il computer (Git)
- Cosa resta solo sul computer
Installare e aggiornare (anteprima)
L'app non è ancora su Google Play: è un'anteprima gratuita, distribuita come APK su GitHub, all'indirizzo github.com/nglczr/LightNote-Android. Richiede Android 9 o successivo, su un telefono ARM a 64 bit.
- Installare. Scarica l'
.apkcon il browser del telefono e toccalo. Android chiede di consentire l'installazione di app dal browser o dal gestore file, e Play Protect può avvisare di uno sviluppatore sconosciuto. - Verificare l'origine. Ogni APK di LightNote è firmato con la stessa chiave; l'impronta SHA-256 del certificato è nel README del repository e in ogni release.
- Aggiornare. Installa il nuovo APK sopra il vecchio: le note restano. Non disinstallare per aggiornare — disinstallare cancella gli spazi non sincronizzati con Git né esportati con Esporta vault (.zip). L'app Obtainium, con l'indirizzo del repository, avvisa delle nuove versioni.
Quando LightNote arriverà su Google Play, sarà un'app a pagamento, con prezzo unico (non ancora definito). L'anteprima non dà diritto alla versione dello store, e gli APK su GitHub potrebbero non essere più aggiornati dopo il lancio.
Per iniziare: il vault sul telefono
L’app conserva spazi di lavoro: ognuno è una cartella propria del dispositivo, con o senza repository Git. Tocca il nome dello spazio, in alto nella schermata iniziale, per cambiare spazio o portarne un altro:
- Scegli da un account Git — aggiungi l’account (GitHub, GitLab, Gitea/Forgejo o un altro server) con un token di accesso, e l’app elenca i suoi repository; toccarne uno lo clona come nuovo spazio. È la strada consigliata: da quel momento le modifiche vanno e vengono da sole (vedi Sincronizzare).
- Scansiona il codice QR dal computer — in LightNote sul computer, Apri sul telefono… (nel menu Git) mostra un QR con l’indirizzo del repository della cartella e l’autore dei commit. Se il computer ha incluso l’accesso, l’app chiede la password impostata lì, verifica il token sul server e salva l’account; con una password errata basta digitarla di nuovo. La lettura del QR richiede i servizi Google Play; su un dispositivo che non li ha l’app lo segnala, e la strada è Clona da indirizzo.
- Clona da indirizzo — incolla l’indirizzo HTTPS del repository. In Accesso, un repository pubblico non richiede nulla; per uno privato, incolla un token di accesso (Crea un token apre la pagina del server). L’utente viene chiesto solo su un server che non è né GitHub né GitLab.
- Importa vault (.zip) — comprimi la cartella sul computer, invia il file al telefono e scegli Importa vault (.zip) nel menu della cartella. È una copia: dopo, nulla collega le due cartelle. Esporta vault (.zip), nello stesso menu, fa il percorso inverso: uno
.zipdell'intero spazio, da conservare o portare sul computer.
La schermata iniziale porta a ciò che si fa ogni giorno: Oggi apre la nota del giorno già in modifica, Acquisizione rapida vi aggiunge una riga, e subito sotto ci sono le note recenti e lo stato della sincronizzazione. I file della cartella vengono dopo. Quando ci sono attività aperte, la sezione In sospeso elenca le caselle delle note e le attività delle bacheche, con il nome della bacheca; Vedi tutte mostra l'elenco intero. Le schermate Sincronizza, Spazi, Account Git, Carte e quelle delle bacheche hanno il pulsante Guida (il punto interrogativo), che apre questa pagina nella loro sezione.
Note: leggere e modificare
Toccare una nota la apre in lettura: la nota formattata, con titoli, elenchi, tabelle, citazioni, riquadri,
formule LaTeX, diagrammi Mermaid e strutture chimiche disegnati dallo stesso motore del computer. I link tra note
([[nota]] e [[nota#sezione]]) aprono la nota nell'app; i link web vanno al browser.
Il pulsante Modifica in alto passa al testo della nota, in Markdown, con il markup colorato. Una barra sopra la tastiera offre annulla e ripeti, titolo, grassetto, corsivo, elenco, casella di attività, link [[ ]] e codice. Il salvataggio è automatico: il testo viene salvato un attimo dopo che smetti di scrivere — e anche quando torni indietro, ruoti il dispositivo o esci dall’app.
Il pulsante + nell’angolo in basso di ogni cartella crea lì una nuova nota e apre l’editor con la tastiera già nel testo. In alto c’è il nome della nota, suggerito dalla prima riga che scrivi (fino ad allora, la data e l’ora); toccalo per sceglierne un altro. Il file viene creato solo quando c’è del testo, e una nota rimasta vuota non resta nella cartella. Lo stesso campo rinomina una nota che esiste già.
Nuova nota da modello (nel menu ⋮) usa i modelli della cartella Templates (o Modelos) del vault — gli stessi del computer, con i campi {{title}} e {{date}} compilati.
Tieni premuto un file o una cartella per rinominarlo, spostarlo o eliminarlo; Nuova cartella è nel menu della cartella. Rinominare una bacheca di attività o una tabella porta con sé la sua cartella degli allegati. Il tasto Indietro torna alla schermata precedente: da una nota aperta dalla ricerca, di nuovo alla ricerca.
Elenchi e attività. Nell’editor la casella di attività è disegnata come casella e si spunta con un tocco; l’attività fatta è barrata, e il markup Markdown (#, **, [[ ]]) scompare fuori dalla riga in cui ti trovi — il testo appare formattato — e torna, attenuato, quando il cursore vi entra. Il pulsante grassetto (e quelli di corsivo e codice) attiva e disattiva, come in un editor formattato. Invio continua l’elenco — il punto elenco, l’attività (che nasce aperta) e il numero (che sale) — e Invio su una voce vuota esce dall’elenco. La barra ha elenco numerato, Aumenta rientro e Riduci rientro, che portano la voce nella colonna giusta per diventare un sottoelenco. Il file resta il Markdown che hai scritto.
Acquisire: la nota di oggi, la condivisione e il widget
- Oggi apre la nota giornaliera, la stessa che usa il computer.
- Acquisizione rapida aggiunge una riga con l'ora alla nota di oggi, senza aprire la nota.
- Condividere da un’altra app scegliendo LightNote: un link o una frase breve diventa una riga della nota di oggi (Gemini, per esempio, condivide la conversazione come link). Un testo di più righe — la risposta di un’IA, un estratto di un articolo — diventa una nuova nota, con il testo intatto, e la nota di oggi riceve un link a essa. Foto e PDF, uno o più alla volta, vanno nella cartella degli allegati della nota di oggi, con un link nella nota. Poi la nota che li ha ricevuti si apre sullo schermo.
- Il widget della schermata iniziale ha le due scorciatoie: aprire la nota di oggi e l'acquisizione rapida.
Nota vocale. Il pulsante Nota vocale della schermata iniziale (o la scorciatoia dell’icona) registra dal microfono, anche a schermo spento; la notifica mostra il tempo e ha Interrompi. La registrazione va nella cartella delle registrazioni dello spazio di lavoro (Registrazioni, la stessa di LightNote sul computer) e viene aggiunta come riga alla nota di oggi; toccandola si apre il lettore. Il file è un .m4a, il formato che il computer registra e sa trascrivere: trascrizione e riassunto si fanno lì, dopo la sincronizzazione.
Ricerca e note collegate
Cerca esamina il testo di tutte le note del vault ed elenca ogni corrispondenza con la nota e la riga; toccare un risultato apre la nota. In fondo a ogni nota, Note che puntano qui elenca quelle che hanno un link a essa.
Attività, tabelle e Basi
- Le bacheche di attività (
.lnt) si aprono come colonne per stato. Puoi spostare un'attività di colonna, spuntare le voci della sua lista, rinominare e creare attività. I campi che il telefono non mostra restano intatti nel file. Un tocco su un'attività apre i suoi campi: il titolo, la Scadenza, la Priorità e la colonna, e lì stesso la si può Archiviare o Eliminare. - Le tabelle personalizzate (
.lnd) si aprono con le colonne del computer; puoi modificare celle di testo, numero, casella e selezione, e aggiungere righe. La colonna della password appare come****: un tocco sulla cella chiede la Passphrase, poi Rivela mostra la password e Copia la mette negli appunti, che vengono svuotati dopo 30 secondi. - Le Basi (
.lnq) mostrano il risultato della query, in sola lettura. - La cartella File di un'attività o di una riga compare nel record, e gli allegati si aprono da lì.
Una bacheca o una tabella salvata da una versione più recente di LightNote non viene aperta: l'app lo dice invece di rischiare di rovinare il file. Aggiorna l'app.
Carte di ripasso
Ripassa le carte porta le carte in scadenza oggi, dalle note con il tag #flashcards (o
#cartoes) — la stessa sintassi del computer. La risposta resta nascosta finché non tocchi Mostra la
risposta; i quattro voti (Da rivedere, Difficile, Buona, Facile) mostrano ciascuno il
prossimo intervallo. La pianificazione viene salvata dopo ogni risposta e si sincronizza con il computer.
Promemoria
Le attività in scadenza oggi o già scadute generano una notifica all'apertura dell'app, e quelle dei giorni successivi vengono programmate per le 9:00 del giorno di scadenza. Su Android 13 o successivo, il permesso di notifica viene chiesto solo quando c'è qualcosa da segnalare.
Altri file
- Il codice si apre a colori, con gli stessi colori dell’editor del computer. La matita in alto passa alla modifica come testo semplice (senza la formattazione delle note), per i file fino a 1 MB; il file mantiene la sua codifica e i suoi fine riga.
- I quaderni di Blocchi (
.lnb) si aprono in una sola pagina, con le celle nell’ordine del quaderno e, sotto ciascuna, il risultato dell’ultima esecuzione fatta sul computer — sul telefono non si esegue nulla. Toccare il nome di una cella apre il suo file per modificarlo. - Le connessioni al database (
.lnc), i test HTTP (.lnh) e le connessioni SSH (.lns) appartengono a LightNote sul computer, che li esegue: sul telefono si aprono in sola lettura, con una frase che dice cosa sono. - Le immagini si aprono con lo zoom a pizzico, e i PDF pagina per pagina.
- I CSV e i TSV si aprono come tabella (le prime righe, se il file è grande), con il separatore rilevato da solo.
- Qualsiasi altro tipo passa ad Apri con, che propone le app del dispositivo in grado di aprirlo.
Markdown Sicuro
Le note cifrate (.lne) chiedono la Passphrase dello spazio di lavoro. Resta solo in memoria
finché l'app è aperta, e il testo in chiaro non viene mai scritto su disco: la nota viene decifrata e cifrata di nuovo
dallo stesso codice del computer.
Sincronizzare con il computer (Git)
La sincronizzazione usa un repository Git (GitHub, GitLab, Gitea…), lo stesso che LightNote sul computer usa nella cartella. Ogni spazio di lavoro clonato si sincronizza con il suo repository, con l’account Git del suo server.
Account Git. In Account Git, scegli il provider e il server e incolla un token di accesso con lettura e scrittura sui repository che vuoi sul telefono (su GitHub, un token di accesso personale; il pulsante Crea un token sul sito apre la pagina giusta). L’app verifica il token prima di conservarlo, cifrato sul dispositivo. Un server qualsiasi (Altro server) chiede anche l’utente e non elenca i repository: si clona dall’indirizzo.
Dopo il clone, la sincronizzazione parte da sola: all’apertura dell’app, quando esci dalle schermate che salvano (nota, bacheca, attività, tabella, carte) e quando l’app va in background. Con una nota aperta, ciò che è arrivato e cambierebbe quella nota aspetta che venga chiusa: l’editor ci scriverebbe sopra il suo testo. La schermata iniziale mostra quando è avvenuta l’ultima, cosa resta da inviare e se non è riuscita; Sincronizza (ricevi e invia) fa lo stesso subito. Un errore di rete resta silenzioso e si riprova la volta successiva.
Autore dei commit. I commit del telefono portano un nome e un’e-mail: quelli del computer, se lo spazio di lavoro è arrivato dal QR, o quelli dell’account Git (su GitHub, l’e-mail noreply del profilo, che collega il commit a esso). In Sincronizza (Git), Modifica, accanto all’autore, cambia entrambi.
Conflitti. Quando la stessa nota è cambiata sul telefono e sul computer, le modifiche in punti diversi vengono unite. Se è lo stesso punto, nulla va perso: la versione del telefono diventa una copia accanto (Nota (telefono).md), e l'app dice quali copie ha creato. Bacheche di attività, tabelle e carte vengono unite record per record.
Il telefono non supporta Git LFS né i sottomoduli: con LFS, i file arrivano come piccoli puntatori di testo (non modificarli sul telefono); i sottomoduli appaiono come cartelle vuote. La schermata avvisa quando il repository usa uno dei due.
Le copie di conflitto restano elencate in Sincronizza (Git), a un tocco, finché non vengono viste. Il comando Rimuovi dal telefono, nell’elenco degli spazi di lavoro, elimina la sua cartella da questo telefono: ciò che è già sincronizzato resta nel repository. Sullo spazio attuale, l’app cambia prima spazio; l’unico spazio non si può rimuovere. Se qualcosa non è ancora stato inviato, l’app dice quante modifiche andrebbero perse e propone Sincronizza e rimuovi.
Cosa resta solo sul computer
Il telefono serve a leggere, scrivere e acquisire. Restano sul computer: gli assistenti di IA e l'MCP, il client SQL e l'analisi dei dati, il terminale, l'esportazione in Word, PDF e altri formati, l'importazione da altre app, la cronologia delle versioni e la modifica delle bacheche in modalità cronoprogramma. I documenti Office ed EPUB si aprono con Apri con.