Color Picker - Vicinae Extension

Pick any color from your screen and copy as hex to clipboard.

Features

• 🎨 Pick colors from anywhere on your screen
• 📋 Automatically copy hex value to clipboard
• 🕐 View color history
• 🌊 Works on wlroots-based compositors (Hyprland, Sway, River, etc.)

Installation

Option 1: Download Release (Easiest)

1. Download the latest release from GitHub Releases
2. Extract the archive

   tar -xzf color-picker-vicinae-v*.tar.gz

3. Copy the color-picker folder to ~/.local/share/vicinae/extensions/

   cp -r color-picker ~/.local/share/vicinae/extensions/

4. Reopen Vicinae (close and open the window)

Option 2: Build from Source

1. Clone the repository

   git clone https://github.com/psampir/color-picker-vicinae.git
   cd color-picker-vicinae

2. Install dependencies and build

   npm install
   npm run build

3. The extension is automatically installed to ~/.local/share/vicinae/extensions/color-picker

Prerequisites (Required for both options)

This extension requires the following tools to be installed:

# Arch Linux / CachyOS
sudo pacman -S grim slurp imagemagick

# Fedora
sudo dnf install grim slurp ImageMagick

# Ubuntu/Debian
sudo apt install grim slurp imagemagick

# NixOS
nix-shell -p grim slurp imagemagick

Note: These system tools are required for the extension to work, regardless of installation method.

Usage

1. Open Vicinae launcher
2. Type "Color Picker" or use the shortcut
3. Click on "Pick Color from Screen"
4. Click on any pixel on your screen
5. The hex value is automatically copied to your clipboard

Development

# Install dependencies
npm install

# Development mode with hot reload
npm run dev

# Build production bundle
npm run build

# Lint
npm run lint

Requirements

• Vicinae >= 0.19.0
• wlroots-based Wayland compositor (Hyprland, Sway, River, etc.)
• grim (Wayland screenshot tool)
• slurp (Wayland region selector - requires zwlr_layer_shell_v1 protocol)
• ImageMagick (color extraction)

Desktop Environment Compatibility

✅ Supported:

• Hyprland
• Sway
• River
• Other wlroots-based compositors

❌ Not Supported:

• GNOME (Mutter compositor)
• KDE Plasma (KWin compositor)

Why? The extension uses slurp for point selection, which requires the zwlr_layer_shell_v1 Wayland protocol. This protocol is only available in wlroots-based compositors. GNOME and KDE use their own compositor protocols that are not compatible with slurp.

Support for GNOME and KDE may be added in future versions using compositor-specific tools.

License

MIT