Todo.txt for Obsidian

Powerful yet simple task management for Obsidian in the portable Todo.txt format, with smart filtering and a modern interface.

✨ Features

📋 Smart Task Management

• Todo.txt format - Simple, portable, future-proof
• Multiple task files - Any .txt file becomes a task list automatically
• Create new files - Quickly create new .txt task files via command palette
• WikiLink support - Type [[ in task titles or descriptions to link to vault files
• Quick filters - All, Today, Upcoming, Inbox, Archived, Completed
• Flexible sorting - By priority, due date, creation date, alphabetical, projects, or contexts
• Project organization - Custom icons, pinning, drag & drop reordering, bulk operations
• Priority levels - Visual priority indicators (A, B, C)
• Due dates - Smart date recognition with status indicators
• Recurring tasks - Flexible recurrence patterns
• Context tags - Organize by location, energy, or focus
• Task notes - Extended descriptions with link and WikiLink support

🚀 Modern Interface

• Mobile responsive - Full functionality on all devices
• Theme compatible - Works seamlessly with all Obsidian themes
• Flexible sidebar - Collapsible project panel for more workspace
• Instant search - Find tasks across all projects
• Smart suggestions - Autocomplete for projects, contexts, priorities, and vault files
• Keyboard shortcuts - Assign custom hotkeys to “Add task” and “Open task”
• Bulk operations - Manage multiple completed tasks at once

⚡ Quick Input

Type / for quick commands:

• /Date - Set due dates (Today, Tomorrow, Next Week, etc.)
• /Priority - Set priority levels
• /Project - Assign to projects
• /Context - Add context tags

Or use symbol shortcuts (works like /):

• @context - Add context tags
• +project - Assign to projects
• !priority - Set priority levels
• *date - Set due dates
• [[ - Link to vault files (WikiLink)

🔧 Installation

From Obsidian Community Plugins

1. Open Settings → Community plugins
2. Browse and search for "Todo.txt"
3. Install and enable the plugin

Using BRAT

1. Install the BRAT plugin from Obsidian community plugins
2. Open Settings → BRAT → Add Beta plugin
3. Enter the URL of this repository: https://github.com/ghMahmudul/todo-txt-obsidian
4. Under "Select a version", choose the Latest version
5. Click "Add Plugin"

Manual Installation

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create a folder named todo-txt in your vault's .obsidian/plugins/ directory
3. Copy the downloaded files into the todo-txt folder
4. Reload Obsidian
5. Go to Settings → Community plugins and enable "Todo.txt"

📖 Usage

Getting Started

1. Open the plugin via ribbon icon or Ctrl/Cmd+P → "Open task"
2. Create a new task file with Ctrl/Cmd+P → "Todo.txt: Create new file"
3. Create your first task by clicking "Add task" or assign a custom hotkey in Settings → Hotkeys
4. Organize with projects, set priorities, and add due dates
5. Link to vault notes by typing [[ in task titles or descriptions

Todo.txt Format

(A) 2025-08-03 @✨Feature Add due date — [[Development Notes]] +Inbox due:2025-06-25
(B) 2025-08-03 Solve Python #problems rec:1m,3 +Coding due:2025-08-20
(C) 2025-08-03 Buy more groceries +Shop due:2025-08-18 ||Get essentials like milk, eggs, bread, and vegetables from https://example.com
2025-08-03 Read Chapter 4 of the physics textbook time:2h +Study

Format breakdown:

• (A) - Priority (A–Z, A = highest, Z = lowest)
• 2025-08-03 - Creation date
• @Features - Context tag
• #problems - Hashtag (searchable)
• +Inbox - Project tag
• due:2025-06-25 - Due date
• rec:1m,3 - Monthly recurrence on 3rd
• time:2h - Custom key:value pairs
• https://example.com - Clickable links
• [[Development Notes]] - WikiLinks to vault files
• ||Get essentials... - Task notes (supports links and WikiLinks)

Recurring Tasks

Support for flexible recurrence patterns:

• rec:1d - Daily
• rec:1w - Weekly
• rec:1m - Monthly
• rec:1y - Yearly
• rec:1w,sun,mon,fri - Weekly on specific days
• rec:1m,12,17 - Monthly on specific dates (12th and 17th)
• rec:jun,23 - Yearly on specific date (June 23rd)

Project Management

• Create projects - Click + next to "Projects" or use Ctrl/Cmd+P → "Todo.txt: Add project"
• Add icons - Emoji or SVG icons for visual organization
• Pin important - Click ⋯ menu → Pin for quick access
• Reorder projects - Drag and drop to reorder projects in the sidebar
• Drag to pin/unpin - Drag projects between main list and pinned sections
• Bulk actions - Rename, delete, or archive entire projects

Smart Filtering & Sorting

• All - View all active tasks
• Today - Due today or overdue
• Upcoming - Future due dates
• Inbox - Unorganized tasks
• Archived - Archived tasks
• Completed - Finished tasks

Sort options: Priority, Due Date, Creation Date, Alphabetical, Projects, Contexts, Completion Date

⚙️ Configuration

Settings

• Tasks location - Choose your todo.txt file path
• Startup filter - Default view when opening
• Open on startup - Auto-open when Obsidian starts

🎯 Pro Tips

• Set a custom hotkey for "Todo.txt: Add task" in Settings → Hotkeys for quick task creation anywhere in Obsidian
• Use "Todo.txt: Create new file" to set up separate task lists for different areas of life
• Pin the Todo.txt file to the Obsidian sidebar for quick access
• Use multiple .txt files for different contexts: work.txt, personal.txt
• Link related notes using WikiLinks ([[Note Name]]) to connect tasks with docs, meeting notes, or resources
• Search with hashtags: #meeting finds all meeting-related tasks
• Set up projects for different areas: +Travel, +Goals, +Hobby
• Use contexts for work types: @🐞Bug, @✨Feature, @⚙️Refector
• Combine filters: Search while in a project view to find specific tasks
• Sort by due date to prioritize urgent tasks, or by project to batch similar work
• Organize your sidebar by dragging projects to match your workflow priorities

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

⭐ Star this repo if you find it helpful!