hyprpicker

You can install hyprpicker directly from the Arch Linux repositories using pacman.

sudo pacman -S hyprpicker

To build hyprpicker manually, you must first install the following dependencies:

• cmake
• pkg-config
• pango
• cairo
• wayland
• wayland-protocols
• hyprutils
• xkbcommon

Follow these steps to build and install the binary:

# Configure the build directory
cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr -S . -B ./build

# Build the project using all available CPU cores
cmake --build ./build --config Release --target hyprpicker -j`nproc 2>/dev/null || getconf _NPROCESSORS_CONF`

# Install the binary
cmake --install ./build

To automatically copy the selected color to your clipboard, use the -a or --autocopy flag.

Requirement: This feature requires the wl-copy command to be installed on your system.

$ hyprpicker -a

To use hyprpicker, run the command in your terminal. Upon invocation, your cursor will transform into a magnifying lens. Click on any pixel on your screen to select its color. The selected color will be printed to standard output (stdout).

$ hyprpicker

Hyprpicker allows you to define both the color space and the string template used for output.

1. Set the color space using --format (or -f). Supported values: cmyk, hex, rgb, hsl, hsv.
2. Set the template using --output-format (or -o). This uses a format string where {0}, {1}, {2}, and {3} correspond to the color components.

Default templates based on format:

• cmyk: {0}% {1}% {2}% {3}%
• hex: #{0}{1}{2}
• rgb: {0} {1} {2}
• hsl: {0} {1}% {2}%
• hsv: {0} {1}% {2}%

# Example: Custom RGB output format
hyprpicker -f rgb -o "rgb({0}, {1}, {2})"

Common usage patterns for hyprpicker:

Basic color pick:

$ hyprpicker

Get a pixel's color in HSL, wrapped in a CSS function: This example uses sed to transform the raw HSL output into a valid CSS hsl() string.

$ hyprpicker -f hsl | sed 's/^/hsl(/; s/$/)/; y/ /,/'

The following members control the visual appearance and scaling of the color picker interface:

• m_fZoomScale: A float determining the magnification level (default is 10.0).
• m_iCircleRadius: An integer defining the radius of the selection circle (default is 100).
• m_bFancyOutput: A boolean to enable/disable fancy output rendering.

Use the -c or --cursor flag to include the cursor in the frozen preview during the selection process.

$ hyprpicker -c

The CHyprpicker class manages several boolean configuration flags that control the application's behavior. These flags determine how the picker interacts with the system and how it renders:

• m_bAutoCopy: Automatically copy the selected color to the clipboard.
• m_bNotify: Send a notification when a color is picked.
• m_bRenderInactive: Render the picker surface even when it is not the focused window.
• m_bNoZoom: Disable the zoom effect.
• m_bNoFractional: Disable fractional scaling support.
• m_bDisablePreview: Disable the color preview.
• m_bUseLowerCase: Use lowercase for hex color codes.
• m_bIncludeCursor: Include the cursor position in the color selection.
• m_bCopyStandardColorName: Attempt to copy the standard color name along with the color value.

When configuring hyprpicker, you can specify the format of the color output using the eOutputMode enumeration. The supported modes are:

• OUTPUT_CMYK (0)
• OUTPUT_HEX (1)
• OUTPUT_RGB (2)
• OUTPUT_HSL (3)
• OUTPUT_HSV (4)

enum eOutputMode : uint8_t {
    OUTPUT_CMYK = 0,
    OUTPUT_HEX,
    OUTPUT_RGB,
    OUTPUT_HSL,
    OUTPUT_HSV,
};