Ajuda do LightNote para Android

O app do celular é um companheiro do LightNote do computador: ele abre a mesma pasta de notas, lê e grava os mesmos arquivos, e as grava pelo mesmo núcleo — o código que entende Markdown, quadros de tarefas, tabelas e cartões é o mesmo nos dois. O que você escreve no celular abre no computador sem conversão, e vice-versa.

Índice

• Instalar e atualizar (prévia)
• Começar: o vault no celular
• Notas: ler e editar
• Capturar: nota de hoje, compartilhar e widget
• Buscar e notas ligadas
• Tarefas, tabelas e Bases
• Cartões de revisão
• Lembretes
• Outros arquivos
• Markdown Seguro
• Sincronizar com o computador (Git)
• O que fica só no computador

Instalar e atualizar (prévia)

O app ainda não está na Google Play: ele é uma prévia gratuita, distribuída como APK no GitHub, em github.com/nglczr/LightNote-Android. Precisa de Android 9 ou mais novo, num celular ARM de 64 bits.

• Instalar. Baixe o .apk pelo navegador do celular e toque nele. O Android pede para permitir a instalação de apps pelo navegador ou pelo gerenciador de arquivos, e o Play Protect pode avisar sobre um desenvolvedor desconhecido.
• Conferir a origem. Todo APK do LightNote é assinado com a mesma chave; a impressão digital SHA-256 do certificado está no README do repositório e em cada release.
• Atualizar. Instale o APK novo por cima do antigo: as notas ficam. Não desinstale para atualizar — desinstalar apaga os espaços que não foram sincronizados por Git nem exportados por Exportar vault (.zip). O app Obtainium, com o endereço do repositório, avisa das versões novas.

Quando o LightNote chegar à Google Play, ele será um app pago, com preço único (ainda não definido). A prévia não dá direito à versão da loja, e os APKs do GitHub podem deixar de ser atualizados depois do lançamento.

Começar: o vault no celular

O app guarda espaços de trabalho: cada um é uma pasta própria do aparelho, com ou sem repositório Git. Toque no nome do espaço, no topo da tela inicial, para trocar de espaço ou trazer outro:

• Escolher de uma conta Git — cadastre a conta (GitHub, GitLab, Gitea/Forgejo ou outro servidor) com um token de acesso, e o app lista os repositórios dela; tocar num deles o clona como um espaço novo. É o caminho recomendado: depois disso as mudanças vão e voltam sozinhas (veja Sincronizar).
• Ler o QR code do computador — no LightNote do computador, Abrir no celular… (no menu do Git) mostra um QR com o endereço do repositório da pasta e o autor dos commits. Se o computador incluiu o acesso, o app pede a senha definida lá, confere o token no servidor e guarda a conta; com a senha errada, é só digitar de novo. Ler o QR precisa dos serviços do Google Play; num aparelho sem eles o app avisa, e o caminho é Clonar por endereço.
• Clonar por endereço — cole o endereço HTTPS do repositório. Em Acesso, um repositório público não precisa de nada; para um privado, cole um token de acesso (Criar um token abre a página do servidor). O usuário só é pedido num servidor que não é GitHub nem GitLab.
• Importar vault (.zip) — compacte a pasta no computador, mande o arquivo para o celular e escolha Importar vault (.zip) no menu da pasta. É uma cópia: nada liga as duas pastas depois disso. Exportar vault (.zip), no mesmo menu, faz o caminho de volta: um .zip do espaço inteiro, para guardar ou levar ao computador.

A tela inicial leva ao que se faz todo dia: Hoje abre a nota do dia já editando, Captura rápida acrescenta uma linha a ela, e logo abaixo ficam as notas recentes e o estado da sincronização. Os arquivos da pasta vêm depois. Quando há tarefas em aberto, a seção Pendências lista as caixinhas das notas e as tarefas dos quadros, com o nome do quadro; Ver todas mostra a lista inteira. As telas de Sincronizar, Espaços, Contas Git, Cartões e dos quadros têm o botão Ajuda (o ponto de interrogação), que abre esta página na seção delas.

Notas: ler e editar

Tocar numa nota abre a leitura: a nota formatada, com títulos, listas, tabelas, citações, caixas de destaque, fórmulas em LaTeX, diagramas Mermaid e estruturas químicas desenhados pelo mesmo motor do computador. Os links entre notas ([[nota]] e [[nota#seção]]) abrem a nota dentro do app; os links da web vão para o navegador.

O botão Editar no topo troca para o texto da nota, em Markdown, com a marcação colorida. Uma barra sobre o teclado traz desfazer e refazer, título, negrito, itálico, lista, caixa de tarefa, link [[ ]] e código. A gravação é automática: o texto é salvo um instante depois que você para de digitar — e também ao voltar, ao girar o aparelho e ao sair do app.

O botão + no canto de baixo de toda pasta cria uma nota nova ali e abre o editor com o teclado já no texto. No topo fica o nome da nota, sugerido pela primeira linha que você escreve (até lá, a data e a hora); toque nele para escolher outro. O arquivo só é criado quando houver texto, e a nota que ficou vazia não sobra na pasta. O mesmo campo renomeia uma nota que já existe.

Nova nota a partir de modelo (no menu ⋮) usa os modelos da pasta Modelos (ou Templates) do vault — os mesmos do computador, com os campos {{titulo}} e {{data}} preenchidos.

Toque e segure um arquivo ou pasta para renomear, mover ou excluir; Nova pasta fica no menu da pasta. Renomear um quadro de tarefas ou uma tabela leva a pasta de anexos junto. O botão Voltar volta à tela anterior — da nota aberta pela busca, de volta à busca.

Listas e tarefas. No editor, a caixa de tarefa aparece como caixa e se marca com um toque; a tarefa feita fica riscada, e a marcação do Markdown (#, **, [[ ]]) some fora da linha em que você está — o texto aparece formatado — e volta, apagada, quando o cursor entra nela. O botão de negrito (e o de itálico e o de código) liga e desliga, como num editor formatado. O Enter continua a lista — a bala, a tarefa (que nasce aberta) e o número (que sobe) — e o Enter num item vazio sai da lista. A barra tem lista numerada, Recuar e Desrecuar, que levam o item para a coluna certa para virar sublista. O arquivo continua sendo o Markdown que você escreveu.

Capturar: nota de hoje, compartilhar e widget

• Hoje abre a nota diária, a mesma que o computador usa.
• Captura rápida acrescenta uma linha à nota de hoje, com a hora, sem abrir a nota.
• Compartilhar de outro app e escolher o LightNote: um link ou uma frase curta vira uma linha da nota de hoje (o Gemini, por exemplo, compartilha a conversa como link). Um texto de várias linhas — a resposta de uma IA, um trecho de artigo — vira uma nota nova, com o texto intacto, e a nota de hoje ganha o link para ela. Fotos e PDFs, um ou vários de uma vez, vão para a pasta de anexos da nota de hoje, com um link na nota. Depois, a nota que recebeu abre na tela.
• O widget da tela inicial tem os dois atalhos: abrir a nota de hoje e a captura rápida.

Nota de voz. O botão Nota de voz da tela inicial (ou o atalho do ícone) grava pelo microfone — também com a tela apagada; a notificação mostra o tempo e tem o Parar. A gravação vai para a pasta de gravações do espaço de trabalho (Gravações, a mesma do LightNote do computador) e entra como uma linha na nota de hoje; tocar nela abre o tocador. O arquivo é um .m4a, o formato que o computador grava e sabe transcrever: a transcrição e o resumo se fazem lá, depois de sincronizar.

Buscar e notas ligadas

Buscar procura no texto de todas as notas do vault e lista cada trecho achado com a nota e a linha; tocar num resultado abre a nota. No pé de cada nota, Notas que apontam para esta lista as que têm um link para ela.

Tarefas, tabelas e Bases

• Quadros de tarefas (.lnt) abrem como colunas por status. Dá para mover uma tarefa de coluna, marcar os itens da lista dela, renomear e criar tarefas. Campos que o celular não mostra continuam no arquivo intactos. Tocar numa tarefa abre os campos dela: o título, o Vencimento, a Prioridade e a coluna, e ali mesmo ela se Arquiva ou se Exclui.
• Tabelas personalizadas (.lnd) abrem com as colunas do computador; dá para editar células de texto, número, caixa de marcar e seleção, e acrescentar linhas. A coluna de senha aparece como ****: tocar na célula pede a Frase-Segura, e então Revelar mostra a senha e Copiar a põe na área de transferência, que é limpa em 30 segundos.
• Bases (.lnq) mostram o resultado da consulta, só para leitura.
• A pasta de Arquivos de uma tarefa ou de uma linha aparece no registro, e os anexos abrem dali.

Um quadro ou uma tabela gravado por uma versão mais nova do LightNote não é aberto: o app avisa, em vez de arriscar estragar o arquivo. Atualize o app.

Cartões de revisão

Revisar cartões traz os cartões que vencem hoje, das notas marcadas com #cartoes (ou #flashcards) — a mesma sintaxe do computador. A resposta fica escondida até você tocar em Mostrar resposta; as quatro notas (Errei, Difícil, Bom, Fácil) mostram o próximo intervalo de cada uma. O agendamento é gravado a cada resposta e sincroniza com o computador.

Lembretes

Tarefas que vencem hoje ou já venceram geram uma notificação quando o app abre, e as dos próximos dias ficam agendadas para as 9h do dia do vencimento. No Android 13 ou mais novo, a permissão de notificação só é pedida quando há o que avisar.

Outros arquivos

• Código abre colorido, com as mesmas cores do editor do computador. O lápis no topo passa para a edição em texto puro (sem a formatação das notas), em arquivos de até 1 MB; o arquivo continua com a codificação e o fim de linha que tinha.
• Cadernos de Blocos (.lnb) abrem numa página só, com as células na ordem do caderno e, embaixo de cada uma, o resultado da última execução feita no computador — no celular nada é executado. Tocar o nome de uma célula abre o arquivo dela para editar.
• Conexões de banco de dados (.lnc), testes HTTP (.lnh) e conexões SSH (.lns) são do LightNote do computador, que os executa: no celular eles abrem só para leitura, com uma frase dizendo o que são.
• Imagens abrem com zoom de pinça, e PDF página por página.
• CSV e TSV abrem como tabela (as primeiras linhas, quando o arquivo é grande), com o separador detectado sozinho.
• Qualquer outro tipo vai para Abrir com, que oferece os apps do aparelho que o abrem.

Markdown Seguro

Notas cifradas (.lne) pedem a Frase-Segura do espaço de trabalho. Ela fica só na memória enquanto o app está aberto, e o texto claro nunca é gravado em disco: a nota é decifrada e cifrada de novo pelo mesmo código do computador.

Sincronizar com o computador (Git)

A sincronização usa um repositório Git (GitHub, GitLab, Gitea…), o mesmo que o LightNote do computador usa na pasta. Cada espaço de trabalho clonado sincroniza com o seu repositório, com a conta Git do servidor dele.

Contas Git. Em Contas Git, escolha o provedor e o servidor e cole um token de acesso com leitura e escrita nos repositórios que você quer no celular (no GitHub, um token de acesso pessoal; o botão Criar um token no site abre a página certa). O app confere o token antes de guardá-lo, cifrado no aparelho. Um servidor qualquer (Outro servidor) pede também o usuário e não lista repositórios: o clone é pelo endereço.

Depois de clonar, a sincronização roda sozinha: ao abrir o app, ao sair das telas que gravam (nota, quadro, tarefa, tabela, cartões) e quando o app vai para o fundo. Com uma nota aberta, o que chegou e mudaria essa nota espera ela fechar — o editor gravaria o texto dele por cima. A tela inicial mostra quando foi a última, o que falta enviar e se ela falhou; Sincronizar (receber e enviar) faz o mesmo na hora. Uma falha de rede fica em silêncio e é tentada de novo na próxima vez.

Autor dos commits. Os commits do celular levam um nome e um e-mail: os do computador, quando o espaço veio pelo QR, ou os da conta Git (no GitHub, o e-mail noreply do perfil, que liga o commit a ele). Em Sincronizar (Git), Editar, ao lado do autor, troca os dois.

Conflitos. Quando a mesma nota mudou no celular e no computador, as mudanças em trechos diferentes são juntadas. Quando foi o mesmo trecho, nada se perde: a versão do celular vira uma cópia ao lado (Nota (celular).md), e o app diz quais cópias criou. Quadros de tarefas, tabelas e cartões são juntados registro a registro.

O celular não suporta Git LFS nem submódulos: com LFS, os arquivos chegam como pequenos ponteiros de texto (não os edite no celular); submódulos aparecem como pastas vazias. A tela avisa quando o repositório usa um dos dois.

Cópias de conflito ficam listadas em Sincronizar (Git), com um toque para abrir, até serem vistas. O item Remover do celular, na lista de espaços, apaga a pasta do espaço deste celular: o que já foi sincronizado continua no repositório. No espaço atual, o app troca de espaço antes; o único espaço não se remove. Se algo ainda não subiu, o app diz quantas alterações se perderiam e oferece Sincronizar e remover.

O que fica só no computador

O celular é para ler, escrever e capturar. Ficam no computador: os assistentes de IA e o MCP, o cliente SQL e a análise de dados, o terminal, a exportação para Word, PDF e outros formatos, a importação de outros apps, o histórico de versões e a edição dos quadros em modo cronograma. Documentos do Office e EPUB abrem pelo Abrir com.