Settings
Settings apply as you change them. Here is what each page sets, how plugins work, which folders stay private, and where Skwir keeps things.
The pages
Open Settings with Ctrl, or More › Settings…. A change applies at once.
| Page | What it sets |
|---|---|
| General | Startup, what a drop does, copies, which pane closing the split closes, tabs |
| Appearance | Theme, icons, how dates read, the full path in the address, tabs |
| Reading | The reader shared by documents, books, Markdown and code, the code’s theme |
| Notes | Where tags, ratings and comments are read and written (Tags) |
| Privacy | Folders that never leave the machine |
| Plugins | Every plugin, on or off, what it may do and what it needs; each plugin’s own options |
| Keyboard | Every key; record your own over any default (Keyboard shortcuts) |
Plugins
Nearly everything in Skwir is a plugin: each preview, the Usage view, the map, the timeline, tags, the terminal. Settings › Plugins lists them all, with a switch, what each may do and what it is waiting for (a program to install, for example). A plugin with options has a page of its own, such as Preview: documents or Thumbnails.
Plugins from outside Skwir are folders with a plugin.toml and a WebAssembly module or a program, put in ~/.local/share/skwir/plugins/. Each stays off until you turn it on, Settings shows what it asks for, and it gets nothing it did not declare. Their protocol is experimental in 0.1 and may change. Writing a plugin explains how to make one.
Two plugins are off by default: Agents and scripts, which lets other programs drive the window (Scripts and agents), and Vim keys (Vim keys).
Private folders
Folders marked private in Settings › Privacy never leave the machine: agents never see their names or contents, and plugins from outside Skwir are never handed them. ~/.ssh, ~/.gnupg and similar folders are private from the start, as is any folder holding a file named .private.
What Skwir keeps, and where
| What | Where |
|---|---|
| Settings and the window’s layout | ~/.config/skwir/settings.toml |
| The cache | ~/.cache/skwir: delete it whenever you like |
| Thumbnails it makes | Your desktop’s thumbnail cache, shared with other apps (Settings › Thumbnails) |
| Tags, ratings, comments | On the files (where) |
| Bookmarks, default apps | Your desktop’s own files |
| A map server’s key | Your desktop’s keyring |
| Plugins from outside Skwir | ~/.local/share/skwir/plugins/ |
If settings.toml can no longer be read (after editing it by hand), Skwir starts with its defaults, keeps your file aside as settings.toml.unreadable-…, and says so.