Todour Web

Fast, focused plain‑text task management with todo.txt compatibility and a modern, offline‑capable web experience.

Overview

Todour keeps the simplicity of todo.txt while adding helpful affordances like quick tags, saved searches, boards, a calendar, shared projects, and PWA/offline support. Tasks are always stored as plain content and parsed into structured fields for filtering and views.

Features

• Todo.txt compatible: priorities, dates, +projects, @contexts, and extras like due:, t:, rec:, remind:.
• Quick tags: one‑click top projects/contexts next to Add Task.
• Search & filters: combine text, +project, @context, due:, and !negation.
• Saved Smart Lists: store frequent filters for quick access.
• Boards & Calendar: visualize tasks by tag or by due date.
• Project sharing: share a project with other users (recipient read‑only).
• Reminders: schedule with remind:YYYY-MM-DDTHH:MM.
• Email to task: send mail to the app; body lines become tasks.
• PWA & offline: install to desktop/mobile, work offline, auto‑sync later.

Task Syntax

(A) 2025-11-15 Call dentist @phone +personal due:2025-11-20
Buy groceries +home @errands t:+1d
Weekly report +work rec:+1w

Recurrence

Use rec: to create the next instance automatically when you complete a task. Two forms are supported:

• rec:+1w: strict – anchor from existing dates. If the task has due: (or t:), the next one is scheduled by shifting that existing date by the interval (e.g., due 2025‑11‑12 → 2025‑11‑19).
• rec:1w: rolling – anchor from completion date (today). The next one is scheduled relative to when you complete it (e.g., complete on 2025‑11‑10 → due 2025‑11‑17).

Units: d (days), w (weeks), m (months), y (years), b (business days), p (random 1..N days). If neither due: nor t: exists, completion will create a new task with a t: threshold derived from the interval.

Common Searches

+work @office
due:2025-12
!+personal

User Guide

1. Add a task: Enter plain text (e.g., (B) Buy milk +home @errands) and click Add Task.
2. Use quick tags: Click a top +project or @context button to insert it.
3. Filter: Type tokens in the search box (e.g., +work due:2025-12) and press Search.
4. Save a filter: Click Save search, give it a name, and reuse it later.
5. Complete: Toggle the checkbox next to a task to mark done.
6. Boards/Calendar: Open the Board or Calendar tabs to visualize tasks.
7. Share a project: From Sharing, share a +project with another user.
8. Reminders: Add remind:YYYY-MM-DDTHH:MM to get an email reminder.
9. Install the app: Use your browser’s Install feature; it works offline.

Sharing Project Tags

Todour supports sharing by project tag (the +project part of todo.txt). Sharing is directional: an owner grants access to a specific +project so recipients can see those tasks alongside their own. This makes it easy to coordinate around a single tag without merging accounts.

How it works

• Scope: Only +project tags are shareable (not @context).
• Visibility: Recipients see the owner’s tasks that include the shared +project in their Tasks view and searches.
• Permissions: Recipients can comment and mark complete shared tasks. They cannot edit task content/fields or delete the task.
• Filtering: Search, saved searches, and auto‑saved tag buttons include shared tasks if they match the current filter.
• Ownership: Tasks you create as a recipient remain yours; they are not visible to the owner unless they also receive a share for that same project in their direction.

Tips

• Bidirectional collaboration: If you want both sides to see each other’s tasks under the same +project, create two shares (one in each direction).
• Naming: Choose distinctive, stable project names (e.g., +release_Q4) to avoid collisions.
• Privacy: Only the tasks with the shared project tag are visible to recipients; other tasks remain private.

Owners can opt‑in to email notifications when someone completes a task they shared (Settings → Notifications). Comments do not send emails.

Email Ingestion

You can email tasks to your configured email address; each non‑empty line in the message body becomes a task. See the README section for deployment details, or ask your admin.

FAQ

Why todo.txt? It’s portable, future‑proof, and easy to edit anywhere. The app adds conveniences without locking you in.