duras 1.0.6

plain-text daily notes with optional encryption

duras

Daily notes as plain text files, with search and optional encryption.

---

Install

pip install duras

Requires Python 3.13+. No dependencies. gpg optional for encrypted notes.

---

Quick start

duras               # open today's note in $EDITOR
duras append "fix login bug #todo"
duras search todo
duras tags

---

Model

One note per day:

YYYY/MM/YYYY-MM-DD.dn

• plain UTF-8 text
• filesystem is the index
• no database, no hidden state
• atomic writes

Encrypted note:

YYYY/MM/YYYY-MM-DD.dn.gpg

via the GNU Privacy Guard.

---

Scope

Fits:

• terminal-based workflows
• grep-based retrieval
• long-lived plain text notes
• optional encryption

Not a fit:

• sync system
• GUI / rich text editor
• query engine or database

---

Commands

open

duras               # today
duras open -1       # yesterday
duras open 2026-04-19
duras open -- +10   # pass +10 to $EDITOR (jump to line)

append

duras append "text"
duras append -d -1 "yesterday"
cat file | duras append -

- reads from stdin.

show

duras show
duras show -1

list / stats

duras list
duras list -n 0     # all notes
duras stats

Order: by filename (ISO date), not mtime.

search / tags

duras search error
duras search todo -i    # case-insensitive
duras tags              # all tags with counts
duras tags project      # notes containing #project

Literal match, not regex. Encrypted notes excluded.

export

duras export ~/backup
duras export ~/backup --encrypt

Creates a timestamped .tar.gz. --encrypt pipes through gpg; no plaintext archive is written.

other

duras path          # absolute path to today's note
duras dir           # notes root directory
duras today         # print today's date
duras audit         # validate directory structure
duras echo          # notes on this date in past years
duras near          # notes within ±3 days of today
duras mv 2026-04-17 2026-04-16

---

Encryption

duras -c open
duras -c append "secret"
duras -c show

• uses system gpg
• append -c is memory-only; no plaintext temp file
• open -c writes a temp file to /dev/shm when available

---

Dates

YYYY-MM-DD   absolute
0            today
-1           yesterday
-7           one week ago

Future dates are rejected.

---

Environment

variable	meaning
DURAS_DIR	notes directory (default: ~/Documents/Notes)
EDITOR	editor (fallback: nano, vi, ed)
DURAS_GPG_KEY	GPG recipient (default: self)

---

Exit codes

code	meaning
0	ok
1	error
2	not found
3	invalid input
4	external failure

---

Limits

• encrypted notes are not searchable
• depends on system gpg for encryption

---

Docs

• man duras
• https://codeberg.org/duras/duras

---

Variants

duras

Standard variant for Unix-like systems. Uses system gpg. No dependencies.

duras_ashell

For iOS a-Shell mini. Uses PGPy (pure Python) instead of system gpg. No external binaries. Handles .asc keys directly; no keyring. Compatible encrypted format.

---

License

ISC