mirror of
https://github.com/selectstarfromusers/obsidian-task-manager.git
synced 2026-07-22 14:00:23 +00:00
108 lines
5.2 KiB
Markdown
108 lines
5.2 KiB
Markdown
# Minimal Task Board
|
|
|
|
A clean, minimal task board for [Obsidian](https://obsidian.md). Create customizable buckets, group tasks by any frontmatter property, and track tasks inline from any note in your vault.
|
|
|
|
---
|
|
|
|
## Views
|
|
|
|
| Mode | Description |
|
|
|------|-------------|
|
|
| **Board** | All buckets displayed as side-by-side columns with tasks flowing vertically. Best for wide screens and quick triage. |
|
|
| **Focus** | One bucket at a time, full-width, with tabs along the top to switch between buckets. Best for deep work and mobile. |
|
|
|
|
## Features
|
|
|
|
- **Customizable buckets** -- Create as many buckets as you need with any name. Use them for an Eisenhower matrix, GTD stages, sprint columns, or any workflow that fits your thinking.
|
|
- **Secondary grouping** -- Group tasks within each bucket by any frontmatter property (account, project, team, etc.). Groups appear as subtle, semi-transparent frames inside the bucket.
|
|
- **Inline task tracking** -- Add `#task` to any checkbox in any note to surface it on the board. Assign a secondary group with a wikilink: `- [ ] Send docs [[Project Alpha]] #task`
|
|
- **Bidirectional sync** -- Check off a task on the board or in the source note; both stay in sync.
|
|
- **Drag-and-drop** -- Move tasks between buckets or reorder them within a bucket.
|
|
- **Completion animation** -- Checked tasks get a strikethrough, fade out, and collapse smoothly.
|
|
- **Frameless design** -- Tasks render as clean text with checkboxes. No card borders, no visual noise.
|
|
- **"+ Add a task" button** -- Create tasks directly from the board. The secondary group field autocompletes from existing groups.
|
|
- **Accessibility** -- Full ARIA roles and keyboard navigation. Enter/Space to toggle a task, Tab to move between elements.
|
|
- **Mobile-friendly** -- Larger touch targets on touch devices for comfortable use on phones and tablets.
|
|
|
|
## Usage
|
|
|
|
### Creating tasks
|
|
|
|
There are three ways to add tasks:
|
|
|
|
1. **Inline** -- In any note, write a checkbox line with the `#task` tag:
|
|
```markdown
|
|
- [ ] Review quarterly report [[Finance]] #task
|
|
```
|
|
The task appears on the board automatically.
|
|
|
|
**Syntax notes**: The `#task` tag must be at the **end of the line** -- no text after it, or the plugin won't detect the task. If you include multiple `[[wikilinks]]`, only the first one is used for secondary grouping; the rest are stripped from the task text.
|
|
|
|
2. **From the board** -- Click **+ Add a task** at the bottom of any bucket. Type the task text, optionally pick a secondary group, and press Enter.
|
|
|
|
3. **Stub files** -- Create a markdown file in the configured task folder with the appropriate frontmatter. The plugin picks it up on the next scan.
|
|
|
|
### How buckets work
|
|
|
|
Each task belongs to exactly one bucket. The bucket is stored as a frontmatter property on the task (or its parent note for inline tasks). You define your buckets in settings -- their names, order, and colors are entirely up to you. Drag a task from one bucket to another to reassign it.
|
|
|
|
### How secondary grouping works
|
|
|
|
When enabled, tasks inside each bucket are collected under group headings based on a frontmatter property you choose (for example, `account` or `project`). Each group is wrapped in a subtle semi-transparent frame. Groups are collapsible so you can hide what you are not working on. Tasks that have no value for the grouping property appear under an "Ungrouped" heading.
|
|
|
|
## Configuration
|
|
|
|
Open **Settings > Community Plugins > Tasks** to configure the plugin.
|
|
|
|
### General
|
|
|
|
| Setting | Description | Default |
|
|
|---------|-------------|---------|
|
|
| Task folder | Folder where new tasks created from the board are saved | `tasks/` |
|
|
| Inline tag | Tag used to identify inline tasks across your vault | `#task` |
|
|
| Default view | View mode when opening the board | Board |
|
|
|
|
### Buckets
|
|
|
|
| Setting | Description |
|
|
|---------|-------------|
|
|
| Add bucket | Create a new bucket with a custom name |
|
|
| Rename | Change a bucket's display name |
|
|
| Reorder | Drag buckets to change their column order |
|
|
| Delete | Remove a bucket (tasks in it become unassigned) |
|
|
|
|
### Secondary Grouping
|
|
|
|
| Setting | Description | Default |
|
|
|---------|-------------|---------|
|
|
| Enable grouping | Toggle secondary grouping on or off | Off |
|
|
| Property name | Frontmatter property used to group tasks | `account` |
|
|
| Collapsible groups | Allow collapsing/expanding individual groups | On |
|
|
|
|
### Display
|
|
|
|
| Setting | Description | Default |
|
|
|---------|-------------|---------|
|
|
| Show due dates | Display due date badges on tasks | On |
|
|
| Show task age | Display how long a task has been open | Off |
|
|
| Source icons | Show a small icon linking back to the source note | On |
|
|
| Compact mode | Reduce padding and font size for denser boards | Off |
|
|
| Completion behavior | What happens after a task is checked off (fade, archive, or remove) | Fade |
|
|
|
|
## Installation
|
|
|
|
### Community plugins (recommended)
|
|
|
|
1. Open **Settings > Community Plugins > Browse**.
|
|
2. Search for **Tasks**.
|
|
3. Click **Install**, then **Enable**.
|
|
|
|
### Manual
|
|
|
|
1. Download the latest release from the [GitHub releases page](https://github.com/artmalanok/obsidian-tasks/releases).
|
|
2. Extract the files into your vault's `.obsidian/plugins/obsidian-tasks/` folder.
|
|
3. Reload Obsidian and enable the plugin under **Settings > Community Plugins**.
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE)
|