XWINMOSAIC(1)

✨ xwinmosaic ✨

okay so bestie, you're reading the General Commands Manual entry for xwinmosaic, and honestly? it's a whole vibe. buckle up 🎀

---

🌈 NAME 🌈

xwinmosaic — show X11 windows as a colourful mosaic 🦋

---

⭐ SYNOPSYS ⭐

(no bestie, that's not a typo of mine, that's just how the page spells it, we respect it 💅)

xwinmosaic [options]...

---

💖 DESCRIPTION 💖

xwinmosaic is an X11 window switcher that draws your windows list as a colour mosaic. it's inspired by XMonad.Actions.GridSelect, but it's written in C + GTK+2, it uses nice-looking colours, and it comes with a set of genuinely helpful features. it's giving grid but make it fashion 🎨✨

it can also be used as a dmenu-style thing — to select an item from a newline-separated list piped in from stdin and print it to stdout. lowkey iconic.

for using xwinmosaic as a window switcher, you should run it in a WM that supports the EWMH (Extended Window Manager Hints) specification. however! that's not necessary for read_stdin mode, so no pressure there 🫶

---

🔥 OPTIONS 🔥

• -r, --read-stdin — read items from stdin and print the selected item to stdout.
• -p, --permissive — lets the search entry text be used as an individual item (i.e. when no item is matched, whatever's in the search entry gets printed to stdout). can be used only with -r.
• -t, --format — read items from stdin in this next format (comma separated):

<desktop_num>, <box_color>, <icon>, <label>, <opt_name>

any option except <label> can be skipped (the comma is still necessary though, don't ghost it 🙈). <icon> should be a path to a png file or an icon name from your theme. any positive value of <desktop_num> is allowed. can be used only with -r.

• -V, --vim-mode — turn on vim-like navigation (hjkl, search on /) 🧚
• -C, --no-colors — turn off box colorizing.
• -I, --no-icons — turn off showing icons.
• -D, --no-desktops — turn off showing desktop number.
• -T, --no-titles — turn off showing titles.
• -S, --screenshot — get a screenshot and set it as the background (for WMs that do not support XShape).
• -P, --at-pointer — place the center of the mosaic at the pointer position.
• -W <int>, --box-width=<int> — width of the boxes (default: 200).
• -H <int>, --box-height=<int> — height of the boxes (default: 40).
• -i <int>, --icon-size=<int> — size of window icons (default: 16).
• -f 'font [size]', --font='font [size]' — which font to use for displaying widgets (default: 'Sans 10').
• -o <int>, --hue-offset=<int> — set the color hue offset (from 0 to 255).
• -F /path/to/file, --color-file=/path/to/file — pick colors from a file. the file format is described in the USAGE section, keep scrolling 💜

---

🌸 USAGE 🌸

🎀 Keybindings 🎀

use arrow keys or your mouse to navigate through windows. start typing to search for the required window. use Return or mouse button 1 to confirm selection (switch to the selected window, or print the selected item to stdout). the following hotkeys are available too:

Default (Emacs) mode:

• C-n — move down.
• C-p — move up.
• C-f — move right.
• C-b — move left.
• C-h — delete character backward.
• C-w — delete word backward.
• C-m — confirm selection.

Vim mode:

• h — move left.
• j — move down.
• k — move up.
• l — move right.
• / — activate search.

⚙️ Configuration ⚙️

the config file gets created automatically on the first program run and lives at ~/.config/xwinmosaic/config 🏠

it has the following entries:

• vim_mode — should the program run in vim mode.
• box_width — width of the boxes.
• box_height — height of the boxes.
• colorize — should the program colorize boxes or not?
• color_offset — set hue offset for the default colorizing method (safe values are between 0 and 255).
• show_icons — should the program show icons?
• show_desktop — should the program show the desktop number?
• show_titles — should the program show titles?
• icon_size — size of the icons in boxes.
• font — which font to use in all program widgets.
• screenshot — set screenshot as a background. useful for WMs that don't work properly with shaped windows.
• screenshot_offset_x — screenshot offset by x coordinate. can be useful if your WM does not support the _NET_WM_STRUT and/or _NET_WM_STRUT_PARTIAL property.
• screenshot_offset_y — screenshot offset by y coordinate. as above.
• at_pointer — if true, the center of the mosaic is placed at the current pointer position.
• color_file — path to the file with colors that xwinmoasic should use (yep, that's literally how it's spelled in the page, we stan a consistent typo 💀). colors can be set for each window class individually, or taken from a fallback list (note: each color is separated by a semicolon).

Color file format:

[colors]
# Use xprop to determine window class
WindowClass1 = #112233
WindowClass2 = #445566
# For other windows to use. You can omit that line and it will
# use standard colorizing scheme.
fallback = #778899; #AABBCC; #DDEEFF

---

💀 BUGS 💀

if you found some bug in xwinmosaic, please report it at https://github.com/soulthreads/xwinmosaic/issues — do it, the maintainers will love you for it 🫶

---

👑 AUTHOR 👑

xwinmosaic and this manual page is written by Anton Lobashev <soulthreads@yandex.ru> 💌

---

and that's the whole page, bestie — no cap 🧚✨ this was the xwinmosaic page from the General Commands Manual, dated June 12, 2013, and you read all of it. slay 🎀💅