Skip to content

Home

Jump to bottom
Debs Gayen edited this page Mar 15, 2026 · 18 revisions

Welcome to the ChromaScape wiki!

This project prioritizes code clarity, customizability, and full user control -> offering an alternative to bloated or closed source clients. It also serves as a practical way to learn and apply essential programming principles such as object oriented design, dependency injection, the single responsibility principle, and more.

Project Architecture

ChromaScape is split into clean modular layers:

  • controller: Manages stateful core utilities and safely dispatches them.
  • base: Abstract base for all user scripts.
  • utils.core: Single-purpose utilities like VirtualMouseUtils, TemplateMatching, etc.
  • utils.domain: Feature-level abstractions like ZoneManager, based on multiple core utilities.
  • utils.actions: Reusable code snippets useful in any script.
  • web: Hosts the local UI and handles script serving + the colour picker.
  • scripts: This is where you keep your scripts.
  • api: API connections such as DAX for the walker.

Diagram

ChromaScape

Getting Started

Scripting Guides

Core Concepts & Tools

  • Colour Picker
    How to take a screenshot, define HSV ranges, and create reusable colour profiles.
  • ZoneManager & SubZoneMapper
    Explanation of how screen regions are mapped and the quirks of Zones.
  • Discord Notifications
    With less than 5 minutes of setup, send yourself notifications from within your scripts.

Community

Clone this wiki locally