Chromaflow - A Wallpaper Color Picker for Marble Shell Theme

October 25, 2024 ยท View on GitHub

A GUI tool that extracts colors from your wallpaper and applies them to the Marble GNOME Shell theme. This tool helps you create a cohesive desktop experience by matching your shell theme colors with your wallpaper.

Features

  • Interactive color picker with wallpaper preview
  • Integration with pywal color palette
  • Real-time color preview
  • All options from marble shell's intallation tweaks
  • Skibidi GUI

Screenshot

Screenhot

Prerequisites

  • Python 3.6+
  • Marble Shell Theme
  • pywal
  • PyQt5

You can install these packages with this command:

pip install pywal PyQt5

Installation

  1. Clone this repository:

    git clone https://github.com/Felixdiamond/chromaflow
cd chromaflow

  2. Make sure you have the Marble Shell Theme installed and its files are accessible.

  3. Copy chromaflow.py into marble the Marble Shell Theme github repo.

Usage

Basic usage:

python chromaflow.py --wallpaper /path/to/your/wallpaper.jpg

Full options:

python chromaflow.py --wallpaper /path/to/your/wallpaper.jpg \
                     --colors-path ./colors.json \
                     --mode dark \
                     --filled \
                     --name custom-theme \
                     --opaque \
                     --launchpad \
                     --panel_default_size

Arguments

  • --wallpaper: Path to your wallpaper image (required)
  • --colors-path: Path to Marble theme's colors.json (default: ./colors.json)
  • --mode: Theme mode, either 'light' or 'dark' (default: dark)
  • --filled: Use more vibrant accent colors (optional)
  • --name: Custom name for the theme (default: generated from wallpaper name and color)
  • -O, --opaque: Make background color opaque (default: translucent)
  • --launchpad: Change Show Apps icon to macOS Launchpad icon

Panel Customization

  • -Pds, --panel_default_size: Set default panel size
  • -Pnp, --panel_no_pill: Remove panel button background
  • -Ptc, --panel_text_color: Set panel text color

How to Use

  1. Run the script with your wallpaper path
  2. Click anywhere on the wallpaper image to select a color
  3. Alternatively, click on any color from the pywal palette
  4. The selected color will be shown in the preview with the hex and hsl
  5. Close the window to apply the selected color
  6. Follow the on-screen instructions to activate the theme

Applying the Theme

After running the script:

  1. Open the Extensions app
  2. Go to 'User Themes' settings
  3. Select your theme from the dropdown (default name combines wallpaper name and color)

Contributing

Feel free to submit issues, fork the repository, and create pull requests for any improvements.

Future Additions

  • A listener that automatically runs the script when you change your wallpaper and selects a random color.

Credits