jm-tech-power-official/Inkdrop
Inkdrop — encrypted notes on your desktop. A two-pane notebook sealed with authenticated encryption (PBKDF2-SHA256 + SHA-256-CTR + HMAC-SHA256), with one-click sync to your JMDrive. Built with Qt (PySide6).
Inkdrop — encrypted notes, desktop app
A polished desktop app for encrypted notes, built with PySide6.
Category: Notes · Version 1.0.0 · Supports Windows · macOS (Linux works too)
Every note body is encrypted on disk. Titles are kept in a small unencrypted index so the sidebar loads instantly; your passphrase is never stored — it is requested with a hidden-echo dialog and cached in memory for the session only.
What it looks like
A clean two-pane window with a green accent:
- Left sidebar — your notes, each showing its title and last-modified date.
- Right pane — the editor: a title field and a body text area.
- Toolbar — New, Save (Ctrl+S), Delete, and Sync.
The passphrase is asked for once (hidden echo) on your first save and when opening an encrypted note, then reused for the rest of the session. A wrong passphrase or a tampered note produces a clear error dialog and clears the cached passphrase so you can try again.
Install
Requires Python 3 (the installers check for it and tell you how to get it). Each install gets its own isolated virtualenv with PySide6 — it will not disturb any other Python on your machine, and it never touches your notes.
macOS (works on Linux too) — user-local, no sudo:
./install.sh
Windows — in PowerShell (from the unzipped folder):
.\install.ps1
install.sh creates a venv in ~/.local/share/inkdrop-app, installs PySide6, drops a launcher at ~/.local/bin/inkdrop, and (on Linux) adds a .desktop entry. install.ps1 creates a venv in %LOCALAPPDATA%\Programs\inkdrop, adds an inkdrop.cmd wrapper, and puts it on your PATH.
Then just launch:
inkdrop
Command-line flags
inkdrop # launch the desktop app inkdrop --version # prints: inkdrop 1.0.0 (does not import PySide6) inkdrop --selftest # build the GUI offscreen, process events, exit 0 inkdrop --crypto-selftest # prove the encrypt/decrypt + integrity check (no Qt) inkdrop --help
Where notes live
~/.local/share/inkdrop/ (honors $XDG_DATA_HOME) index.json unencrypted metadata: id, title, mtime <id>.note one encrypted note (base64)
Note that the app itself installs to a different folder (~/.local/share/inkdrop-app) so reinstalling or uninstalling never risks your notes.
Sync to JMDrive
The Sync button shells out to the jm CLI, running jm drive cp <notefile> jm:/inkdrop/ for each .note. Only the already-encrypted files leave your machine. If jm is not on your PATH, Inkdrop shows a dialog pointing you to the CLI at /cli.
How the encryption works
A legitimate standard-library construction using PBKDF2-SHA256 + SHA-256 counter-mode (CTR) + HMAC-SHA256 — it does not call a system AES library.
- Key derivation:
hashlib.pbkdf2_hmac('sha256', passphrase, salt, 200000)
with a fresh 16-byte random salt per note (os.urandom), yielding a 32-byte key.
- Cipher: a SHA-256 counter-mode keystream. Keystream block i is
sha256(key + nonce + i.to_bytes(8,'big')), XORed against the plaintext, with a fresh 16-byte random nonce per note.
- Integrity (encrypt-then-MAC):
HMAC-SHA256(key, salt+nonce+ciphertext).
On open, the tag is verified in constant time (hmac.compare_digest) before anything is decrypted; a mismatch means wrong passphrase or corrupted note.
- On-disk format: base64 of
salt(16) || nonce(16) || tag(32) || ciphertext.
Because the passphrase is never stored, a forgotten passphrase means the note cannot be recovered.
Uninstall
./uninstall.sh # macOS / Linux .\uninstall.ps1 # Windows
Uninstalling removes the app install (venv + code), the launcher, and the desktop entry, but leaves your notes in ~/.local/share/inkdrop/ — delete that folder yourself if you want them gone.