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 and an intuitive UI, all while storing your data locally in Open Knowledge Format (OKF) compliant plain-text Markdown files. The integrated git support allows for syncing tasks seamlessly across devices.
Documentation: simon123h.github.io/Jotter
🌟 Key Features
- Your data stays yours: Tasks are human-readable Markdown files in the Open Knowledge Format (OKF), one folder per project. They stay accessible without Jotter, and project folders work inside an Obsidian or other PKM vault.
- Built for hundreds of open tasks: Kanban columns, list view, an Eisenhower Matrix and a time view, plus a search language and filters to fight task flooding. Dates, tags and priorities go straight into the task title.
- Local-first and fast: Runs entirely on your computer. A local SQLite index is rebuilt from your files whenever it is missing.
- Git history: If your vault is a Git repository, Jotter commits your changes locally and can restore any project or the whole workspace from the history. Pushing and pulling stay in your hands, as does any file sync tool.
- Android app: A lean, touch-first app with the core of the desktop app, fully offline on local Markdown files. Sync with your desktop via Syncthing, Git or a cloud drive.
- AI-ready and multilingual: Connect AI assistants through the Model Context Protocol (
jotter mcp, optional:pipx install 'jotter-app[mcp]'). English and German.
📦 Quick Start
Option 1: Run directly with pipx (Recommended for Desktop/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: Android Mobile App (.apk)
Download the signed jotter-*-android.apk from GitHub Releases and install it on your Android phone. No server or internet connection required. Point it to your synced Markdown folder (via Syncthing, Git, etc.) for cross-device synchronization.
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 works out of the box with these defaults:
- Config and default vault: Jotter uses standard OS-specific directories (XDG standard paths on Linux, AppData on Windows, Application Support on macOS). A
./jotter.yamlin the folder you start Jotter from takes precedence over the global one. - 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 the dependencies of the backend, the apps and the shared packages
npm run install:all
# Run the backend and the web dev servers concurrently
npm run dev
# Run all test suites (Pytest + Vitest)
npm run test
# Run the web app's E2E browser tests (Playwright)
cd apps/web && 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 4.19.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| jotter_app-4.19.0.tar.gz | 2.0 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jotter_app-4.19.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.1 MB
Release files / jotter_app-4.19.0.tar.gz
| Download URL | jotter_app-4.19.0.tar.gz |
|---|---|
| Size | 2.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ae1d569bff626038cd40901d9137a95e3227c28e76b2fa7784c3f8c465e80198
|
|
BLAKE2b-256 checksum How to use checksums |
32cbab379b00bcc453fea1698f529138868a315290269ca4cabe87d5db037334
|
| 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 Oct 19, 2026.
Transparency logRelease files / jotter_app-4.19.0-py3-none-any.whl
| Download URL | jotter_app-4.19.0-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8175d5408b81b80999673a39d79583df70aeb6ceaa0c86cc550aee3e2c2dd6ec
|
|
BLAKE2b-256 checksum How to use checksums |
96d6829feb1da35571c10252f6c0099b78efa0a55247961d47e25bef34f1e4cf
|
| 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 Oct 19, 2026.
Transparency logSecurity for jotter-app 4.19.0
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for jotter_app-4.19.0.tar.gz
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 Oct 19, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
