README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

![kjagave logo](./archlinux/kjagave.png)

# kjagave 

a color picker inspired by agave, but only with the features I actually used

![screenshot of kjagave](./pics/readme-greeter.png)

## features

- visual color picker with rgb/hsv sliders
- **pick colors from anywhere on screen (only on x11 because I'm lazy)**
- alpha channel support
- save and manage favorite colors
- copy hex color codes to clipboard
- clean, minimal interface

## requirements

- go 1.21 or higher
- gtk3 development libraries
- `xcolor`

## installation

### arch linux

```bash
cd archlinux
makepkg -si
```

see `archlinux/README.md` for more details.

### manual build

```sh
cd src
go mod download
go build -o ../kjagave main.go
```

## running

```bash
./kjagave
```

## usage

1. use the color picker button to open the full color selection dialog
2. **click "Pick from Screen" to grab a color from anywhere on your screen** - your cursor will change to a crosshair, click on any pixel to select its color
3. click "Copy to Clipboard" to copy the hex color code
4. click "Save..." to save the current color to your favorites list
5. expand "Saved Colors" to view and manage your saved colors
6. select a saved color to load it in the picker
7. click "Delete" to remove a selected saved color

saved colors are stored in `~/.config/kjagave.json` as json.