Skip to content
GitHub

Notes and tasks

Two collections that never read each other. A note is a title, a body and a colour, with no state and no date. A task is a line, a lane and a day it is due. Nothing turns one into the other.

The deck, a note, the board and a task.

A note is paper: a pastel square with the title across the top and the body in handwriting, in a dark ink that stays dark in every palette. It looks the same wherever it is met — in the deck, open in the island, on a square of the wallpaper, peeking off an edge.

SUPER S opens the deck: every note as a card, the last edited first, with New note in front and the keyboard’s ring on it. So SUPER S then Enter is a blank note, ready to write.

KeyIn the deck
ArrowsMove between cards
Enter or SpaceOpen the card — on New note, start one
DeleteArchive the card
EscapeClose

Each card says how long ago it was edited, and wears a mark in its corner when it is on the wallpaper or on an edge. Show archived, along the bottom, brings the archived ones into the deck, dimmed.

Opened, the island becomes the note: it paints itself the note’s colour and drops its rim. The title comes first, and Enter moves on to the body. Along the bottom:

  • the back arrow;
  • five colours — yellow, the one a note starts with, then the accent, green, blue and red — each the palette’s own colour washed to a pastel, so a note repaints with the wallpaper;
  • Archive, which takes the note off the wallpaper and the edges and keeps it — Restore on an archived one;
  • Delete, which removes the note at once and asks nothing.

A line that starts with [ ] or [x] is drawn as a box, empty or ticked, wherever the note is read, and stays those characters where it is written. Ticking a box is editing the note, so the boxes on the wallpaper are not clicked. Every change is kept as you type, and a note left blank and closed is thrown away.

Escape goes back to where the note came from: the deck when it was opened there, off the island when it was opened from the wallpaper, an edge or a menu.

A note can also be started with the right button on the wallpaper → New note. The handwriting is a setting: Settings → Desktop → Module settings → Handwriting, off for the interface’s typeface.

A note on the desktop is read there, not written: a click opens it in the island.

  • On a square — the Notes widget, in any of the four shapes, shows one note: the newest, or the one picked on its card while arranging.
  • On an edge — a deck of tabs along the left, right or bottom edge. The pointer brings them out, and the tab under it shows the whole note.

A note is in one place at a time. Putting notes on the wallpaper and the edges is in Widgets on the desktop.

A board for what has to be done. SUPER K opens three lanes — To do, Doing and Done — with New task at the top of the first and the keyboard’s ring on it.

Drag a card between the lanes, or up and down inside one; a line shows where it will land. The circle on a card finishes the task, or sends a finished one back to To do. A day under a card turns red once it is late, and the line along the bottom counts what is open, what is due today and what is overdue.

KeyOn the board
ArrowsMove the ring between lanes and cards
EnterOpen the card — on New task, start one
SpaceMove the card one lane along; from Done, back to To do
EscapeClose

Opened, a task fills the panel: its line, with how long ago it was added — or finished — beside it, and anything else about it underneath. Along the bottom:

  • the back arrow;
  • the day — Pick a day until it has one — which opens a month over the button: click a day, turn the month with the wheel or the arrows, or choose Today, Tomorrow or No day; Escape or a click elsewhere leaves it as it was;
  • the lane, To do, Doing or Done, which is how a task is finished;
  • Delete.

A task left without a line and closed is thrown away. Escape goes back to the board, or closes the island when the task was opened from the calendar.

A task’s day shows as a dot under the month wherever a month is drawn: the calendar on the wallpaper, the control centre’s month, the calendar’s detail in the island. The dot is the accent while anything on that day is still to do, and muted once all of it is done. A finished task stays on its day, struck through.

Press a day with a dot and the calendar turns into that day’s tasks. In the island, the detail lists the day you clicked and a row opens that task on the board; on the wallpaper, the widget comes back when the pointer leaves it, or from the arrow.

The Tasks widget on the wallpaper, and the Tasks block in the control centre, show how many are left and what comes first: what is late, else what is due today, else the next thing.

Notes in notes.json and tasks in tasks.json, in ~/.local/state/quickshell/. Neither belongs to a profile, so every profile shows the same notes and the same tasks, and nothing is synced anywhere else.

There is no reminder, no repeating task and no search in the deck; the rest is under Limitations.