isotjs/todosian-app

isotjs/todosian-app has 50 GitHub stars and 8 forks. GitHot measured 0 stars in 24 hours and +2 in 7 days. Last checked 2026-11-10 02:28 UTC. Last push 2026-10-22.

How these counts are measured

A minimalist, local-first Android Todo app seamlessly integrated with Obsidian (Tasks). Built with Jetpack Compose and Material 3 for a privacy-focused Second Brain experience.

50 stars 8 forks

What you can do

Folder-based setup using Android Storage Access Framework (SAF) with persisted permissions.
Each Markdown file becomes a category.
Add / edit / toggle / delete todos and subtasks.
Create / rename / delete categories (files).

Measured star growth

in 24h: 0
in 7 days: +2
in 15 days: Update delayed
in 1 month: Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

Todosian

Todosian is an Android app for managing todo lists stored as Markdown files inside your Obsidian vault.

It is designed to work with a folder that is synced to your phone (for example via Syncthing). The app reads and writes the Markdown files directly; it does not import your data into a database.

Screenshots

Features

Folder-based setup using Android Storage Access Framework (SAF) with persisted permissions.
Each Markdown file becomes a category.
Add / edit / toggle / delete todos and subtasks.
Create / rename / delete categories (files).
(Optional) Support for Obsidian Tasks plugin metadata (dates, priority, recurrence).
Daily Focus view to see what's due today, overdue, or both.
Editable due reminders that fire once per day for tasks due soon.
Home screen widgets: a todo list with inline toggling and a quick-add widget.
Configurable theme (System / Light / Dark), Material 3 UI, and dynamic color (Android 12+).
Category and todo sorting (A–Z, priority, created date, due date) and grouping.
Lazy loading for smooth performance on large files.

Supported Markdown

Todos are parsed from lines that match:

- [ ] Do something
- [x] Done task

When “Tasks plugin support” is enabled, Todosian also parses (and can write) common suffix metadata:

- [ ] Write README 📅 2026-02-22 🔼 🔁 every week
- [x] Ship build ✅ 2026-02-20

Recognized suffix tokens:

Dates: ➕ YYYY-MM-DD (created), 🛫 YYYY-MM-DD (start), ⏳ YYYY-MM-DD (scheduled), 📅 YYYY-MM-DD (due), ✅ YYYY-MM-DD (done)
Priority: 🔺 / ⏫ / 🔼 / 🔽 / ⏬
Recurrence: 🔁 <text>

Non-todo lines are preserved. The app only edits the specific todo lines you change.

Usage

Sync (or copy) your Obsidian todo folder to your Android device (Syncthing works well).
Open Todosian and select that folder when prompted.
Tap a category (a .md file) to manage its todos.

Download Now

F-Droid	GitHub	OpenApk

Privacy

Todosian only accesses the folder you pick. There is no account, no analytics, and no network sync built into the app.

Contributing

Issues and pull requests are welcome.

Keep changes aligned with the “files are the source of truth” principle.
Prefer small, testable logic (e.g. Markdown parsing) with unit tests.

AI Usage & Disclaimer

This application was heavily co-developed with an AI agent to test their ability to code an Native Kotlin app from scratch(as they did). While the codebase has been strictly audited for performance, privacy, and security standards, it is provided "as is" without warranties of any kind.

Disclaimer: Todosian modifies your Markdown files directly. The repository owner assumes no liability for any unintended data loss or file corruption. Please ensure you have a reliable backup of your Obsidian vault (e.g., via Git, Syncthing file versioning, or Obsidian Sync) before using this application.

Trademark Disclaimer: Todosian is an independent, open-source application and is not affiliated with, endorsed by, or sponsored by Obsidian or the developers of the Obsidian Tasks plugin.

License

Licensed under the Apache License 2.0. See LICENSE.