A fast, private, and mouse/touch-friendly note-taking and checklist application built natively with Quickshell for Omarchy Linux, backed by a hardened Rust engine with AES-256-GCM Zero-Knowledge End-to-End Encryption and multi-cloud synchronization (Google Drive & Git).
Author: Ozan Özdil (ozdil)
License: MIT
Plugin ID: ozdil.omanotes
- Google Keep-Style Color Cards: Categorize and visually organize notes with vibrant pastel themes (Yellow, Green, Blue, Purple, Red, Teal).
- Interactive Checklists (To-Do): Native strikethrough checkboxes, instant item completion, and one-click removal of completed items.
- Mouse-First & Keyboardless Usability:
- One-click "Paste from Clipboard" button (via
wl-paste) creates cards instantly without typing. - One-click template buttons:
Groceries,Priorities,Idea. - Mouse-driven color-dot and status filter chips (
All,Pinned,Checklist, and color swatches). - Quick action bar on each card: Pin, Duplicate, Delete, and inline color palette.
- One-click "Paste from Clipboard" button (via
- Zero-Knowledge End-to-End Encryption (E2EE):
- All notes are encrypted client-side using Argon2id v2 KDF (RFC 9106, 64 MiB m_cost, 3 iterations, 1 lane), 16-byte random salt, 12-byte random nonce, and AES-256-GCM before ever leaving your machine (with backward compatibility for PBKDF2 v1 envelopes).
- Zero plaintext leakage in cloud storage or backups.
- Multi-Cloud Synchronization:
- Google Drive, Nextcloud, WebDAV: Seamless encrypted sync via
rclone. - Git Vault: Commit and push encrypted
notes.encsnapshots to any private Git repository. - Disaster Recovery: One-click cloud pull and decrypt (
--pull) to restore all notes onto a fresh system.
- Google Drive, Nextcloud, WebDAV: Seamless encrypted sync via
- Full Omarchy Design Language: Built using
qs.Commons,qs.Ui(Button,BorderSurface,KeyboardPanel,Style,Color).
- Rust & Cargo:
rustcandcargo(for local source compilation). - Quickshell: Native Wayland desktop shell (
quickshell). - Wayland Clipboard Utility:
wl-clipboard(for one-click clipboard capture). - Optional Cloud Providers:
rclone(for Google Drive / WebDAV / Nextcloud synchronization).git(for Git-based encrypted repository synchronization).
Under the Omarchy Linux Security Standards (AGENTS.md Rule 5.3), precompiled binaries are strictly forbidden from Git repositories to guarantee user system integrity. Therefore, the native engine must be compiled from source on your local machine after adding the plugin.
omarchy plugin add https://github.com/ozdil/omarchy-omanotes.gitNavigate to the plugin directory and compile the engine:
cd ~/.config/omarchy/plugins/ozdil.omanotes
cargo build --release --locked
install -m 755 target/release/omanotes-engine ./omanotes-engineAdd ozdil.omanotes to bar.layout.right in ~/.config/omarchy/shell.json:
{
"id": "ozdil.omanotes"
}omarchy-restart-shellOmaNotes provides a robust, zero-panic CLI engine for scripting, terminal usage, and desktop integrations:
# Display system status, note counts, and cloud sync status
omanotes-engine --status
# Add a note (JSON payload via stdin to prevent /proc/<pid>/cmdline leaks)
echo '{"title": "Meeting Notes", "content": "Discuss architecture and deployment", "color": "blue", "is_checklist": false, "tags": ["work"]}' | omanotes-engine --add
# Add a template note (shopping, daily, idea, reminder)
omanotes-engine --add-template daily
# Paste directly from Wayland clipboard
omanotes-engine --add-clipboard "yellow"
# Toggle pin on a note
omanotes-engine --toggle-pin <NOTE_ID>
# Toggle checklist item
omanotes-engine --toggle-check <NOTE_ID> <ITEM_ID>
# Set cloud synchronization provider (JSON payload via stdin)
echo '{"provider": "rclone", "rclone_remote": "gdrive:OmarchyNotes_Vault", "git_remote": "", "auto_sync": false}' | omanotes-engine --set-cloud
echo '{"provider": "git", "rclone_remote": "", "git_remote": "/path/to/private-vault-repo", "auto_sync": false}' | omanotes-engine --set-cloud
# Sync encrypted notes to configured cloud
echo "<E2EE_PASSWORD>" | omanotes-engine --sync
# Pull and decrypt notes from cloud (Disaster Recovery)
echo "<E2EE_PASSWORD>" | omanotes-engine --pullOmaNotes strictly adheres to the Omarchy Linux Security Architecture Standards:
- Subprocess Isolation: All external commands (
rclone,git,wl-paste) are executed in independent process groups (cmd.process_group(0)), with non-blocking I/O (O_NONBLOCK), bounded polling (poll()), and absolute monotonic deadlines (Instant::now() >= deadline). - Process Group Reaping: If a subprocess times out or crashes,
SIGTERMis sent followed by immediateSIGKILL(5-10ms) to clean up all background grandchild processes. - Storage Security (0600 & 0700):
- User notes and configuration are saved to
~/.local/share/omanotes/notes.jsonand~/.local/state/omanotes/config.json. - Files are written atomically using temporary files (
.tmp_*), synced to disk (sync_all()), and created with explicit POSIX mode0600permissions. - Symlinks and foreign UIDs are strictly rejected before reading or writing.
- User notes and configuration are saved to
- Bounded Cloud Restore & Storage Reads:
- Cloud restore downloads exclusively into a private temporary staging file (
.tmp_cloud_restore_*) enforcing a strict 10 MiB ciphertext ceiling (--max-size 10Mand--flag delimiter). - In case of overflow, timeout, or error, the staging file is immediately aborted and unlinked via RAII guard before publication.
- Staged payloads are validated for structure and envelope integrity before atomic rename over
notes.enc. - All storage reads enforce descriptor-bound
fstatchecks, a strict 10 MiB ceiling, andtake(MAX + 1)bounded streaming with explicit oversize rejection.
- Cloud restore downloads exclusively into a private temporary staging file (
- QML UI Hardening:
- All user, system, and clipboard strings are rendered with
textFormat: Text.PlainTextto prevent HTML, CSS, or script injection. - Zero dynamic code evaluation (
eval(),createQmlObject()).
- All user, system, and clipboard strings are rendered with
- Git Argument Injection Prevention:
- Git commands utilize discrete argument slices with
--delimiters and-C <path>canonical paths.GIT_TERMINAL_PROMPT=0prevents hanging prompts.
- Git commands utilize discrete argument slices with
If you find OmaNotes useful and want to support independent Linux development:
MIT License. See LICENSE for details.

