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, @todour-unread for tasks with unread comments, due:, !negation, and || (OR).
• 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.
• Bubble up: automatically re-prioritize and label stale tasks so they resurface.
• 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
+work || +personal

Separate tokens with spaces for AND (implicit &&). Use || between groups to OR them together. Prefix any token with ! to negate it. Example: +work !@home || +personal returns work tasks not at home, plus all personal tasks.

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

Todour can turn emails into tasks. The exact behavior depends on the import mode set for the sending address. You can configure this in Settings -> Linked email addresses (primary address and each verified linked address have their own mode).

Before You Start

• Enable ingest: turn on Allow creating tasks by sending email in Settings.
• Sender must be recognized: messages are accepted from your primary address, or from a verified linked address.
• One line = one task: in line-based modes, each non-empty body line becomes a task.
• Todo.txt syntax works: tokens like +project, @context, d:/due:, t:, rec:, and remind: are parsed as normal.

Import Modes (Per Email Address)

• Route by subject (recommended): no subject means todo lines; subject means save as one task with full email attached. Any Todour control tags in the subject (for example +garden or d:10/10/2026) are still respected on that created task.
• Auto-detect: short todo-like bodies become line tasks; forwarded emails, long bodies, or newsletter-style content become one task with full email attached.
• Todo lines only: always parse body lines into tasks; subject is ignored for routing.
• Full email (always): always create one task from subject and attach the email body.

Quick Decision Table

Common Scenarios

1. Quick capture from phone

(no subject)
Buy soil +garden d:10/10/2026
Call plumber @home

Result: two tasks are created. +garden is recognized, and d: is normalized to due:.

2. Forwarded email you want to keep

Subject: Fwd: Vendor quote for patio
Body: (full email content)

Result: one task titled from the subject, with the original email attached for reading later.

3. Subject present with Todour tags

Subject: I sent it with this text
Body: To be used before +garden d:10/10/2026

Result (Route by subject mode): because a subject exists, Todour creates one full-email task and attaches the body. To apply tags in this mode, put them in the subject line (for example Subject: To be used before +garden d:10/10/2026).

Attachments and Images

• Full email modes: the HTML body is attached to the created task for in-app viewing.
• Image attachments in line modes: if one task line is created, images are attached to that task; if multiple task lines are created, Todour creates a separate image task and attaches images there.

Optional Sender Tracking

• Include sender in task: adds from:you@example.com to created tasks for that address.
• Notify sender on completion: sends a completion email back to that address when the task is done.

If an email does not import as expected, check the sending address verification, import mode for that address, and whether email ingest is enabled.

Bubble Up

Bubble up automatically resurfaces tasks that have been sitting untouched for too long. When a task matches your chosen query and hasn't been touched for a while, Todour gives it a label (default +🫧) and raises it to a chosen priority (default (B)), so it rises back to the top of your list. To avoid flooding your list, only one task bubbles up per frequency interval (the one that has been untouched the longest).

Configure it under Settings -> Bubble Up:

• Enable bubble up: master toggle for the feature.
• Search query: only tasks matching this query are bubbled, using the same syntax as the search box (+project, @context, due:, ! negation, ||).
• Minimum age: the number of days a task must be untouched (no edits, completions, or comments) before it is eligible.
• Frequency: how often a single task bubbles up. Exactly one task bubbles each time this interval elapses.
• Label: the +tag added to bubbled tasks (default +🫧).
• Priority: the priority a bubbled task is raised to (default B).

A task is considered "touched" whenever you edit it, complete or skip it, or add/edit a comment. Only tasks that haven't been touched within the minimum age are candidates. Bubbling itself does not count as a touch, so it won't reset the inactivity timer. When several tasks qualify at once, only the most-stale one bubbles; the rest wait their turn and are picked up on later runs as the frequency interval elapses.

Bubbling never lowers priority: if a task is already at a higher priority than the configured one (for example (A) when configured as B), its priority is left alone, though the label is still added if missing.

FAQ

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