Python Color Picker

Python Color Picker adds color decorations, color picker support, and fast color conversion workflows for Python files in VS Code.

What It Supports

• Hex: #RGB, #RGBA, #RRGGBB, #RRGGBBAA
• 0x hex: 0xRRGGBB, 0xRRGGBBAA
• rgb() / rgba() (comma/space forms, slash alpha, percent channels)
• hsl() / hsla() (deg/rad/grad/turn hue units)
• Bare tuples: (r, g, b) and (r, g, b, a) (configurable)

Quick Start

1. Open any .py file that contains colors.
2. Hover a color token to open the interactive hover palette.
3. Use:
   • Copy to copy any generated format,
   • Replace to replace in-place,
   • quick-fix actions (Convert color to ...) from the lightbulb menu,
   • color picker UI for direct picking,
   • command palette actions for conversion/palette generation.

Tutorial: Common Workflows

1) Convert one color to another format

1. Put cursor on a color or select a color token.
2. Run Python Color Picker: Convert Selection To Format.
3. Pick target format (hex, rgba, hsl, etc.).

2) Lock format for the current file session

1. Run Python Color Picker: Set Session Format Lock.
2. Choose hex, rgba, hsla, etc.
3. Replacements and presentations prioritize that lock.
4. Clear with Python Color Picker: Clear Session Format Lock.

3) Generate a palette block from one color

1. Put cursor on a color.
2. Run Python Color Picker: Generate Palette From Selection.
3. A palette dictionary with variants/harmony/opacity entries is inserted below the current line.

4) Rich hover exploration

Use rich mode to get:

• Base format list
• Variants (+/- lightness steps)
• More variants
• Complementary/analogous rotations
• Opacity quick actions
• Optional contrast badges

5) Bulk convert colors

1. Select one or more ranges and run Python Color Picker: Convert Colors In Selection, or run Python Color Picker: Convert Colors In File.
2. Pick target format (hex, rgba, hsl, etc.).
3. The extension converts all detected color tokens in scope and skips already-matching tokens.

Commands

• Python Color Picker: Set Session Format Lock
• Python Color Picker: Clear Session Format Lock
• Python Color Picker: Convert Selection To Format
• Python Color Picker: Convert Colors In Selection
• Python Color Picker: Convert Colors In File
• Python Color Picker: Generate Palette From Selection
• Python Color Picker: Open Settings

Key Settings

Parsing and detection

• pythonColorPicker.scanInStringsAndCommentsOnly
• pythonColorPicker.detectBareTuples
• pythonColorPicker.supportedFormats
• pythonColorPicker.maxFileSizeKB

Output and format behavior

• pythonColorPicker.preferredFormat
• pythonColorPicker.defaultFormatLock
• pythonColorPicker.showOnlyRelevantFormats
• pythonColorPicker.hexAlphaOrder

Hover behavior and personalization

• pythonColorPicker.hoverMode (rich or compact)
• pythonColorPicker.showScrollCues
• pythonColorPicker.variantSteps
• pythonColorPicker.harmonyAngles
• pythonColorPicker.opacityPresets
• pythonColorPicker.showContrastBadges