_{✨ Click on a pixel on your screen and show its color value ✨}

farge is a command line tool which you can use to select a pixel on the screen and get the value of its color, in either hex or RGB format. The color code is automatically saved to the clipboard. If you want to save the color, farge is able to show the color in a image viewer with the color code on it. This tool is able to work with a variety of image viewers like feh, mpv, nsxiv and sxiv. It works on X11 and Wayland.

Dependencies

• bash
• bc
• imagemagick
• feh (Other: mpv, nsxiv or sxiv, but you must specify it using the --image-viewer flag)

If you use X11

• xcolor (https://github.com/Soft/xcolor)

If you use Wayland

• slurp (https://wayland.emersion.fr/slurp)
• grim (https://wayland.emersion.fr/grim)
• wl-copy (https://github.com/bugaevc/wl-clipboard)

Installation

Install as a package

farge is available in the Arch User Repository. If you use Arch or an Arch-based distro, you can use makepkg or your AUR helper of choice to install the farge-git package.

Install using make

# Clone the repo
$ git clone https://github.com/sdushantha/farge

# Change your current directory to farge
$ cd farge

# Install it
$ sudo make install

Install it locally

# Download the farge source code, save it as farge
# and make it executeable
$ curl -L https://git.io/raw-farge > farge && chmod +x farge

# Then move farge to somewhere in your $PATH
# Here is an example
$ mv farge ~/scripts/

Usage

$ farge --help
usage: farge [OPTIONS...]
 
┌─┐┌─┐┬─┐┌─┐┌─┐
├┤ ├─┤├┬┘│ ┬├┤ 
┴  ┴ ┴┴└─└─┘└─┘
Click on a pixel on your screen and show its color value

optional arguments:
   --help                show this help message and exit
   --no-preview          dont show the selected color in a preview window
   --no-color-code       dont write the color code on the preview window
   --rgb                 show the color code as RGB instead of HEX
   --image-viewer        image viewer to use to show the preview (feh, mpv, nsxiv, sxiv)
   --notify              send the color code as notification, where the icon is the selected color
   --expire-time         amount of time the notification should be visible, in milliseconds
   --stdout              output the color value to stdout
   --version             show the version of farge you are using

Tips

It would be smart to bind farge to a keybinding. Here is an example for i3wm users:

bindsym $mod+Shift+f --release exec farge

If you use a window manager, you can assign rules the windows so they are always floating. For i3wm user, put this in your config:

# Let the windows created by Farge be floating
for_window [instance="Farge"] floating enable

License

MIT License

Copyright © 2019 Siddharth Dushantha