SXCS(1)

💖 SXCS — the Minimal X11 Color Picker and Magnifier (man page, bestie edition) 💖

okay so. you want a color picker. you want a magnifier. you want it minimal. you want it on X11. and you want it to be called sxcs. bestie, say less, this is literally that, and I'm gonna walk you through every last flag like we're texting at 2am. 🎀

---

✨ SYNOPSIS ✨

sxcs [options]

that's it. that's the whole invocation. lowkey iconic. 💅

---

🌸 DESCRIPTION 🌸

sxcs is a minimal X11 color picker and magnifier. no cap, that's the entire vibe — it picks colors and it magnifies stuff.

Mouse time 🖱️ — Mouse Button1 will select and print the color to stdout. the output is TAB separated hex, rgb and hsl. Scroll Up/Down will zoom in and out. any other mouse button will quit sxcs (so like, Button2, Button3, whatever, they're all the ✌️ exit button).

Keyboard time ⌨️ — the keyboard can also be used when --keyboard is enabled. the arrow keys Left, Right, Up, Down as well as vi-like h, j, k, l are supported for moving the cursor. by default they move by 16 pixels, if Control is used then they move by 1 pixel, otherwise if Shift is used they move by 128 pixels instead. Space makes a selection. q and Escape quits. + and - zooms in and out.

so to recap the movement math: nothing held = 16px, Ctrl = 1px (for when you're being precise ✨), Shift = 128px (for when you're trying to get across the screen and you have places to be 💀).

---

👑 OPTIONS 👑

• --color-none — disable color output. going full monochrome, no color for you 🚫🌈
• --hex — output hex colors.
• --rgb — output rgb colors.
• --hsl — output hsl colors.
• --mag-none — disable magnifier. just the picker, no zoom, we keeping it simple 🦋
• --mag-filters filters — comma separated list of filter to apply in order. See the FILTERS section. (order matters, bestie, it applies them in order fr fr)
• -o, --one-shot — quit after a single selection. one and done, main character energy, no encore 🎤
• -q, --quit-on-keypress — quit on keypress.
• -k, --keyboard — enable keyboard control. (this is the one that unlocks all the key stuff up in DESCRIPTION, you need it, don't forget it 🙈)
• -h, --help — Show usage and exit.
• --version — Show version and exit.

---

🎀 FILTERS 🎀

List of available filters:

• square — draws a square border.
• xhair — draws a square crosshair.
• grid — draws grid.
• circle — draws a circle.
• icircle — similar to circle, but the border color is based on what's underneath the cursor. it's giving camouflage, it's giving adaptive, we love a filter with range 💜

---

⭐ EXIT STATUS ⭐

sxcs exits with status 0 on success, non-zero on abnormal termination. so if you get a 0, slay, everything went great. anything else and we're in our flop era 😭

---

🫶 AUTHORS 🫶

NRK <nrk@disroot.org>

---

💀 BUGS 💀

Reporting Bugs

for reporting bugs, either open an issue under the Codeberg repo <https://codeberg.org/NRK/sxcs> or send an email to <nrk@disroot.org>. be nice, be specific, include the details, the maintainer will love you for it 💖

Known Bugs

Visual glitches may occur if the cursor size is too big (typically 255x255).

so yeah, if your cursor is an absolute unit (think ~255x255), expect some visual glitches. not a vibe, but forewarned is forearmed. 🌈

---

alright bestie, go pick some gorgeous colors. this was sxcs v1.2.1 from May 2026, and that's the whole page, periodt. 💅✨🎀🦋