Window, tray and context menu
Resurrect files, approve proposals and change settings without the command line.
The tray
obit init starts a tray icon at login. Its menu has:
- recent burials (click one to resurrect it);
- items due within 24 hours;
- pause / resume automatic cleanup;
- Open Obituary (the small window; a notification explains when
obit-gui.exeis not next toobitd.exe); - Quit (the scheduled task keeps working).
The small window
obit-gui.exe has five pages: Upcoming, Graveyard, Decisions, Settings and Logs. "Obituary" in Start, the desktop shortcut and "Open Obituary" in the tray menu all open it.
- The home page's top bar says "Auto registration: off" or "on"; click it to open Settings. Both the top of Decisions and Settings switch it: Off (the default: only what agents and you register goes in), Tiered, Fully automatic and Ask about everything; see What goes in. What went in without asking is listed further down under Handled automatically, each with one-click Undo (the countdown stops, it stays where it is) and Keep longer.
- Items that were due but could not be buried (another program holding a file open, say) are listed under "Burials that failed" on Decisions, with the reason and when it is tried next. Obituary tries again after a while, waiting longer each time, and after repeated failures it stops and waits for you: Retry buries it again now, Stop tracking leaves it where it is.
- While Docker is not running, a container proposal's Approve is unavailable and the card says why; approve it once Docker is up.
- Trusting a
.obitrulesfile trusts exactly the version shown in the window. - The window, tray and context menu follow
[ui] languageinconfig.toml(auto,zh-CNoren;autofollows Windows). You can switch it in Settings. - It needs the WebView2 runtime (built into Windows 11 and present on most Windows 10 machines) and is x64 only.
Eight looks
Switch in Settings → Appearance. It changes only how the window looks on this computer, at once.
| Look | What it is |
|---|---|
| Calendar | A column per day; each file sits on the day it is buried or cremated. Drag it to a later day to extend it. |
| One line | One line of input, all from the keyboard: find a file, press Enter to resurrect or extend. |
| Tunnel | A 3D tunnel of time: the closer, the sooner it expires. Scroll to move through time. |
| Vigil | Dark, with a lamp for each file; the dimmer the lamp, the sooner it expires. |
| Notices | A newspaper's obituary page: serif columns, a stamp when you resurrect. |
| Horizon | Tracked files above the ground, the graveyard below. |
| Mica | Native Windows 11 feel with a sidebar. |
| Night | Quiet dark theme with a top bar. |
Context menu
obit init installs the Explorer context menu by default (for the current user only). Right-click a file or folder, choose "Add to Obituary", then:
- 1 day / 7 days / 30 days: buried when the time is up; use it as usual until then;
- Bury now (recoverable): into the graveyard right away, restorable during the retention period (7 days by default).
Select many files and add them at once. A notification says how many went in, when they will be buried, and how many failed. Windows 11's new menu does not show it: click "Show more options" (or hold Shift while right-clicking). obit init --dry-run lists every entry and its command, and obit doctor checks that it is installed correctly.
macOS and Linux have no context menu yet; use the commands: obit mark <path> 7d to add, obit bury <path> to bury now.
Icons and menus
obit init sets all of these up by default, and each has a switch under Settings > Icons and menus:
| Switch | What it covers |
|---|---|
| Tray icon | Obituary in the notification area; hidden, cleanup keeps running |
| Taskbar icon | Whether the window takes a taskbar slot while open |
| Start menu | "Obituary" in Start |
| Desktop shortcut | "Obituary" on the desktop |
| Context menu | The "Add to Obituary" menu in Explorer |
To skip them at install time: obit init --no-context-menu leaves out the context menu, --no-shortcuts the Start menu and desktop shortcuts.
Burial dates shown in Explorer are covered in Folder policies.