diff options
| author | Danilo M. <danix@danix.xyz> | 2026-11-06 10:52:41 +0100 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-11-06 10:52:41 +0100 |
| commit | 67168fdda80b84ff0d7317548960255c0a72a046 (patch) | |
| tree | b84d4d46681b2758f8cc146837ac3c736f36fe9e | |
| parent | afa0e5edda3c6d8097d7364a600e58eeded08938 (diff) | |
| download | danixxyz-67168fdda80b84ff0d7317548960255c0a72a046.tar.gz danixxyz-67168fdda80b84ff0d7317548960255c0a72a046.zip | |
content: document HardenedPass 0.3.3 and the About screen
Cover the Push after each change setting, Export log and how to send a log with a bug report, what logs can contain, and the About screen added in 0.3.1.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
8 files changed, 106 insertions, 4 deletions
diff --git a/content/en/hardenedpass/reference/security/index.md b/content/en/hardenedpass/reference/security/index.md index 31b7085..4efbb46 100644 --- a/content/en/hardenedpass/reference/security/index.md +++ b/content/en/hardenedpass/reference/security/index.md @@ -26,6 +26,10 @@ by the app that uses them. - **No telemetry.** No analytics, no crash reports, no Google Play Services. The app only connects to the git server you configured, and to your proxy if you set one. +- **Keeps logs on the phone.** Nothing is sent anywhere. **Export log** writes a file only + when you ask, to the place you choose. The app does not log passwords or keys, but the + file can show entry names, websites, apps and your git server, so read it before sharing + it. - **Blocks screenshots of secrets.** Entries, the editor, the generator, passphrase dialogs and autofill windows cannot be captured by screenshots, and do not appear in the recent apps view. diff --git a/content/en/hardenedpass/reference/settings/index.md b/content/en/hardenedpass/reference/settings/index.md index b97e2de..8c1cb7d 100644 --- a/content/en/hardenedpass/reference/settings/index.md +++ b/content/en/hardenedpass/reference/settings/index.md @@ -44,6 +44,7 @@ screen. Settings are grouped in six sections. | Setting | What it does | Default | |---|---|---| | **Rebase on pull** | On, your local commits go on top of the server's. Off, a merge commit is made instead. | On | +| **Push after each change** | Pushes after saving, moving or deleting in the app. See [Sync]({{< relref "/hardenedpass/using/sync" >}}). | Off | | **Edit Git server settings** | Changes the repository URL and how you log in. | - | | **HTTP(S) proxy settings** | Sets a proxy. Shown for HTTPS remotes only. | - | | **Local Git config & utilities** | Commit name and email, commit log, and the recovery tools described in [Sync]({{< relref "/hardenedpass/using/sync" >}}). | - | @@ -59,6 +60,7 @@ screen. Settings are grouped in six sections. | **Export passwords** | Copies the store, still encrypted, to a folder you choose. | - | | **Workaround clipboard history feature** | On phones with a clipboard history, fills it with numbers to push passwords out. | Off | | **Debug logging** | Turns on debug logs, after an app restart. Release builds only. | Off | +| **Export log** | Saves the app's logs to a file you choose, for a bug report. See [Troubleshooting]({{< relref "/hardenedpass/reference/troubleshooting" >}}). | - | ## PGP settings @@ -68,3 +70,16 @@ screen. Settings are grouped in six sections. | **Encrypt in ASCII armor mode** | Writes entries as text instead of binary. Leave it off unless you know you need it. | Off | | **Enable passphrase caching** | Remembers the key's passphrase, so that entries open without asking. Experimental, and needs an active screen lock. | Off | | **Automatically clear passphrase cache** | Forgets the passphrase when the screen turns off. | On | + +## About + +**About** is not in Settings: open it from the three dots in the list's search bar. It +shows: + +- The version. Tap it to copy it, for a bug report. +- Links to the documentation, what's new, the source code, the issue tracker and Ko-fi. + They open in your browser. +- The privacy statement. +- The signing certificate of the copy you have installed. Tap it to copy it, and compare + it with the one in [Install]({{< relref "/hardenedpass/getting-started/install" >}}). +- The license, and the licenses of the open source libraries in the app. diff --git a/content/en/hardenedpass/reference/troubleshooting/index.md b/content/en/hardenedpass/reference/troubleshooting/index.md index c55d141..645370f 100644 --- a/content/en/hardenedpass/reference/troubleshooting/index.md +++ b/content/en/hardenedpass/reference/troubleshooting/index.md @@ -78,4 +78,17 @@ windows, and the app has a workaround: update to the latest version. ## Still stuck? Open an issue on the [tracker](https://github.com/danixland/HardenedPass/issues). Say -which version you run and what you did. Never paste passwords, keys or real entry names. +which version you run (**About** shows it) and what you did. Never paste passwords, keys +or real entry names. + +A log helps a lot: + +1. In **Settings**, then **Misc**, turn on **Debug logging** and restart the app. +2. Do what goes wrong. +3. Tap **Export log** in the same place and choose where to save the file. Do this soon, + and before restarting the phone: Android keeps only recent lines. +4. Turn **Debug logging** off again. +5. Read the file and remove what you do not want public, then attach it to the issue. + +The file can show entry names, websites, apps and your git server. Crashes are in it +even with **Debug logging** off. diff --git a/content/en/hardenedpass/using/sync/index.md b/content/en/hardenedpass/using/sync/index.md index c39f071..081c5c4 100644 --- a/content/en/hardenedpass/using/sync/index.md +++ b/content/en/hardenedpass/using/sync/index.md @@ -8,7 +8,8 @@ draft = false Every change you make in the app, such as a new entry, an edit or a delete, is committed to git on the phone straight away. **Nothing is sent to the server until you -sync.** Until then, the change exists only on this phone. +sync**, unless you turn on [Push after each change](#push-after-each-change). Until then, +the change exists only on this phone. ## Sync @@ -25,6 +26,24 @@ Synchronize is what you want almost every time. To turn the gesture off, use **Disable pull to sync action** in [Settings]({{< relref "/hardenedpass/reference/settings" >}}). +## Push after each change + +Turn on **Push after each change** in **Settings**, then **Repository**, and every new +entry, edit, move, rename or delete made in the app is pushed right away. This keeps the +server up to date, so a change on a computer is less likely to collide with one waiting +on the phone. It is off by default. + +Three things to know: + +- Entries saved through autofill are not pushed. They stay on the phone until the next + push or sync. +- It only sends. To get the server's changes you still need to sync. +- If your SSH key is protected by the screen lock, the app asks for it at every change. + +If the push fails, for example with no network or when the server has newer changes, the +app shows `Saved on this device, but not pushed. Sync to try again`. Your change is safe +in a local commit: sync when you can. + ## When two devices change the same thing If you edit the same entry on the phone and on a computer before syncing, git cannot diff --git a/content/it/hardenedpass/reference/security/index.md b/content/it/hardenedpass/reference/security/index.md index 9faf164..a19327f 100644 --- a/content/it/hardenedpass/reference/security/index.md +++ b/content/it/hardenedpass/reference/security/index.md @@ -27,6 +27,9 @@ telefono, nemmeno dall'app che le usa. - **Nessuna telemetria.** Niente analytics, niente report di crash, niente Google Play Services. L'app si collega solo al server git che hai configurato, e al proxy se ne hai impostato uno. +- **Tiene i log sul telefono.** Non viene inviato nulla. **Esporta log** scrive un file solo + quando lo chiedi, nel posto che scegli. L'app non registra password o chiavi, ma il file + può mostrare nomi di voci, siti, app e il tuo server git: leggilo prima di condividerlo. - **Blocca gli screenshot dei segreti.** Voci, editor, generatore, finestre della passphrase e finestre della compilazione automatica non si possono catturare con uno screenshot e non appaiono tra le app recenti. diff --git a/content/it/hardenedpass/reference/settings/index.md b/content/it/hardenedpass/reference/settings/index.md index 7866eb1..b673d47 100644 --- a/content/it/hardenedpass/reference/settings/index.md +++ b/content/it/hardenedpass/reference/settings/index.md @@ -44,6 +44,7 @@ schermata di benvenuto. Le impostazioni sono divise in sei sezioni. | Impostazione | Cosa fa | Predefinito | |---|---|---| | **Rebase al pull** | Attivo, i tuoi commit locali vanno sopra quelli del server. Spento, viene creato un merge commit. | Attivo | +| **Push dopo ogni modifica** | Esegue il push dopo aver salvato, spostato o eliminato nell'app. Vedi [Sincronizzazione]({{< relref "/hardenedpass/using/sync" >}}). | Spento | | **Modifica impostazioni del server di Git** | Cambia l'URL del repository e il modo di accedere. | - | | **Impostazioni proxy HTTP(S)** | Imposta un proxy. Appare solo per i remote HTTPS. | - | | **Configurazione Git locale e utilità** | Nome ed email dei commit, cronologia e gli strumenti di recupero descritti in [Sincronizzazione]({{< relref "/hardenedpass/using/sync" >}}). | - | @@ -59,6 +60,7 @@ schermata di benvenuto. Le impostazioni sono divise in sei sezioni. | **Esporta password** | Copia l'archivio, sempre cifrato, in una cartella a tua scelta. | - | | **Aggira la cronologia degli appunti** | Sui telefoni con una cronologia degli appunti, la riempie di numeri per farne uscire le password. | Spento | | **Registrazione di debug** | Attiva i log di debug, dopo un riavvio dell'app. Solo nelle build di release. | Spento | +| **Esporta log** | Salva in un file a tua scelta i log dell'app, per segnalare un problema. Vedi [Risoluzione dei problemi]({{< relref "/hardenedpass/reference/troubleshooting" >}}). | - | ## Impostazioni PGP @@ -68,3 +70,16 @@ schermata di benvenuto. Le impostazioni sono divise in sei sezioni. | **Cifra in formato ASCII armor** | Scrive le voci come testo invece che in binario. Lascialo spento se non sai di averne bisogno. | Spento | | **Memorizza le frasi segrete** | Ricorda la passphrase della chiave, così le voci si aprono senza chiederla. Sperimentale, e richiede un blocco schermo attivo. | Spento | | **Cancella automaticamente le frasi segrete memorizzate** | Dimentica la passphrase allo spegnimento dello schermo. | Attivo | + +## Informazioni + +**Informazioni** non è nelle Impostazioni: si apre dai tre puntini nella barra di ricerca +dell'elenco. Mostra: + +- La versione. Toccala per copiarla, per una segnalazione. +- I link alla documentazione, alle novità, al codice sorgente, al tracker delle + segnalazioni e a Ko-fi. Si aprono nel browser. +- La dichiarazione sulla privacy. +- Il certificato di firma della copia installata. Toccalo per copiarlo, e confrontalo con + quello in [Installazione]({{< relref "/hardenedpass/getting-started/install" >}}). +- La licenza, e le licenze delle librerie open source presenti nell'app. diff --git a/content/it/hardenedpass/reference/troubleshooting/index.md b/content/it/hardenedpass/reference/troubleshooting/index.md index fde8013..f6e5dd7 100644 --- a/content/it/hardenedpass/reference/troubleshooting/index.md +++ b/content/it/hardenedpass/reference/troubleshooting/index.md @@ -83,4 +83,17 @@ in background, e l'app ha un rimedio: aggiorna all'ultima versione. ## Ancora bloccato? Apri una segnalazione sul [tracker](https://github.com/danixland/HardenedPass/issues). Indica -quale versione usi e cosa hai fatto. Non incollare mai password, chiavi o nomi di voci reali. +quale versione usi (la trovi in **Informazioni**) e cosa hai fatto. Non incollare mai +password, chiavi o nomi di voci reali. + +Un log aiuta molto: + +1. In **Impostazioni**, poi **Varie**, attiva **Registrazione di debug** e riavvia l'app. +2. Ripeti l'operazione che non funziona. +3. Tocca **Esporta log** nello stesso punto e scegli dove salvare il file. Fallo subito, e + prima di riavviare il telefono: Android conserva solo le righe recenti. +4. Spegni di nuovo **Registrazione di debug**. +5. Leggi il file e togli ciò che non vuoi rendere pubblico, poi allegalo alla segnalazione. + +Il file può mostrare nomi di voci, siti, app e il tuo server git. I crash sono inclusi +anche con **Registrazione di debug** spenta. diff --git a/content/it/hardenedpass/using/sync/index.md b/content/it/hardenedpass/using/sync/index.md index 4a71cab..34e03bd 100644 --- a/content/it/hardenedpass/using/sync/index.md +++ b/content/it/hardenedpass/using/sync/index.md @@ -8,7 +8,9 @@ draft = false Ogni modifica che fai nell'app, come una nuova voce, una correzione o un'eliminazione, viene subito registrata con un commit git sul telefono. **Al server non arriva nulla -finché non sincronizzi.** Fino ad allora, la modifica esiste solo su questo telefono. +finché non sincronizzi**, a meno che tu non attivi +[Push dopo ogni modifica](#push-dopo-ogni-modifica). Fino ad allora, la modifica esiste +solo su questo telefono. ## Sincronizza @@ -25,6 +27,24 @@ Quasi sempre vuoi Sincronizza. Per disattivare il gesto, usa **Disattiva la sincronizzazione trascinando** nelle [Impostazioni]({{< relref "/hardenedpass/reference/settings" >}}). +## Push dopo ogni modifica + +Attiva **Push dopo ogni modifica** in **Impostazioni**, poi **Repository**, e ogni nuova +voce, correzione, spostamento, rinomina o eliminazione fatta nell'app viene inviata +subito. Così il server resta aggiornato, ed è meno probabile che una modifica fatta da un +computer entri in conflitto con una rimasta sul telefono. Di base è spento. + +Tre cose da sapere: + +- Le voci salvate con la compilazione automatica non vengono inviate. Restano sul + telefono fino al push o alla sincronizzazione successivi. +- Invia soltanto. Per ricevere le modifiche del server devi comunque sincronizzare. +- Se la chiave SSH è protetta dal blocco schermo, l'app la chiede a ogni modifica. + +Se il push non riesce, per esempio senza rete o quando il server ha modifiche più recenti, +l'app mostra `Salvato sul dispositivo, ma push non riuscito. Sincronizza per riprovare`. La +tua modifica è al sicuro in un commit locale: sincronizza appena puoi. + ## Quando due dispositivi cambiano la stessa cosa Se modifichi la stessa voce sul telefono e su un computer prima di sincronizzare, git non |
