Skip to content

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.exe is not next to obitd.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 .obitrules file trusts exactly the version shown in the window.
  • The window, tray and context menu follow [ui] language in config.toml (auto, zh-CN or en; auto follows 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.

LookWhat it is
CalendarA column per day; each file sits on the day it is buried or cremated. Drag it to a later day to extend it.
One lineOne line of input, all from the keyboard: find a file, press Enter to resurrect or extend.
TunnelA 3D tunnel of time: the closer, the sooner it expires. Scroll to move through time.
VigilDark, with a lamp for each file; the dimmer the lamp, the sooner it expires.
NoticesA newspaper's obituary page: serif columns, a stamp when you resurrect.
HorizonTracked files above the ground, the graveyard below.
MicaNative Windows 11 feel with a sidebar.
NightQuiet 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:

SwitchWhat it covers
Tray iconObituary in the notification area; hidden, cleanup keeps running
Taskbar iconWhether the window takes a taskbar slot while open
Start menu"Obituary" in Start
Desktop shortcut"Obituary" on the desktop
Context menuThe "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.

Released under the MIT license.