diff options
| author | gabrix73 <gabriel1@frozenstar.info> | 2026-06-03 02:59:08 +0200 |
|---|---|---|
| committer | gabrix73 <gabriel1@frozenstar.info> | 2026-06-03 02:59:08 +0200 |
| commit | c57567ad9a9863a4f13591539ed64f0217ce0e39 (patch) | |
| tree | 68361fba5dfdadb60b70674b9056528d06ca63cf | |
| parent | 34c79384d55c746aa64a795402218c2f08120947 (diff) | |
| download | neomutt-config-c57567ad9a9863a4f13591539ed64f0217ce0e39.tar.gz neomutt-config-c57567ad9a9863a4f13591539ed64f0217ce0e39.tar.xz neomutt-config-c57567ad9a9863a4f13591539ed64f0217ce0e39.zip | |
docs: clarify GnuPG default and YubiKey as optional for Usenet
- Added GnuPG as default signing method for regular email
- Clarified YubiKey PIV signing is optional (only for Usenet posts)
- Added three signing options: GnuPG (default), YubiKey (optional), none
- Updated requirements table with gnupg as required package
- Added clear instructions to disable YubiKey (change to vim) for users without hardware
- accounts/mail2news: added comment explaining how to switch to plain vim
Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
| -rw-r--r-- | README.md | 59 | ||||
| -rw-r--r-- | accounts/mail2news | 3 |
2 files changed, 43 insertions, 19 deletions
@@ -9,38 +9,53 @@ Full write-up: [Posting to Usenet Anonymously with NeoMutt and Mail2News over To ## Features - Multi-account IMAP/SMTP (STARTTLS, port 143/587) +- **GnuPG support** — PGP signing/encryption for regular email (configured in `neomuttrc.common`) - **Mail2news via Tor** — post to Usenet through a `.onion` SMTP gateway, no IP exposed -- **YubiKey PIV Ed25519 signatures** — automatic signing with hardware key (PGP-like clearsign format) +- **Optional YubiKey PIV Ed25519 signatures** — hardware-backed signing for Usenet posts (alternative to GnuPG) - F7/F9 macro → interactive post script (newsgroup, subject, editor, review, send) -- Ephemeral `.invalid` From address +- Ephemeral `.invalid` From address for anonymous posting - No IMAP for the mail2news account — send-only --- ## Requirements -| Package | Purpose | -|------------|-------------------------------| -| `neomutt` | MUA | -| `tor` | Tor daemon (127.0.0.1:9050) | -| `torsocks` | Tor proxy wrapper | -| `swaks` | SMTP test/send tool | -| `vim` | Message editor | -| `yubisigner-cli` | YubiKey PIV signing (optional) | +| Package | Purpose | Required | +|------------|-------------------------------|----------| +| `neomutt` | MUA | Yes | +| `gnupg` | PGP signing/encryption | Yes | +| `tor` | Tor daemon (127.0.0.1:9050) | For Usenet posting | +| `torsocks` | Tor proxy wrapper | For Usenet posting | +| `swaks` | SMTP test/send tool | Optional | +| `vim` | Message editor | Yes | +| `yubisigner-cli` | YubiKey PIV signing | Optional | On Arch: ```bash -pacman -S neomutt tor torsocks swaks +pacman -S neomutt gnupg tor torsocks vim ``` On Debian/Ubuntu: ```bash -apt install neomutt tor torsocks swaks +apt install neomutt gnupg tor torsocks vim ``` -### YubiKey signing (optional) +### Signing options -For automatic post signing with YubiKey PIV Ed25519: +**Option 1: GnuPG (default, recommended)** + +GnuPG is pre-configured in `neomuttrc.common`. Set your key ID: +```bash +# Edit ~/.config/neomutt/neomuttrc.common and set: +set pgp_sign_as = "0xYOURKEYID" +set pgp_default_key = "0xYOURKEYID" +``` + +NeoMutt will prompt for signing/encryption when composing messages. + +**Option 2: YubiKey PIV Ed25519 (optional, for Usenet posts)** + +For hardware-backed signatures on Usenet posts via mail2news: 1. Configure YubiKey PIV slot 9c with Ed25519 key (one-time setup) 2. Install [yubisigner-cli](https://git.virebent.art/virebent/yubisigner-cli): @@ -50,14 +65,22 @@ For automatic post signing with YubiKey PIV Ed25519: cd yubisigner-cli go build -o yubisigner-cli main.go ``` -3. Install `vim-yubisigner` wrapper from this repo: +3. Install signing scripts from this repo: ```bash mkdir -p ~/bin - cp scripts/vim-yubisigner ~/bin/vim-yubisigner - chmod +x ~/bin/vim-yubisigner + cp scripts/vim-yubisigner ~/bin/ + cp scripts/yubisigner-with-pinentry ~/bin/ + chmod +x ~/bin/vim-yubisigner ~/bin/yubisigner-with-pinentry ``` -The mail2news account is pre-configured to use `vim-yubisigner` as editor, which automatically signs messages with YubiKey after editing. +The `accounts/mail2news` file is pre-configured to use `vim-yubisigner`. If you don't have YubiKey, edit the file and change: +``` +set editor = "vim" +``` + +**Option 3: No signing** + +Comment out or remove GnuPG settings from `neomuttrc.common` and use plain vim for mail2news. --- diff --git a/accounts/mail2news b/accounts/mail2news index 89c71d9..8ec4867 100644 --- a/accounts/mail2news +++ b/accounts/mail2news @@ -18,7 +18,8 @@ set ssl_force_tls = no my_hdr X-Mailer: NeoMutt mail2news my_hdr X-PGP-Key: https://contact.virebent.art/.well-known/openpgpkey/gabvirebent.asc -# YubiSigner: Firma automatica con YubiKey PIV Ed25519 tramite editor wrapper +# Editor: usa vim-yubisigner per firma YubiKey (opzionale), altrimenti vim +# Se non hai YubiKey o yubisigner-cli, cambia in: set editor = "vim" set editor = "$HOME/Projects/neomutt-config/scripts/vim-yubisigner" color status black white |
