Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/n-r-k/sxcs
Minimal X11 Color Picker and Magnifier. [MIRROR OF https://codeberg.org/NRK/sxcs]
https://github.com/n-r-k/sxcs
color-picker magnifier x11 zoomer
Last synced: 7 days ago
JSON representation
Minimal X11 Color Picker and Magnifier. [MIRROR OF https://codeberg.org/NRK/sxcs]
- Host: GitHub
- URL: https://github.com/n-r-k/sxcs
- Owner: N-R-K
- License: gpl-3.0
- Created: 2022-04-18T05:36:22.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-06-06T16:36:49.000Z (8 months ago)
- Last Synced: 2024-12-30T05:06:32.977Z (21 days ago)
- Topics: color-picker, magnifier, x11, zoomer
- Language: C
- Homepage: https://codeberg.org/NRK/sxcs
- Size: 7.04 MB
- Stars: 16
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# sxcs - Simple X Color Sniper
[](https://codeberg.org/NRK/sxcs)
Color picker and magnifier for X11.
## Usage
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.
Output format can be chosen via cli argument.
Zoom/magnification can be disabled via `--mag-none`.
```console
$ sxcs --rgb --mag-none
rgb: 22 158 111
```
Copying the hex output to clipboard (using `xclip`):
```console
$ sxcs -o --hex | cut -f 2 | xclip -in -selection clipboard
```
Color output can be disabled via `--color-none`, which more or less turns
`sxcs` into a magnifier.
The magnifying window can be customized via using `--mag-filters `,
where `filter-list` is a comma separated list of filters to apply. The
filter-list will be applied in order, as given by the user.
The default filter list is the following:
```console
$ sxcs --mag-filters "grid,circle,xhair"
```
Following are a couple more examples:
```console
$ sxcs --mag-filters "square,xhair"
```
```console
$ sxcs --mag-filters "grid,xhair"
```
Consult the manpage to see a list of all available cli arguments and filters:
```console
$ man sxcs
```
## Dependencies
- Build Dependencies:
* C89 compiler
* Necessary library headers (on some distros you need to install `*-dev`
packages to get header files)
- Runtime Dependencies:
* Xlib
* Xcursor
* POSIX 2001 C standard library
## Building
* Simple build:
```console
$ cc -o sxcs sxcs.c -O3 -s -l X11 -l Xcursor
```
The above command should also work with `gcc`, `clang` or any other C compiler
that has a POSIX compatible cli interface.
* Debug build with `gcc` (also works with `clang`):
```console
$ gcc -o sxcs sxcs.c -std=c89 -Wall -Wextra -Wpedantic \
-g3 -D DEBUG -O0 -fsanitize=address,undefined -l X11 -l Xcursor
```
* If you're editing the code, you may optionally run some static analysis:
```console
$ make -f etc/analyze.mk
```
## Installing
Just copy the executable and the man-page to the appropriate location:
```console
# cp sxcs /usr/local/bin
# cp sxcs.1 /usr/local/share/man/man1
```
Or using the `install` utility:
```console
# install -Dm755 sxcs /usr/local/bin/sxcs
# install -Dm644 sxcs.1 /usr/local/share/man/man1/sxcs.1
```
A zsh completion script is also available for zsh users under
[etc/zsh-completion](./etc/zsh-completion/).
## Limitation
Cursor size bigger than 255x255 causes visual glitches, it seems to be a
X11/Xcursor limitation.
One alternative would be using XComposite and using an `override_redirect`
window. Which is what was being done (incorrectly) before commit
[33490dd](https://codeberg.org/NRK/sxcs/commit/33490ddf9164655bf6decafa6f85082e413fa333).
I suspect doing this correctly would require way too much code, probably above
my self imposed limit of ~800 SLoC for this project.