🚀 Try the Online Demo: simon123h.github.io/Jotter/demo/
Jotter is a local-first, privacy-focused task management application designed to help you organize tasks without losing data ownership. Modeled as a Markdown Kanban board, Jotter helps combat "task flooding" through filtering, intuitive UI, all while keeping your data stored locally in simple, plain-text files on your own machine. The integrated git support allows for syncing the tasks across devices.
Documentation: simon123h.github.io/Jotter
- Data Ownership & Portability: Tasks are stored as human-readable
.mdmarkdown files. Your data remains yours, fully accessible even if you stop using Jotter. - Combat Task Flooding: Built for dealing with hundreds of open tasks.
- Flexible Views: Organise tasks your way with Kanban columns, list view, a priority-based Eisenhower Matrix, and a chronological Time View grouping by due dates.
- Smart Task Creation: Create rich tasks quickly with keywords for tags, due dates or priorities in the task title.
- Offline-First & Local Index: Runs entirely on your computer with a lightning-fast local SQLite database index. If the database index is ever deleted, the system automatically rebuilds it instantly from your markdown files.
- Selective Per-Project Git Sync: Enable synchronization for individual projects by connecting them to different Git remotes. Keep "Home" local while sharing "Work" with a team.
- Git-Backed Time Machine: Roll your workspace or individual projects back to any historical snapshot in your Git history using a dedicated, searchable, and spacious dialog. Automatically creates pre-restore backup commits so you can revert any rollback operation at any time.
- Multi-Language Support: Fully localized in English and German.
- Excel & CSV Import & Export: Seamlessly import tasks, checklists, priorities, and custom columns from any standard Excel or CSV spreadsheet with support for sheet auto-detection, interactive previews, and custom mappings. Export all tasks from your current filtered view as
.xlsxor.csvclient-side.
Jotter is provided as a portable tool with two distinct versions. No dependencies required.
-
Download the package for your operating system from the Latest Releases.
-
Extract the archive.
-
Choose your preferred way to run Jotter:
- Standalone Desktop App: Double-click
jotter-desktop(or.exeon Windows). This opens Jotter in its own dedicated window. - Headless Server: Run
jotter-serverfrom your terminal. This starts a web server (default:http://localhost:58271) that you can access with your preferred browser. (On Linux, double-clicking this binary will automatically open a terminal).
Example (Linux / macOS terminal):
chmod +x jotter-* ./jotter-desktop - Standalone Desktop App: Double-click
Jotter automatically handles both portable and global configurations out of the box:
- Portable Mode (Self-Contained): If a
tasks/directory is present in the folder you execute Jotter from, tasks will default to./tasksand configurations to./jotter.yamlin that folder. - Global / Installed Mode: Otherwise, Jotter uses standard OS-specific directories for both data and settings storage (such as XDG standard paths on Linux, AppData on Windows, and Application Support on macOS).
- Auto-Config Generation: If no configuration file exists at all on startup, Jotter will automatically create a default, annotated
jotter.yamltemplate file for you at the default location.
For advanced customization and full directory details, please see the user configuration documentation.
The complete documentation is available at simon123h.github.io/Jotter/.
Alternatively, you can refer to the raw Markdown source files in the docs/ folder:
- User Guide & Setup:
- Installation:
- Developer Reference:
- Architectural Design (arc42)
- API Documentation (Swagger UI) (Only available when running the backend headless server)
- Contributing Guidelines