Super Color Picker for Aseprite (Script)

Updated to Version 1.5 — See the “New in v1.5” section below!

Ditch the boring color picker and revolutionize your workflow! Super Color Picker is a powerful Aseprite script that instantly generates stunning, harmonized color ramps based on your selected color. Say goodbye to UI jitter and hello to smart, perceptually-uniform palettes that just work.

---

🆕 New in v1.5

• Pro Wheel with HSL: New Hue° / Sat% / Light% sliders + Reset HSL that restores the values from when the wheel opened.
• Shade Markers (restored): Radial markers inside the wheel show your current Base ramp shades toward the center.
• Wheel Markers & Toggles: Optional markers for Complement and Triads around the ring.
• Hard Width Lock Everywhere: The main dialog keeps a fixed width even when changing colors from the wheel — no layout jitter.

---

✨ Jaw-Dropping Features ✨

• Rock-Solid, Jitter-Free UI: Choose between Normal and ultra-sleek Compact modes. The UI is locked to a fixed width so you can create without layout shifts.

• 🧠 Instant Color Harmonies: Magically generate incredible color schemes with a single click!

  • Base: Value-aware cooler/warmer variations of your current hue.
  • Complementary: Instantly find the perfect contrast.
  • Base → Complement Bridge: Smooth transition from Base to Complement along the shortest hue arc.
  • Triadic A & B: Build rich, balanced palettes with two distinct triadic options.

• Perceptually Perfect Palettes: Value-aware spacing keeps each step visually distinct — no muddy, indistinguishable shades.

• ⚡ Seamless Workflow Integration:

  • Auto-Sync: Ramps update whenever you change your Foreground color.
  • Pause Pick: Found the perfect swatch? Temporarily pause auto-sync so you won’t lose it.
  • Wheel: Fine-tune with HSL sliders, toggle Complement/Triads/Shade markers, drag to preview and release to commit.

---

🎨 Mastering Your Colors

Core Controls

• Compact: Toggle the super-narrow layout.
• Auto FG: Keep ramps synced to the Foreground color.
• Pause pick: Freeze auto-sync after clicking a swatch.
• Use FG: Manually rebuild ramps from your current Foreground color.
• Wheel: Open the hue wheel with HSL sliders, Complement/Triads/Shade markers, and fast drag preview.

Fine-Tuning Your Ramps

• Step (°): Hue distance between swatches. Bigger number = more dramatic shifts.
• Min Δ: Minimum perceived brightness difference between steps.
• Slope (%): Adds a gentle value gradient across each ramp.

Picking Colors

• Hover a swatch for a zoomed preview.
• Click a swatch to set it as your new Foreground.
• On the Wheel: Drag to preview instantly; release to commit. Use Reset HSL to revert to the wheel’s starting state.

---

✅ Compatibility

• Works flawlessly with Aseprite 1.3+.
• Ready for Windows, macOS, and Linux.

---

📜 License & Credits

• License: MIT
• Author: William P. McCollom (FBEpyon)
• Huge thanks to the Aseprite team and community for their amazing work!

🤖 AI-Assisted Development

Generative AI was utilized during development for code verification, debugging assistance, and documentation refinement.

Please do not claim as your own. A lot of time has gone into making this happen — please respect the development of this product. Thank you!