Come estrarre i propri highlight reMarkable e inviarli su Anki? [prompt IA & github]
Su Kindle, è molto facile esportare i passaggi evidenziati, ma non è così su reMarkable.
Ho usato CODEX per creare un’interfaccia web locale dove posso selezionare i miei file reMarkable (epub/PDF), estrarre gli highlight e inviarli ad Anki. Ecco l’interfaccia:
Potete vedere che si può:
- esportare gli highlight di un documento in un deck ANKI
- raggruppare gli highlight di più file in un deck ANKI
- gli highlight che si estendono su più righe vengono raggruppati e considerati come un unico highlight
Il tutto viene esportato direttamente su ANKI tramite Anki Connect. Basta che l’app Anki sia installata e aperta su Windows. Poi i deck verranno sincronizzati con Ankiweb. Per ogni carta, vedete il passaggio evidenziato sul recto e, sul verso, il suo contesto (una frase prima e una dopo).
Se lo stesso file ha nuovi highlight, le vecchie carte ANKI non verranno cancellate, verranno aggiunti solo i nuovi highlight.
Il repository GitHub è disponibile qui: https://github.com/tdm5c/remarkable-highlights-to-anki
Se non volete esportare gli highlight su ANKI, è possibile anche, basta chiedere a CODEX di esportarli in un file .html o .txt o su Google Docs…(come volete). Vi darò alcuni esempi di prompt per divertirvi e creare il vostro strumento.
Accesso SSH
Per recuperare l’accesso SSH al vostro reMarkable, accendete il reMarkable, attivate il Wi-Fi e andate in HELP => Copyrights and licenses, leggete le istruzioni, collegate il cavo USB al computer, autorizzate l’accesso SSH, e poi recuperate l’indirizzo MAC così come la password.
Per reMarkable Paper Pro, è necessario attivare il Developer Mode prima di fare tutto ciò. La Developer Mode resetta il dispositivo ma non perderete documenti, basterà ricollegare il dispositivo all’account reMarkable per recuperare i documenti sincronizzati.
Mi dispiace se non posso essere più chiara, questo articolo è un po’ per geek. Maggiori informazioni
Prompt 1 – Interfaccia reMarkable verso Anki
Copia-incolla il blocco qui sotto nel tuo strumento IA/sviluppo. I placeholder tra parentesi servono per mostrare dove verranno configurate localmente queste impostazioni.
Sei uno sviluppatore senior. Voglio che costruisci un'interfaccia web locale e una pipeline deterministica per esportare i miei highlight reMarkable su Anki. Contesto locale da adattare ------------------------ - Cartella di lavoro: [CHEMIN PROJET LOCAL ICI] - Interfaccia web locale desiderata: http://[ADRESSE IP LOCALE]:8787 - URL AnkiConnect: http://[ADRESSE IP ANKI CONNECT]:8765 - Add-on AnkiConnect: 2055492159 - reMarkable SSH user: root - reMarkable SSH port: 22 - reMarkable MAC: da tenere in .env.local, non nel prompt - Password SSH reMarkable: da tenere in .env.local, non nel prompt Regole di sicurezza ------------------ - Non chiedere i veri accessi nel prompt. - Non salvare mai la password reMarkable nel codice sorgente, README o note Markdown. - Crea un file .env.local git-ignore per i segreti locali. - Metti i veri accessi solo in .env.local, ad esempio: RM_REMARKABLE_MAC=[ADRESSE MAC ICI] RM_SSH_PASSWORD=[MOT DE PASSE SSH ICI] ANKI_CONNECT_URL=http://[ADRESSE IP ANKI CONNECT]:8765 - Non modificare mai i file sul reMarkable, salvo richiesta esplicita. - Usa SSH solo per leggere/copiare i dati dal reMarkable. - Non usare OCR. - Non usare API IA o token IA per estrarre gli highlight. - L'estrazione deve essere locale, deterministica e ripetibile. Obiettivo funzionale -------------------- Costruire uno strumento locale che: 1. scopra l'indirizzo IP attuale del reMarkable da RM_REMARKABLE_MAC, poiché il DHCP può cambiare l'IP; 2. elenchi i documenti PDF/EPUB disponibili sul reMarkable; 3. copi localmente i file necessari; 4. estragga gli highlight; 5. crei o aggiorni le carte Anki tramite AnkiConnect; 6. sincronizzi AnkiWeb dopo l'aggiornamento, salvo opzione di disattivazione. Estrazione degli highlight ------------------------- - Un'annotazione continua su più righe o pagine deve diventare un singolo highlight. - Se del testo sorgente non evidenziato si trova tra due frammenti, sono due highlight distinti. - Preserva l'ordine del documento: ordine delle pagine, poi ordine di apparizione sulla pagina. - Per i PDF/EPUB, preferisci il testo del documento sorgente quando disponibile; usa i dati .rm come ancore. - Per gli EPUB copiati da reMarkable, preferisci il PDF sidecar renderizzato per l'allineamento, poiché le pagine .rm corrispondono a questa paginazione. - La citazione/fronte non deve mai essere estesa per completare una parola o una frase. - Il retro può contenere contesto: esattamente una frase precedente non titolo + frase contenente l'highlight con l'highlight in grassetto + esattamente una frase successiva non titolo. Integrazione Anki ---------------- - Di default, crea un deck Anki per documento reMarkable, chiamato esattamente come il documento. - Crea una carta Anki per highlight. - Fronte: citazione/highlight esatto. - Retro: highlight in contesto quando disponibile. - Usa ID stabili in modo che le ripetizioni aggiornino le note esistenti e aggiungano solo i nuovi highlight. - Elimina le note Anki obsolete per lo stesso UUID di documento quando l'insieme stabile di highlight cambia. - Dopo la sincronizzazione locale Anki, riposiziona solo le nuove carte nell'ordine di apparizione del documento. - Non modificare la pianificazione delle carte già riviste/imparate. - Se AnkiConnect non è raggiungibile, avvia automaticamente Anki Desktop e attendi che la raccolta sia disponibile. - Dopo l'aggiornamento locale Anki, avvia automaticamente la sincronizzazione AnkiWeb, salvo opzione --no-sync-ankiweb. - Per documenti grandi, usa chiamate AnkiConnect in batch per evitare blocchi. Interfaccia web locale -------------------- Costruisci un'interfaccia web locale semplice ed efficace: - visualizzazione predefinita: gli ultimi 10 documenti PDF/EPUB; - scelta 10/20/30/tutti; - ricerca solo su Invio o clic sulla lente, non ad ogni battitura; - pulsante Aggiorna che rilancia la rilevazione/elenco e i retry SSH; - se il reMarkable è in sospensione, mostra un messaggio chiaro che chiede di riattivare il tablet e poi riprovare; - ordinamento: recente, nome A-Z, nome Z-A, PDF prima, EPUB prima; - multi-selezione di documenti; - pulsante "Seleziona tutto"; - i documenti selezionati devono rimanere visibili/fissati anche se una ricerca o un ordinamento li nasconderebbe; - l'esportazione multi-documento deve seguire l'ordine attualmente visualizzato, non l'ordine dei clic; - opzione aggiuntiva "Deck unico" disponibile solo se più file sono selezionati; - se "Deck unico" è attivato, invia tutti gli highlight selezionati in un unico deck Anki il cui nome è configurabile; - altrimenti mantieni un deck per documento; - mostra le fasi dell'esportazione in tempo reale; - mostra errori e log in tempo reale nell'interfaccia, senza rimanere bloccato su "running"; - in caso di errore, segna il documento corrente come error e mostra il messaggio utilizzabile. CLI prevista ------------ Prevedi anche una CLI: - --list per elencare i documenti; - --document per esportare un documento specifico; - --all per esportare tutti i documenti PDF/EPUB con highlight; - --no-anki per testare senza modificare Anki; - --no-sync-ankiweb per disabilitare la sincronizzazione AnkiWeb; - --single-deck e --single-deck-name per esportare più documenti in un unico deck; - --host per forzare un IP reMarkable se necessario; - --mac per forzare un MAC; - --no-discover per non fare la rilevazione tramite MAC. Consegne previste ------------------ - Codice sorgente completo. - README con comandi di installazione e utilizzo. - File di note di progetto Markdown che spiega decisioni e limiti. - .gitignore che esclude .env.local, cache, esportazioni temporanee e segreti. - Interfaccia web locale avviata su http://[ADRESSE IP LOCALE]:8787. - Test o controlli minimi che mostrino che: - l'estrazione non dipende da OCR; - gli highlight rimangono in ordine; - le ripetizioni non duplicano le carte; - gli errori web sono visibili nell'interfaccia. Vincoli importanti ----------------------- - Non mostrare mai i miei segreti nei log, README o risposte finali. - Se un segreto è necessario, usa un placeholder o una variabile d'ambiente. - Mantieni lo strumento locale, riproducibile e comprensibile. - Prima di concludere, verifica la sintassi, esegui i test disponibili, poi fornisci i comandi esatti per avviare l'interfaccia.
Prompt 2 – Estrazione reMarkable in file TXT
Copia e incolla il blocco qui sotto nel tuo strumento IA/di sviluppo. I placeholder tra parentesi quadre servono per mostrare dove questi valori verranno configurati localmente.
Sei un agente di sviluppo senior. Voglio che costruisca un'interfaccia web locale e una pipeline deterministica per estrarre i miei highlight reMarkable e salvarli in file .txt. Non voglio l'esportazione in Anki in questa versione.
Contesto locale da adattare
------------------------
- Cartella di lavoro: [PERCORSO PROGETTO LOCALE QUI]
- Interfaccia web locale desiderata: http://[INDIRIZZO IP LOCALE]:8787
- Utente SSH reMarkable: root
- Porta SSH reMarkable: 22
- MAC reMarkable: da tenere in .env.local, non nel prompt
- Password SSH reMarkable: da tenere in .env.local, non nel prompt
Regole di sicurezza
------------------
- Non chiedere i veri accessi nel prompt.
- Non memorizzare mai la password reMarkable nel codice sorgente, README o note Markdown.
- Crea un file .env.local git-ignore per i segreti locali.
- Metti i veri accessi solo in .env.local, per esempio:
RM_REMARKABLE_MAC=[INDIRIZZO MAC QUI]
RM_SSH_PASSWORD=[PASSWORD SSH QUI]
- Non modificare mai i file sul reMarkable, salvo esplicita richiesta.
- Usa SSH solo per leggere/copiare i dati dal reMarkable.
- Non usare OCR.
- Non usare API IA né token IA per estrarre gli highlight.
- L'estrazione deve essere locale, deterministica e ripetibile.
- Non mostrare mai i miei segreti nei log, README o risposte finali.
Obiettivo funzionale
--------------------
Costruire uno strumento locale che:
1. scopra l'indirizzo IP attuale del reMarkable a partire da RM_REMARKABLE_MAC, poiché DHCP può cambiare l'IP;
2. elenchi i documenti PDF/EPUB disponibili sul reMarkable;
3. copi localmente i file necessari;
4. estragga gli highlight;
5. scriva i risultati in file .txt locali.
Estrazione degli highlight
-------------------------
- Un'annotazione continua su più righe o pagine deve diventare un unico highlight.
- Se del testo sorgente non evidenziato si trova tra due frammenti, sono due highlight distinti.
- Preserva l'ordine del documento: ordine delle pagine, poi ordine di apparizione sulla pagina.
- Per PDF/EPUB, preferisci il testo del documento sorgente quando disponibile; usa i dati .rm come ancore.
- Per gli EPUB copiati dal reMarkable, preferisci il PDF sidecar renderizzato per l'allineamento, poiché le pagine .rm corrispondono a quella paginazione.
- La citazione estratta non deve mai essere estesa per completare una parola o una frase.
- Non dedurre testo con un'IA. Se un allineamento fallisce, segnalalo chiaramente nel journal.
Formato delle uscite .txt
-----------------------
Scrivi un file .txt per documento in una cartella locale, per esempio:
exports/remarkable_txt/[NOM_DU_DOCUMENT].txt
Ogni file deve contenere:
- titolo del documento;
- UUID del documento se disponibile;
- data di esportazione locale;
- numero totale di highlight;
- elenco degli highlight nell'ordine del documento.
Formato consigliato per ogni highlight:
---
Highlight 001
Pagina: [PAGINA SE DISPONIBILE]
Testo:
[TESTO ESATTO DELL'HIGHLIGHT]
---
Interfaccia web locale
--------------------
Costruisci un'interfaccia web locale semplice ed efficace:
- visualizzazione predefinita: gli ultimi 10 documenti PDF/EPUB;
- scelta 10/20/30/tutti;
- ricerca solo su Invio o clic sulla lente, non ad ogni battitura;
- pulsante Aggiorna che riavvia il rilevamento/elenco e i tentativi SSH;
- se il reMarkable è in sospensione, mostra un messaggio chiaro che chiede di riattivare il tablet e poi riprovare;
- ordinamento: recenti, nome A-Z, nome Z-A, PDF prima, EPUB prima;
- multi-selezione dei documenti;
- pulsante "Seleziona tutto";
- i documenti selezionati devono rimanere visibili/pinnati anche se una ricerca o un ordinamento li nasconderebbe;
- l'esportazione multi-documenti deve seguire l'ordine attualmente visualizzato, non l'ordine dei clic;
- pulsante "Esporta in TXT";
- mostrare il percorso dei file .txt prodotti;
- mostrare le fasi dell'esportazione in tempo reale;
- mostrare gli errori e il registro in tempo reale nell'interfaccia, senza rimanere bloccato su "running";
- in caso di errore, contrassegnare il documento corrente come error e mostrare il messaggio utilizzabile.
CLI prevista
------------
Prevedi anche una CLI:
- --list per elencare i documenti;
- --document per esportare un documento specifico;
- --all per esportare tutti i documenti PDF/EPUB con highlight;
- --output-dir per scegliere la cartella di output .txt;
- --host per forzare un IP reMarkable se necessario;
- --mac per forzare un MAC;
- --no-discover per non fare il rilevamento tramite MAC.
Consegne previste
------------------
- Codice sorgente completo.
- README con comandi di installazione e utilizzo.
- File di note di progetto in Markdown che spiega decisioni e limiti.
- .gitignore che esclude .env.local, cache, esportazioni temporanee e segreti.
- Interfaccia web locale avviata su http://[INDIRIZZO IP LOCALE]:8787.
- Test o controlli minimi che mostrano che:
- l'estrazione non dipende da OCR;
- gli highlight rimangono in ordine;
- i file .txt sono ricreabili senza duplicati;
- gli errori web sono visibili nell'interfaccia.
Vincoli importanti
-----------------------
- Non mostrare mai i miei segreti.
- Se un segreto è necessario, utilizza un placeholder o una variabile d'ambiente.
- Mantieni lo strumento locale, riproducibile e comprensibile.
- Prima di terminare, verifica la sintassi, esegui i test disponibili, poi fornisci i comandi esatti per avviare l'interfaccia ed esportare i file .txt.
