A command-line utility for changing the primary accent color in your desktop rice (customized Linux desktop setup). Palettro allows you to quickly switch between different accent colors across all your configured applications with a single command.

• Quick Color Switching ⚡: Change your primary accent color across your entire rice instantly
• Multi-Application Support 🔄: Update colors in multiple config files simultaneously
• Service Management 🛠️: Automatically restart applications after color changes
• Predefined Palette 🎭: Ships with a beautiful Catppuccin color selection
• Template System 📝: Uses template files to apply colors to your configurations

• Linux operating system 🐧

yay -S palettro-bin 
# or
paru -S palettro-bin 

wget https://github.com/arithefirst/palettro/releases/download/v1.0.0/palettro-linux-x86_64 -O palettro
# Optional sha256sum check
echo "41cf04b6ac6418ae489e623d328b270f72c1ebf3fa0beff0aaa3585f00c18067  palettro" | sha256sum --check
chmod +x ./palettro
sudo mv palettro /usr/local/bin/

git clone https://github.com/arithefirst/palettro
cd palettro
go build -o palettro
sudo mv palettro /usr/local/bin/

# Apply a color theme
palettro -color blue

# Show all available colors
palettro -showcolors

# Show all configured applications
palettro -showconfigs

# Use a custom config file
palettro -config /path/to/custom/config.json -color red

Palettro uses a JSON configuration file located at ~/.config/palettro/config.json. If this file doesn't exist, it will be created automatically with default settings.

{
  "colors": {
    "colorname": {
      "hex": "#ffffff",
      "rgb": "rgb(255, 255, 255)",
      "hsl": "hsl(0deg, 0%, 100%)"
    }
  },
  "configs": [
    {
      "name": "application-name",
      "path": "~/.config/app/",
      "restart": "application-binary"

      // The "restart" option is optional. Only put the name
      // of the binary if it dosen't auto-update config
      // files. Waybar, for example needs to be restarted 
      // for config changes to take affect. Hyprland, for 
      // example auto-updates when changes are detected.
    }
  ]
}

Palettro ships with the following color palette:

• rosewater - #f5e0dc 🌸
• flamingo - #f2cdcd 🦩
• pink - #f5c2e7 💖
• mauve - #cba6f7 🟣
• red - #f38ba8 🔴
• maroon - #eba0ac 🍷
• peach - #fab387 🍑
• yellow - #f9e2af 💛
• green - #a6e3a1 💚
• teal - #94e2d5 🐢
• sky - #89dceb ☁️
• sapphire - #74c7ec 💎
• blue - #89b4fa 🔵
• lavender - #b4befe 🪻

To add support for a new application:

1. Add an entry to the configs array in your configuration file
2. Run palettro -showconfigs to verify it was properly added and create the nessecary file structure
3. Create template files in ~/.config/palettro/[app-name]/
4. Use color variables in your templates that palettro can replace

Template Variables:

• ((PALETTRO.HEX)) - Hexadecimal format (e.g., 89b4fa)
• ((PALETTRO.HEXTRANS)) - Hexadecimal format with transparency value (e.g., 89b4faff)
• ((PALETTRO.RGB)) - RGB format (e.g., 137, 180, 250)
• ((PALETTRO.RGBA)) - RGBA format (e.g., 242, 205, 205, 1)
• ((PALETTRO.HSL)) - HSL format (e.g., 217deg, 92%, 76%)

Example:

{
  "name": "waybar",
  "path": "~/.config/waybar/",
  "restart": "waybar"
}

When you run palettro -color blue, it reads template files from ~/.config/palettro/waybar/, replaces the color variables with blue's values, and writes the processed files to ~/.config/waybar/.

## Examples 💡

### Switching Themes

```bash
# Apply a blue theme to all configured applications
palettro -color blue

# Apply a red theme with custom config
palettro -config ~/my-themes.json -color red

# See all available colors
palettro -showcolors

# See all configured applications
palettro -showconfigs

We welcome contributions to palettro! This project is licensed under the GNU GPL 3.0.

1. Fork the repository
2. Clone your fork:

   git clone https://github.com/arithefirst/palettro
   cd palettro

3. Create a feature branch:

   git checkout -b feature/your-feature-name

4. Make your changes
5. Test your changes:

   go test ./...
   go build -o palettro
   ./palettro -showcolors

6. Commit and push your changes
7. Create a pull request

1. Code Style: Follow standard Go formatting (go fmt)
2. Documentation: Update documentation for new features
3. Error Handling: Use appropriate error handling patterns
4. Commit Messages: Use descriptive commit messages with the Conventional Commits standard

Please report bugs and feature requests through GitHub Issues. Include:

• Operating system and version
• Go version
• Steps to reproduce the issue
• Expected vs actual behavior
• Relevant configuration files

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

• Default color palette robbed from Catppuccin Mocha
• Built with Go's standard library and embedded resources