PyQt Color Picker

Simple Color Picker Widget created with PyQt to easily get color input from the user.

Usage

1. To use the Color Picker Widget in a PyQt project make sure you have the PyQt5 or PyQt6 library:

   pip install PyQt5
   

   pip install PyQt6
   

   then add the colorpicker folder of your PyQt version into your project folder and import ColorPicker

   from colorpicker import ColorPicker

2. To add the widget to your app, create a 360x200 placeholder widget in your ui and add the colorpicker to it. When initializing the Color Picker you have the option to pass an initial color to it.

   colorpicker = ColorPicker(my_placeholder) # initial color is black
   
   colorpicker = ColorPicker(my_placeholder, rgb=(255,127,0))     # Use RGB
   colorpicker = ColorPicker(my_placeholder, hsv=(90,80,20))      # Use HSV
   colorpicker = ColorPicker(my_placeholder, hex="33ff88")        # Use Hex

   You can then run getRGB/getHSV/getHex method to get the currently selected color:

   current_color = colorpicker.getRGB()

• getRGB returns a rgb tuple with values from 0-255,

• getHSV returns a hsv tuple with values from 0-100,

• getHex returns a string without hashtag.

• You can customize the ranges easily:

  hsv = colorpicker.getHSV(360,1)  # hue in degrees, saturation & value from 0 to 1
  rgb = colorpicker.getRGB(100)    # rgb in percent
  hex = colorpicker.getHex(True)   # use hashtag in string

• You can also set the current color:

  colorpicker.setHSV((50,20,80))      # 0-100
  colorpicker.setRGB((221,34,21))     # 0-255
  colorpicker.setHex("dd3322")        # no hashtag

• Use ColorPicker's colorChanged signal to update directly when the user changes the color:

  colorpicker.colorChanged.connect(my_function)
  
  def my_function():
    print(colorpicker.getColor())

• For an example with a bigger application based on a main class, look at the example.py file.

^{Why should you consider using Qt6 | Scaling Issues?}