e07a4299c2
Settings shortcut in the panel header, and long task text now wraps inside its own column instead of running under the row buttons. Co-authored-by: nightwatch75 <nightwatch75@users.noreply.github.com> Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
134 lines
5.2 KiB
Markdown
134 lines
5.2 KiB
Markdown
# To Do
|
|
|
|
A [noctalia](https://github.com/noctalia-dev/noctalia) v5 bar plugin: a
|
|
prioritised to-do list. Click the bar glyph to toggle a panel of task rows —
|
|
add tasks with **+**, tick them off (the text is struck through), delete them,
|
|
and set each task's priority. The list is kept sorted by priority and stored as
|
|
a single JSON file; no external commands are run.
|
|
|
|
## Plugin
|
|
|
|
| Field | Value |
|
|
| --- | --- |
|
|
| ID | `nightwatch75/todo` |
|
|
| Entries | Bar widget: `todo`; panel: `panel` |
|
|
|
|
## Usage
|
|
|
|
Add the `todo` widget from Noctalia's widget picker and click it to open the
|
|
task panel. You can also open the panel directly or bind it in your compositor:
|
|
|
|
```sh
|
|
noctalia msg panel-toggle nightwatch75/todo:panel
|
|
```
|
|
|
|
| Action | Effect |
|
|
|-------------------------------|-----------------------------------------------------|
|
|
| Left click (bar glyph) | Open/close the To Do panel |
|
|
| **+** (panel header) | Add a new task and start typing it |
|
|
| Sort toggle (panel header) | Switch ordering between **Priority** and **Manual** |
|
|
| Colour chip (row) | Cycle the task's priority: important → medium → low |
|
|
| ☰ grip (row, manual only) | Drag the row to a new position (reorder) |
|
|
| Click the text, or ✎ (pencil) | Edit the task's text |
|
|
| **Enter**, or ✓ (row) | Commit the edit — the row goes back to a static line |
|
|
| ☐ / ☑ button (row) | Toggle done/to-do (done tasks are struck through) |
|
|
| 🗑 button (row) | Delete the task |
|
|
| ⚙ button (panel header) | Open this plugin's page in *Settings → Plugins* |
|
|
|
|
That settings page also opens from the command line, so it can be bound in your
|
|
compositor too:
|
|
|
|
```sh
|
|
noctalia msg settings-open-plugin nightwatch75/todo
|
|
```
|
|
|
|
## Priorities
|
|
|
|
Each task carries a priority, shown at the start of the row as a small coloured
|
|
square. Click the square to cycle it. A legend at the foot of the panel maps
|
|
each colour to its category:
|
|
|
|
| Priority | Colour |
|
|
|-----------|--------|
|
|
| Important | red |
|
|
| Medium | amber |
|
|
| Low | green |
|
|
|
|
## Ordering
|
|
|
|
The panel header carries a toggle that switches between two ordering modes; the
|
|
choice is remembered.
|
|
|
|
- **Priority** (default) — rows are sorted by priority: important first, then
|
|
medium, then low. Changing a task's priority moves it into its new group but
|
|
keeps its position relative to its peers; equal-priority rows are never
|
|
reshuffled. No grips are shown.
|
|
- **Manual** — rows keep the order you give them. Each row grows a ☰ grip on the
|
|
left; here changing a priority only recolours the chip and never moves the row.
|
|
|
|
Priority mode is only a view: the stored order is always the manual one, so
|
|
switching between the two modes (as often as you like) never loses your custom
|
|
ordering.
|
|
|
|
### Reordering in manual mode
|
|
|
|
Grab a row by its ☰ grip and drag it. Thin insertion zones open up between the
|
|
rows as you drag; drop the row on one to move it there. This uses noctalia's
|
|
declarative drag-and-drop, which needs plugin API ≥ 5.
|
|
|
|
## Editing
|
|
|
|
Rows are static lines by default. Click a task's text (or its ✎ pencil button)
|
|
to edit it; press **Enter** or the ✓ button to commit back to a static line. A
|
|
new task (**+**) opens straight into edit mode — committing it while still empty
|
|
simply discards it. Edits are also autosaved after a short idle pause and on
|
|
close.
|
|
|
|
Tick a task (☐ → ☑) to complete it — its text is struck through until you
|
|
un-tick it. The bar glyph's tooltip shows how many tasks are still to do.
|
|
|
|
A task longer than the row wraps onto further lines and the row grows to fit,
|
|
so the whole text stays readable and never runs under the buttons on the
|
|
right.
|
|
|
|
## Storage
|
|
|
|
Tasks live in one file, `todo.json`, inside the configured **To Do folder**
|
|
(default `~/Documents/Todo`). It is a small JSON object,
|
|
`{ "version": 2, "sort": "priority" | "manual", "tasks": [ … ] }`, where `tasks`
|
|
is the array of `{ id, text, priority, done }` objects (in manual order) — easy
|
|
to read, hand-edit, sync, or back up. An older plain-array file is still read
|
|
automatically. The plugin runs no external programs.
|
|
|
|
## Settings
|
|
|
|
| Setting | What it does |
|
|
|--------------|----------------------------------------------------------|
|
|
| To Do folder | Where `todo.json` is stored (default `~/Documents/Todo`).|
|
|
| Bar glyph | The glyph shown for the widget on the bar. |
|
|
|
|
## Install
|
|
|
|
Install **To Do** from Noctalia's plugin store (*Settings → Plugins*), then add
|
|
the widget to a bar from *Settings → Bar*. Plugin options live in
|
|
*Settings → Plugins*.
|
|
|
|
For local development, add your working copy as a path source instead
|
|
(`.luau` edits hot-reload):
|
|
|
|
```sh
|
|
noctalia msg plugins source add dev path /path/to/plugins
|
|
noctalia msg plugins enable nightwatch75/todo
|
|
```
|
|
|
|
## Requirements
|
|
|
|
- noctalia v5.0.0-beta.6 or newer — the first tagged release that accepts
|
|
`plugin_api = 15` (`noctalia.openSettings()`, the panel's ⚙ button;
|
|
declarative drag-and-drop needs 5)
|
|
- No external dependencies
|
|
|
|
## License
|
|
|
|
MIT.
|