Technical documentation
How the tools work, which files they install, and how to maintain them. For what each tool does and how to install it, start at the main README.
| Page | What it covers |
|---|---|
| taskbar.md | Taskbar: behaviour in detail, second-line sources, installed files, settings files, update check |
| launcher-entry.md | How any app can fill the taskbar’s second line with the Unity LauncherEntry D-Bus signal |
| terminal-tabs.md | Patched COSMIC Terminal: the tab-count file it writes, installed files |
| files-tabs.md | Patched COSMIC Files: the tab and item-count file it writes, installed files |
| tray-colors.md | Patched tray applet: the icon colour rule, installed files |
| text-editor.md | Patched COSMIC Text Editor: Markdown views, one window, session restore, change history, changed-on-disk bar, preview selection, two views and clones, link safety, installed files |
| ws-keeper.md | Workspace Keeper: snapshot rules, restore matching, pins, commands, services |
| show-desktop.md | Show Desktop: minimize/restore logic, the Super+D shortcut |
| patch-series.md | How the patches on System76’s code are kept, changed and moved to a new COSMIC version |
| testing.md | ./test.sh, what the tests cover and what is tested by hand |
Internal names are older than the folder names and stay as they are: the taskbar’s binaries are
cosmic-applet-minimize-ws and cosmic-app-list-ws, its settings live in
~/.config/minimize-ws/, and its cache and state folders, systemd units and patch-series NAME
say minimize-ws. The other patched tools use term-tabs, files-tabs, tray-color and edit-md
for the same purpose.