summaryrefslogtreecommitdiffstats
path: root/content
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-11-06 10:52:41 +0100
committerDanilo M. <danix@danix.xyz>2026-11-06 10:52:41 +0100
commit67168fdda80b84ff0d7317548960255c0a72a046 (patch)
treeb84d4d46681b2758f8cc146837ac3c736f36fe9e /content
parentafa0e5edda3c6d8097d7364a600e58eeded08938 (diff)
downloaddanixxyz-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>
Diffstat (limited to 'content')
-rw-r--r--content/en/hardenedpass/reference/security/index.md4
-rw-r--r--content/en/hardenedpass/reference/settings/index.md15
-rw-r--r--content/en/hardenedpass/reference/troubleshooting/index.md15
-rw-r--r--content/en/hardenedpass/using/sync/index.md21
-rw-r--r--content/it/hardenedpass/reference/security/index.md3
-rw-r--r--content/it/hardenedpass/reference/settings/index.md15
-rw-r--r--content/it/hardenedpass/reference/troubleshooting/index.md15
-rw-r--r--content/it/hardenedpass/using/sync/index.md22
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