How dtnprt/todo.txt works
todo.txt is a task manager delivered as a browser app, a Tauri desktop app, and a Rust terminal app, all centered on plain todo.txt files. Users enter or select tasks, then parse, filter, edit, and save them; the terminal also exposes scripted commands. Supporting branches cover folder and note files, optional Git/WebDAV sync, encryption and offline caching, backups, and GUI themes. The source index and excerpts establish the listed calls; some unsampled feature wiring is documented in the README, so uncertain links are omitted.
Main entry points: app.js Browser app · main.rs Todo CLI · tui.rs Terminal interface · store.rs File storage
Components 24
Web client
- Browser app
web/app.js - Task composer
web/composer.js - Task format
web/todotxt.js - Date calendar
web/calendar.js - Web encryption
web/crypt.js - WebDAV client
web/webdav.js - Paste handling
web/paste.js - Android bridge
web/android.js - GUI themes
themes
Terminal client
- Todo CLI
cli/src/main.rs - Terminal interface
cli/src/tui.rs - Input handling
cli/src/input.rs - List and filters
cli/src/list.rs - Task operations
cli/src/ops.rs - Task format
cli/src/todotxt.rs
Storage and sync
- Folders and notes
cli/src/folder.rs - File storage
cli/src/store.rs - Encryption
cli/src/crypt.rs - WebDAV cache
cli/src/davcache.rs - WebDAV backend
cli/src/webdav.rs - Git sync
cli/src/git.rs - Backup
cli/src/backup.rs
Desktop integration
- Tauri wrapper
src-tauri/src/lib.rs
Other components
- User
Connections 32
- User → Browser app: uses
README.md - User → Todo CLI: runs
README.md - Browser app → Task composer: uses
web/app.js - Browser app → Task format: uses
web/app.js - Browser app → Web encryption: uses
web/app.js - Browser app → WebDAV client: uses
web/app.js - Browser app → Paste handling: uses
web/app.js - Browser app → Date calendar: uses
web/app.js - Browser app → Android bridge: uses
web/app.js - Task composer → Task format: parses tasks
web/composer.js - Task composer → Date calendar: builds picker
web/composer.js - Todo CLI → Terminal interface: launches
cli/src/main.rs - Todo CLI → Task format: uses
cli/src/main.rs - Todo CLI → File storage: loads and saves
cli/src/main.rs - Todo CLI → Folders and notes: uses
cli/src/main.rs - Todo CLI → Git sync: syncs with
cli/src/main.rs - Todo CLI → Backup: backs up
cli/src/main.rs - Terminal interface → File storage: loads
cli/src/tui.rs - Terminal interface → Git sync: starts sync
cli/src/tui.rs - Terminal interface → Folders and notes: switches folders
cli/src/tui.rs - Terminal interface → Input handling: handles input
cli/src/tui.rs - Terminal interface → List and filters: renders list
cli/src/tui.rs - File storage → Encryption: decrypts files
cli/src/store.rs - File storage → WebDAV cache: reads and writes
cli/src/store.rs - File storage → WebDAV backend: selects server
cli/src/store.rs - WebDAV cache → WebDAV backend: fetches and uploads
cli/src/davcache.rs - Folders and notes → File storage: resolves storage
cli/src/folder.rs - Folders and notes → WebDAV backend: reads remote notes
cli/src/folder.rs - Folders and notes → Encryption: uses encryption
cli/src/folder.rs - Tauri wrapper → Browser app: hosts app
README.md - Browser app → Tauri wrapper: invokes native commands
web/app.js - Browser app → GUI themes: offers themes
README.md