sxcs

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 22)

Minimal X11 Color Picker and Magnifier. [MIRROR OF https://codeberg.org/NRK/sxcs]

sxcs Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# sxcs - Simple X Color Sniper

[![CodeBerg](https://img.shields.io/badge/Hosted_at-Codeberg-%232185D0?style=flat-square&logo=CodeBerg)](https://codeberg.org/NRK/sxcs)

Color picker and magnifier for X11.

![preview](https://images2.imgbox.com/4c/d0/LC6pYmrB_o.gif)

## Usage

<kbd>Button1</kbd> will select and print the color to `stdout`, the output is
TAB separated `hex`, `rgb`, and `hsl`.
<kbd>Scroll Up/Down</kbd> 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 <filter-list>`,
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,icircle,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
  * Xrender
  * POSIX 2001 C standard library

## Building

* Simple build:

```console
$ cc -o sxcs sxcs.c -O3 -s -l X11 -l Xrender
```

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 Xrender
```

* 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 an
inherent 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.

sxcs

sxcs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

sxcs

sxcs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README