diff options
| author | kj_sh604 | 2026-03-15 11:40:51 -0400 |
|---|---|---|
| committer | kj_sh604 | 2026-03-15 11:40:51 -0400 |
| commit | ef712cc8c545044b469fe843c5a3fc190fab4e42 (patch) | |
| tree | 7b9df2b3a796591cff9d9ec18df0788647f65da2 /README.md | |
| parent | 9ceac108893fe2ce2b2abc441aaf9294d58ee4ed (diff) | |
refactor: boilerplate re-write
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 38 |
1 files changed, 23 insertions, 15 deletions
| @@ -2,7 +2,7 @@ | |||
| 2 | 2 | ||
| 3 | # kjagave | 3 | # kjagave |
| 4 | 4 | ||
| 5 | a color picker inspired by agave, but only with the features I actually used | 5 | a GTK3 color scheme generator inspired by classic Agave, rewritten in Go |
| 6 | 6 | ||
| 7 | <img width="554" height="467" alt="recent screenshot" src="https://github.com/user-attachments/assets/efbea3f0-9d1f-45b1-865b-bb82a3ddc443" /><br> | 7 | <img width="554" height="467" alt="recent screenshot" src="https://github.com/user-attachments/assets/efbea3f0-9d1f-45b1-865b-bb82a3ddc443" /><br> |
| 8 | 8 | ||
| @@ -11,12 +11,22 @@ a color picker inspired by agave, but only with the features I actually used | |||
| 11 | 11 | ||
| 12 | ## features | 12 | ## features |
| 13 | 13 | ||
| 14 | - visual color picker with rgb/hsv sliders | 14 | - Agave-style scheme generator with: |
| 15 | - **pick colors from anywhere on screen (only on x11 because I'm lazy)** | 15 | - Triads |
| 16 | - alpha channel support | 16 | - Complements |
| 17 | - save and manage favorite colors | 17 | - Split Complements |
| 18 | - copy hex color codes to clipboard | 18 | - Tetrads |
| 19 | - clean, minimal interface | 19 | - Analogous |
| 20 | - Monochromatic | ||
| 21 | - large scheme preview cards showing hex, rgb, and hsv | ||
| 22 | - lighten, darken, saturate, desaturate quick actions | ||
| 23 | - color history navigation (back/forward) | ||
| 24 | - random color generation | ||
| 25 | - palette browser with built-in web-safe, tango, and visibone-style sets | ||
| 26 | - favorites panel with add/remove/clear | ||
| 27 | - favorites export to GIMP `.gpl` (`~/.config/kjagave-favorites.gpl`) | ||
| 28 | - clipboard copy/paste for hex colors | ||
| 29 | - screen picker support on X11 (`xcolor` or `grabc`) | ||
| 20 | 30 | ||
| 21 | ## requirements | 31 | ## requirements |
| 22 | 32 | ||
| @@ -53,12 +63,10 @@ go build -o kjagave main.go | |||
| 53 | 63 | ||
| 54 | ## usage | 64 | ## usage |
| 55 | 65 | ||
| 56 | 1. use the color picker button to open the full color selection dialog | 66 | 1. pick a base color with the color button, hex entry, palette list, or screen picker |
| 57 | 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 | 67 | 2. choose a scheme type from the combo box |
| 58 | 3. click "Copy to Clipboard" to copy the hex color code | 68 | 3. click any preview card to promote that scheme color to the active base color |
| 59 | 4. click "Save..." to save the current color to your favorites list | 69 | 4. use toolbar actions (`Back`, `Forward`, `Random`, `Lighten`, `Darken`, `Saturate`, `Desaturate`, `Paste`) to iterate quickly |
| 60 | 5. expand "Saved Colors" to view and manage your saved colors | 70 | 5. add colors to favorites with `+`, remove with `-`, and export favorites with `Export GPL` |
| 61 | 6. select a saved color to load it in the picker | ||
| 62 | 7. click "Delete" to remove a selected saved color | ||
| 63 | 71 | ||
| 64 | saved colors are stored in `~/.config/kjagave.json` as json. | 72 | state and favorites are stored in `~/.config/kjagave.json`. |