How ksandariv/zibaldone works
ZibaldOne is a local-first personal organizer for Windows and Android, with a shared Python core and CLI. The main workflow is to compose a template from blocks, fill it in through the interface, and store entries locally for later use; domain modules add areas, finance, habits, people, search, and related tools. Backups, encryption, privacy/anonymization, reminders, and optional cloud sync are important supporting capabilities. Some connections below are documented or indexed rather than visible in the sampled excerpts, so those are marked dashed.
Main entry points: ui/app.py Flet app · database.py SQLite store · backups.py Snapshots · cli/app.py CLI commands
Components 21
User interfaces
- Flet app
ZibaldOne/src/zibaldone/ui/app.py - Entry and views
ZibaldOne/src/zibaldone/ui/views/entry_form.py - CLI commands
ZibaldOne/src/zibaldone/cli/app.py
Personal tools
- Templates
ZibaldOne/src/zibaldone/core/templates.py - Entry blocks
ZibaldOne/src/zibaldone/core/blocks.py - Life areas
ZibaldOne/src/zibaldone/core/areas.py - Finance
ZibaldOne/src/zibaldone/core/finance.py - Habits
ZibaldOne/src/zibaldone/core/habits.py - People
ZibaldOne/src/zibaldone/core/people.py - Search
ZibaldOne/src/zibaldone/core/search.py - Statistics
ZibaldOne/src/zibaldone/core/stats.py
Local data
- SQLite store
ZibaldOne/src/zibaldone/storage/database.py - Settings
ZibaldOne/src/zibaldone/storage/settings.py
Privacy and backup
- Encryption
ZibaldOne/src/zibaldone/core/crypto.py - Anonymizer
ZibaldOne/src/zibaldone/core/anonymizer.py - Snapshots
ZibaldOne/src/zibaldone/storage/backups.py - Backup keys
ZibaldOne/src/zibaldone/storage/keys.py
Background services
- Cloud sync
ZibaldOne/src/zibaldone/cloud/sync.py - Reminder rules
ZibaldOne/src/zibaldone/core/reminders.py - Reminder delivery
ZibaldOne/src/zibaldone/notify/service.py
Other components
- User
Connections 26
- User → Flet app: uses
ZibaldOne/src/zibaldone/ui/app.py - User → CLI commands: uses
ZibaldOne/src/zibaldone/cli/app.py - Flet app → Entry and views: routes to
ZibaldOne/src/zibaldone/ui/app.py - Entry and views → SQLite store: reads and writes
ZibaldOne/src/zibaldone/ui/views/entry_form.py - Entry and views → Templates: uses
ZibaldOne/src/zibaldone/ui/views/entry_form.py - Templates → Entry blocks: defines
ZibaldOne/src/zibaldone/core/templates.py - SQLite store → Templates: uses
ZibaldOne/src/zibaldone/storage/database.py - SQLite store → Life areas: uses
ZibaldOne/src/zibaldone/storage/database.py - SQLite store → Search: uses
ZibaldOne/src/zibaldone/storage/database.py - SQLite store → Encryption: uses
ZibaldOne/src/zibaldone/storage/database.py - CLI commands → SQLite store: opens
ZibaldOne/src/zibaldone/cli/app.py - CLI commands → Snapshots: manages
- CLI commands → Encryption: uses
- Cloud sync → Snapshots: syncs snapshots
ZibaldOne/src/zibaldone/cloud/sync.py - Cloud sync → Encryption: uses
ZibaldOne/src/zibaldone/cloud/sync.py - Snapshots → Backup keys: uses
ZibaldOne/src/zibaldone/storage/backups.py - Snapshots → SQLite store: snapshots
ZibaldOne/src/zibaldone/storage/backups.py - Snapshots → Encryption: encrypts
ZibaldOne/src/zibaldone/storage/backups.py - Flet app → Settings: reads preferences
ZibaldOne/src/zibaldone/ui/app.py - Flet app → Anonymizer: offers privacy tools
- Flet app → Finance: offers finance tools
- Flet app → Habits: offers habit tools
- Flet app → People: offers people tools
- Flet app → Statistics: offers statistics
- Reminder delivery → Reminder rules: evaluates rules
ZibaldOne/src/zibaldone/notify/service.py - Flet app → Reminder delivery: runs reminder service