explaingit

std-microblock/chromatic

8,287C++Audience · developerComplexity · 4/5Setup · moderate

TLDR

A C++ injection framework for Chromium-based desktop apps that hooks into the V8 engine to enable plugin and theme support, demonstrated as BetterNCM, a plugin manager for the NetEase Cloud Music app on Windows.

Mindmap

mindmap
  root((chromatic))
    What it does
      Chromium app modifier
      V8 engine injection
      Plugin management
    Tech Stack
      C++
      Chromium
      V8
    Use Cases
      NetEase Music plugins
      Custom themes
      App extension
    Audience
      Plugin developers
      Power users
      C++ developers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Install community plugins and custom themes into the NetEase Cloud Music Windows desktop app via the BetterNCM manager.

USE CASE 2

Use Chromatic as a foundation to build a plugin system for any other Chromium-based or Electron desktop application.

USE CASE 3

Develop custom plugins for NetEase Cloud Music by placing them in the managed plugin directory.

USE CASE 4

Extend the behavior of a Chromium-based app at the browser engine level without modifying the original app files.

Tech stack

C++ChromiumV8

Getting it running

Difficulty · moderate Time to first run · 30min

Windows only, end users install via the BetterNCM Installer one-click tool.

In plain English

This project is a universal modifier for Chromium-based applications and the V8 JavaScript engine. The idea is that it can inject code and behavior into any app built on the Chromium browser framework, which covers a large number of desktop applications today. The repository description calls it a broad-spectrum injection tool, meaning it is not narrowly tied to one specific app but can be adapted to many targets. The README is written almost entirely in Chinese and describes a specific use case called BetterNCM, which is a plugin manager for the PC version of NetEase Cloud Music. NetEase Cloud Music is a widely used Chinese music streaming application. BetterNCM uses the underlying Chromatic injection framework to let users install plugins and themes into that music client, extending it in ways the original app does not support. Installation on Windows is handled through a separate one-click tool called BetterNCM Installer. After installing, users can find plugin management in the app's settings. Plugin and theme developers can place their work in the relevant directory and the manager picks them up. The project is written in C++ and targets a low level of the software stack, hooking into the browser engine rather than modifying the app at a higher level. This approach makes the modifier potentially reusable across different Chromium-based apps, not just the one shown in the README. The README is sparse and provides only brief installation and development guidance, with most detail deferred to an external plugin repository and a linked example project. It does not include architecture documentation or a full API reference.

Copy-paste prompts

Prompt 1
I want to build a plugin for BetterNCM. Show me the basic file structure and metadata a plugin needs to be recognized by the manager.
Prompt 2
How does Chromatic inject code into a Chromium-based app at the V8 engine level? Give me a high-level C++ walkthrough.
Prompt 3
What's the difference between hooking at the Chromium engine level the way Chromatic does versus injecting via a browser extension?
Prompt 4
Show me how to write a simple BetterNCM theme that changes the background color of the NetEase Cloud Music player.
Open on GitHub → Explain another repo

← std-microblock on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.