aboutsummaryrefslogtreecommitdiffstats
path: root/appearance/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'appearance/README.md')
-rw-r--r--appearance/README.md36
1 files changed, 29 insertions, 7 deletions
diff --git a/appearance/README.md b/appearance/README.md
index 467dcd3..2c127a2 100644
--- a/appearance/README.md
+++ b/appearance/README.md
@@ -4,13 +4,13 @@ Wallpapers and colour scheme in one drawer. `SUPER+Return` opens it on the
Wallpaper tab; Tab switches tabs, Escape closes.
┌─[ Wallpaper ]─[ Theme ]─[ Sunset ]─[ Idle ]─[ Icons ]──┐
- │ Set on [Horizontal] [Vertical] 261 wallpapers │
- │ ┌────┐ ┌────┐ ┌────┐ ┌────┐ ┌──┐ ┌─────┐ │
- │ │ │ │ │ │ │ │ │ │ │ │ │ │
- │ └────┘ └────┘ └────┘ └────┘ └┬─┘ └──┬──┘ │
- │ ┌────┐ ┌────┐ ┌────┐ ┌────┐ ═╧═ ══╧══ │
- │ │ │ │ │ │ │ │ │ [Apply] [Reset] │
- │ └────┘ └────┘ └────┘ └────┘ │
+ │ Set on [Horizontal] [Vertical] 1161 wallpapers │
+ │ ▸ wallpapers 16 ┌──┐ ┌─────┐ │
+ │ ▾ SFW 30 │ │ │ │ │
+ │ ┌────┐ ┌────┐ ┌────┐ ┌────┐ └┬─┘ └──┬──┘ │
+ │ │ │ │ │ │ │ │ │ ═╧═ ══╧══ │
+ │ └────┘ └────┘ └────┘ └────┘ enlarged 1.6×: … │
+ │ ▸ system 727 [Apply] [Reset] │
└────────────────────────────────────────────────────────┘
## Running it
@@ -75,6 +75,28 @@ would look like: the staged pick where there is one, what is currently set
where there is not, and the hovered thumbnail on the targeted screen while the
pointer is over it.
+The thumbnails are grouped by folder, each a header that opens and closes
+it, closed to begin with and remembered while the shell runs. The local
+groups are the top-level folders of `~/Pictures/wallpapers`, with the images
+loose in it as a group of its own; after them come the distribution's,
+`/usr/share/wallpapers`, as `system` for its loose images and `Plasma` for
+its packages. A Plasma package holds one picture at several resolutions,
+some in a dark version too, so it shows once: dark where there is one, then
+the largest, named after the package rather than its `5120x2880.png`.
+
+The list is flat, one row of thumbnails per item, so only the rows in view
+exist and decode, and a folder of hundreds loads as it scrolls. Opening or
+closing a folder inserts or removes just its rows, which keeps the scroll
+position and the thumbnails around it. A first version made each folder one
+item, which loaded every thumbnail of a folder the moment it opened.
+
+Each thumbnail's border says how it will look on the targeted screen, from
+its real size, which `file` reads from the header after each scan (half a
+second for a thousand). `swaybg -m fill` scales to cover, so the measure is
+how far it enlarges: not at all is green, up to 1.33x yellow, past that red.
+Under the mock screens a note in the same colour says why, for the hovered
+image or else the staged one. The staged image keeps the accent border.
+
`wallp` does the actual work, including running `udt-accent`, so the accent
follows the new wallpaper exactly as it does from a terminal. This panel
replaces its qarma file dialog, not the script.