Como extrair os destaques do reMarkable e enviá-los para o Anki? [prompts de IA & github]
No Kindle, é possível exportar facilmente os trechos destacados, mas isso não acontece no reMarkable.
Usei o CODEX para criar uma interface web local onde posso selecionar meus arquivos (epub/PDF) do reMarkable, extrair os destaques e enviá-los para o Anki. Veja a interface:
Você pode ver que é possível:
- exportar os destaques de um documento para um deck do ANKI
- agrupar os destaques de vários arquivos em um deck do ANKI
- os destaques que se estendem por várias linhas são agrupados e considerados como um único destaque
Tudo é exportado diretamente para o ANKI via Anki Connect. Basta que o app Anki esteja instalado e aberto no Windows. Em seguida, os decks serão sincronizados com o AnkiWeb. Para cada cartão, você vê o trecho destacado no anverso e, no verso, seu contexto (uma frase antes e uma frase depois).
Se o mesmo arquivo tiver novos destaques, os cartões ANKI antigos não serão excluídos, apenas os novos destaques serão adicionados.
O repositório no GitHub está disponível aqui: https://github.com/tdm5c/remarkable-highlights-to-anki
Se você não quiser exportar os destaques para o ANKI, também é possível; basta pedir ao CODEX para exportá-los para um arquivo .html, .txt ou para o Google Docs…(como preferir). Vou dar alguns exemplos de prompts para que você possa se divertir e criar sua própria ferramenta.
Acesso SSH
Para obter o acesso SSH ao seu reMarkable, ligue o reMarkable, ative o Wi-Fi e vá em HELP => Copyrights and licenses, leia as instruções, conecte o cabo USB ao computador, autorize o acesso SSH e então obtenha o endereço MAC e a senha.
Para o reMarkable Paper Pro, é necessário ativar o Developer Mode antes de fazer tudo isso. O Developer Mode fará um reset do leitor, mas você não perderá documentos; apenas será necessário vincular o leitor à conta reMarkable para recuperar os documentos sincronizados.
Peço desculpas se não posso ser mais clara; este artigo é voltado um pouco para os geeks. Mais informações
Prompt 1 – Interface do reMarkable para o Anki
Copie e cole o bloco abaixo na sua ferramenta de IA/desenvolvimento. Os placeholders entre colchetes servem para mostrar onde esses valores serão configurados localmente.
Você é um agente de desenvolvimento sênior. Quero que você construa uma interface web local e um pipeline determinístico para exportar meus destaques do reMarkable para o Anki. Contexto local a ser adaptado ------------------------ - Diretório de trabalho: [CAMINHO DO PROJETO LOCAL AQUI] - Interface web local desejada: http://[ENDEREÇO IP LOCAL]:8787 - URL do AnkiConnect: http://[ENDEREÇO IP DO ANKI CONNECT]:8765 - Add-on AnkiConnect: 2055492159 - Usuário SSH do reMarkable: root - Porta SSH do reMarkable: 22 - MAC do reMarkable: manter no .env.local, não no prompt - Senha SSH do reMarkable: manter no .env.local, não no prompt Regras de segurança ------------------ - Não peça as credenciais reais no prompt. - Nunca armazene a senha do reMarkable no código-fonte, README ou notas Markdown. - Crie um arquivo .env.local com git-ignore para os segredos locais. - Coloque as credenciais reais apenas no .env.local, por exemplo: RM_REMARKABLE_MAC=[ENDEREÇO MAC AQUI] RM_SSH_PASSWORD=[SENHA SSH AQUI] ANKI_CONNECT_URL=http://[ENDEREÇO IP DO ANKI CONNECT]:8765 - Nunca modifique os arquivos no reMarkable, exceto por solicitação explícita. - Use SSH apenas para ler/copiar os dados do reMarkable. - Não use OCR. - Não use APIs de IA nem tokens de IA para extrair os destaques. - A extração deve ser local, determinística e relançável. Objetivo funcional -------------------- Construir uma ferramenta local que: 1. descubra o endereço IP atual do reMarkable a partir de RM_REMARKABLE_MAC, pois o DHCP pode mudar o IP; 2. liste os documentos PDF/EPUB disponíveis no reMarkable; 3. copie localmente os arquivos necessários; 4. extraia os destaques; 5. crie ou atualize as cartas Anki via AnkiConnect; 6. sincronize com o AnkiWeb após a atualização, exceto se houver opção de desativação. Extração dos destaques ------------------------- - Uma anotação contínua em várias linhas ou páginas deve se tornar um único destaque. - Se houver texto de origem não destacado entre dois fragmentos, são dois destaques distintos. - Preservar a ordem do documento: ordem das páginas, depois ordem de aparecimento na página. - Para PDF/EPUB, prefira o texto do documento de origem quando disponível; use os dados .rm como âncoras. - Para EPUB copiados do reMarkable, prefira o PDF sidecar renderizado para o alinhamento, pois as páginas .rm correspondem a essa paginação. - O verso não deve nunca ser estendido para completar uma palavra ou frase. - O verso pode conter contexto: exatamente uma frase anterior não-título + frase contendo o destaque com o destaque em negrito + exatamente uma frase seguinte não-título. Integração Anki ---------------- - Por padrão, criar um deck Anki por documento reMarkable, nomeado exatamente como o documento. - Criar uma carta Anki por destaque. - Frente: citação/destaque exato. - Verso: destaque em contexto quando disponível. - Usar IDs estáveis para que as reexecuções atualizem as notas existentes e adicionem apenas novos destaques. - Remover notas Anki obsoletas para o mesmo UUID de documento quando o conjunto estável de destaques mudar. - Após sincronização local Anki, reposicionar apenas as novas cartas na ordem de aparecimento do documento. - Não modificar o agendamento das cartas já revisadas/aprendidas. - Se AnkiConnect estiver inacessível, iniciar o Anki Desktop automaticamente e aguardar até que a coleção esteja disponível. - Após atualização local Anki, lançar sincronização AnkiWeb automaticamente, exceto com opção --no-sync-ankiweb. - Para documentos grandes, usar chamadas AnkiConnect em lote para evitar bloqueios. Interface web local -------------------- Construir uma interface web local simples e eficiente: - exibição padrão: os 10 últimos documentos PDF/EPUB; - opção 10/20/30/todos; - pesquisa apenas ao pressionar Enter ou clicar na lupa, não a cada tecla; - botão Atualizar que relança a detecção/lista e as tentativas SSH; - se o reMarkable estiver em espera, exibir uma mensagem clara pedindo para acordar o tablet e tentar novamente; - ordenação: recentes, nome A-Z, nome Z-A, PDF primeiro, EPUB primeiro; - multi-seleção de documentos; - botão "Selecionar tudo"; - os documentos selecionados devem permanecer visíveis/fixados mesmo que uma pesquisa ou ordenação os oculte; - a exportação multi-documento deve seguir a ordem atualmente exibida, não a ordem dos cliques; - opção adicional "Deck único" disponível apenas se vários arquivos estiverem selecionados; - se "Deck único" estiver ativado, enviar todos os destaques selecionados para um mesmo deck Anki cujo nome é configurável; - caso contrário, manter um deck por documento; - exibir as etapas da exportação em tempo real; - exibir erros e log em tempo real na interface, sem ficar preso em "running"; - em caso de erro, marcar o documento atual como erro e exibir a mensagem acionável. CLI esperada ------------ Prever também uma CLI: - --list para listar os documentos; - --document para exportar um documento específico; - --all para exportar todos os documentos PDF/EPUB com destaques; - --no-anki para testar sem modificar o Anki; - --no-sync-ankiweb para desativar a sincronização AnkiWeb; - --single-deck e --single-deck-name para exportar vários documentos em um único deck; - --host para forçar um IP reMarkable se necessário; - --mac para forçar uma MAC; - --no-discover para não fazer a detecção por MAC. Entregáveis esperados ------------------ - Código-fonte completo. - README com comandos de instalação e uso. - Arquivo de notas do projeto Markdown explicando decisões e limitações. - .gitignore que exclua .env.local, caches, exportações temporárias e segredos. - Interface web local iniciada em http://[ENDEREÇO IP LOCAL]:8787. - Testes ou verificações mínimos mostrando que: - a extração não depende de OCR; - os destaques permanecem na ordem; - as reexecuções não duplicam cartas; - erros web são visíveis na interface. Restrições importantes ----------------------- - Nunca exibir meus segredos nos logs, README ou respostas finais. - Se um segredo for necessário, usar um placeholder ou uma variável de ambiente. - Manter a ferramenta local, reproduzível e compreensível. - Antes de terminar, verificar a sintaxe, executar os testes disponíveis e fornecer os comandos exatos para iniciar a interface.
Prompt 2 – Extração reMarkable para arquivos TXT
Copie e cole o bloco abaixo na sua ferramenta de IA/desenvolvimento. Os placeholders entre colchetes servem para mostrar onde esses valores serão configurados localmente.
Você é um agente de desenvolvimento sênior. Quero que você construa uma interface web local e um pipeline determinístico para extrair meus destaques do reMarkable e salvar em arquivos .txt. Não quero exportação Anki nesta versão.
Contexto local a ser adaptado
------------------------
- Pasta de trabalho: [CAMINHO PROJETO LOCAL AQUI]
- Interface web local desejada: http://[ENDEREÇO IP LOCAL]:8787
- Usuário SSH do reMarkable: root
- Porta SSH do reMarkable: 22
- MAC do reMarkable: manter em .env.local, não no prompt
- Senha SSH do reMarkable: manter em .env.local, não no prompt
Regras de segurança
------------------
- Não peça os acessos reais no prompt.
- Nunca armazene a senha do reMarkable no código-fonte, README ou notas Markdown.
- Crie um arquivo .env.local ignorado pelo git para os segredos locais.
- Coloque os acessos reais apenas no .env.local, por exemplo:
RM_REMARKABLE_MAC=[ENDEREÇO MAC AQUI]
RM_SSH_PASSWORD=[SENHA SSH AQUI]
- Nunca modifique arquivos no reMarkable, exceto se explicitamente solicitado.
- Use SSH apenas para ler/copiar dados do reMarkable.
- Não use OCR.
- Não use APIs de IA nem tokens de IA para extrair os destaques.
- A extração deve ser local, determinística e relançável.
- Nunca mostre meus segredos nos logs, README ou respostas finais.
Objetivo funcional
--------------------
Construir uma ferramenta local que:
1. descubra o endereço IP atual do reMarkable a partir de RM_REMARKABLE_MAC, pois o DHCP pode mudar o IP;
2. liste os documentos PDF/EPUB disponíveis no reMarkable;
3. copie localmente os arquivos necessários;
4. extraia os destaques;
5. escreva os resultados em arquivos .txt locais.
Extração dos destaques
-------------------------
- Uma anotação contínua em várias linhas ou páginas deve se tornar um único destaque.
- Se texto-fonte não destacado estiver entre dois fragmentos, são dois destaques distintos.
- Preserve a ordem do documento: ordem das páginas, depois ordem de aparecimento na página.
- Para PDF/EPUB, prefira o texto do documento-fonte quando disponível; use os dados .rm como âncoras.
- Para EPUBs copiados do reMarkable, prefira o PDF sidecar renderizado para o alinhamento, pois as páginas .rm correspondem a essa paginação.
- A citação extraída nunca deve ser estendida para completar uma palavra ou frase.
- Não deduza texto com IA. Se um alinhamento falhar, sinalize claramente no log.
Formato das saídas .txt
-----------------------
Escreva um arquivo .txt por documento em uma pasta local, por exemplo:
exports/remarkable_txt/[NOME_DO_DOCUMENTO].txt
Cada arquivo deve conter:
- título do documento;
- UUID do documento, se disponível;
- data de exportação local;
- número total de destaques;
- lista dos destaques na ordem do documento.
Formato sugerido para cada destaque:
---
Destaque 001
Página: [PÁGINA SE DISPONÍVEL]
Texto:
[TEXTO EXATO DO DESTAQUE]
---
Interface web local
--------------------
Construa uma interface web local simples e eficiente:
- exibição padrão: os 10 documentos PDF/EPUB mais recentes;
- opção 10/20/30/todos;
- pesquisa apenas ao pressionar Enter ou clicar na lupa, não a cada tecla;
- botão Atualizar que relança a detecção/lista e as tentativas SSH;
- se o reMarkable estiver em espera, exiba uma mensagem clara pedindo para acordar o tablet e tentar novamente;
- ordenação: recentes, nome A-Z, nome Z-A, PDF primeiro, EPUB primeiro;
- seleção múltipla de documentos;
- botão "Selecionar todos";
- os documentos selecionados devem permanecer visíveis/fixados mesmo que uma pesquisa ou ordenação os oculte;
- a exportação multi-documentos deve seguir a ordem atualmente exibida, não a ordem dos cliques;
- botão "Exportar em TXT";
- exibir o caminho dos arquivos .txt gerados;
- exibir as etapas da exportação em tempo real;
- exibir erros e log em tempo real na interface, sem ficar preso em "running";
- em caso de erro, marcar o documento atual como erro e exibir a mensagem utilizável.
CLI esperada
------------
Preveja também uma CLI:
- --list para listar documentos;
- --document para exportar um documento específico;
- --all para exportar todos os documentos PDF/EPUB com destaques;
- --output-dir para escolher a pasta de saída .txt;
- --host para forçar um IP do reMarkable se necessário;
- --mac para forçar um MAC;
- --no-discover para não fazer a detecção por MAC.
Entregáveis esperados
------------------
- Código-fonte completo.
- README com comandos de instalação e uso.
- Arquivo de notas do projeto em Markdown explicando as decisões e limitações.
- .gitignore que exclui .env.local, caches, exportações temporárias e segredos.
- Interface web local executada em http://[ENDEREÇO IP LOCAL]:8787.
- Testes ou verificações mínimos mostrando que:
- a extração não depende de OCR;
- os destaques permanecem na ordem;
- os arquivos .txt são recriados sem duplicatas;
- os erros da web são visíveis na interface.
Restrições importantes
-----------------------
- Nunca exibir meus segredos.
- Se um segredo for necessário, utilize um placeholder ou uma variável de ambiente.
- Mantenha a ferramenta local, reproduzível e compreensível.
- Antes de terminar, verifique a sintaxe, execute os testes disponíveis e, em seguida, forneça os comandos exatos para iniciar a interface e exportar os arquivos .txt.
