Jotter
🚀 Try the Online Demo: simon123h.github.io/Jotter/demo/
Jotter is a local-first, privacy-focused task management web 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
🌟 Key Features
- 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.
- Model Context Protocol (MCP) Support: Connect AI assistants directly to your local Kanban board via
jotter mcp. - 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.
📦 Quick Start
Option 1: Run directly with pipx (Recommended for Python users)
No cloning or Node.js required—just Python:
pipx run jotter-app
Or install globally in an isolated environment:
pipx install jotter-app
jotter
Option 2: Standalone Executable (Zero Python Required)
Download the pre-compiled jotter-server executable from GitHub Releases for Windows, Linux, or macOS. No runtime or build tools needed.
Option 3: Run from Source
- Clone the repository:
git clone https://github.com/simon123h/jotter.git cd jotter
- Install dependencies:
pip install -e .
- Start the server:
jotter # or: python3 run.py
Open your browser at http://localhost:58271.
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.
🛠️ Development & Testing
# Install frontend and backend dependencies
npm run install:all
# Run backend and frontend dev servers concurrently
npm run dev
# Run all test suites (Pytest + Vitest)
npm run test
# Run frontend E2E browser tests (Playwright)
cd frontend && npx playwright test
📖 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:
- Developer Reference:
- Architectural Design (arc42)
- API Documentation (Interactive OpenAPI/Swagger) (Available when running the server)
- Contributing Guidelines
1 maintainer
Metadata
1 maintainer
Release files for jotter-app 3.7.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jotter_app-3.7.4.tar.gz | 1.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jotter_app-3.7.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.8 MB
Release files / jotter_app-3.7.4.tar.gz
| Download URL | jotter_app-3.7.4.tar.gz |
|---|---|
| Size | 1.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
85cca868e6322a5f6e27725d0c9840672de1c353fcd71785d09fd605693813b4
|
|
BLAKE2b-256 checksum How to use checksums |
e0f5ce826175e683e954002eb7ed319fe7c1032772ee3613c5ad4c20d5e681f5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / jotter_app-3.7.4-py3-none-any.whl
| Download URL | jotter_app-3.7.4-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
74bdacaa357327bd2ced6f8ae59d3929c65a0d6ef89c5929f37ff7d28e4aa7b7
|
|
BLAKE2b-256 checksum How to use checksums |
6dc66fdbe9de32f4c9c65430d7799fdbea6abcdd1bc2b09e5f8edfafa3df3628
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency log
