Neuro(demo) is an interactive image-to-sound instrument for Android. Choose an image, then touch or slide across it to play tones derived from each pixel's position and RGB color. The repository and application ID remain ColorMusic / com.colormusic.game for upgrade compatibility.
- Current release: 1.7
- Platform: Android only
- Resolution: automatically adapted; tested on
2944 x 1840tablets and2800 x 1260phones - Recommended architecture:
arm64-v8a - Application ID:
com.colormusic.game
The first launch defaults to English. Use the flag button in the top-right menu to switch between English and Chinese; the selection is saved locally for subsequent launches.
- Position-aware performance: horizontal position controls pitch and vertical position controls volume.
- RGB-driven timbre synthesis with independent R/G/B wavetable editing.
- A 29-sample drum library covering TR-808, TR-909, TR-606 / RD-6, acoustic, Boom-Bap, Trap, Lo-fi, and special percussion.
- Per-channel drum waveform preview with real-time volume and playback-speed shaping through the existing effect chains.
- Touch, hold, multi-touch, and slide performance with continuous pitch updates and a physical 2.5 cm radial grid response.
- Configurable grid with pitch/volume rulers, colors, opacity, density, edge gestures, minimum line visibility, and adaptive ruler typography.
- Per-channel global effect chains plus four final output effect slots.
- Built-in presets, random generation, undo/reset, calibration, and an in-app bilingual guide.
- Responsive landscape and portrait layouts that preserve button and text proportions.
- Native Android
AudioTracksynthesis with WebAudio fallback for editor/browser preview. - Recording plus a 13-track timeline editor with drag-and-drop blocks, mute/solo, snapping, automation, trim, speed, color, WAV export, and Android MP3 export.
- Configurable time-signature/BPM metronome with monitor-only clicks and strong/secondary-accent grid animations.
- Unified file management for styles, style flows, complete track arrangements, and exported WAV/MP3 audio.
- Style and style-flow management with preview, rename, load, delete, and timed transitions.
- Automatic resolution-aware landscape UI spacing and typography.
- An immersive UI lock that leaves only the performance grid and unlock control visible.
ColorMusic is intended to run on Android devices. The included native audio bridge, system image picker, and touch layout are not supported on iOS, desktop, or other platforms.
For building from source:
- Cocos Creator 3.8.8
- Android SDK and NDK 23.2.8568313
- JDK 17
- Gradle wrapper included in the generated Android project
From the project directory, configure the Android paths in .tooling/build-android.json, then run:
$env:JAVA_HOME = 'C:\Path\To\JDK17'
& 'C:\Path\To\CocosCreator.exe' `
--project (Get-Location).Path `
--build 'platform=android;configPath=.tooling/build-android.json' `
--nologinThe generated Android project is under build/android. To assemble the debug APK directly:
Set-Location build/android/proj
& .\gradlew.bat ':ColorMusic:assembleDebug' --no-daemon --console=plainThe APK is generated at:
build/android/proj/build/ColorMusic/outputs/apk/debug/ColorMusic-debug.apk
Install it on a USB-debugging Android device with:
& 'C:\Path\To\adb.exe' install -r `
'build/android/proj/build/ColorMusic/outputs/apk/debug/ColorMusic-debug.apk'Version 1.7 replaces the old app-private export layout with one player-selected Neuro_Save folder. Open File Manager from the console lines button, then use Save Location to choose where that folder should be created. Android remembers the selected location and grants the game persistent access.
The game creates four subfolders:
Neuro_Save/
├── Neuro_Music/ Exported WAV and MP3 audio
├── Neuro_Style/ Complete performance styles
├── Neuro_Style_Flow/ Timed style-flow sequences
└── Neuro_Track/ Complete audio-track arrangements
File Manager uses three columns: the left column selects Styles, Style Flows, Tracks, or Audio; the middle column contains save/create, open-folder, and clear actions; the right column lists the files in that category.
- Styles and style flows retain preview, rename, load, and delete controls.
- Track arrangements can be saved, renamed, loaded, and deleted without a preview.
- Audio lists only WAV/MP3 files exported by the game. It supports rename, WAV/MP3 conversion, deletion, seekable playback, and elapsed-time display.
- Compatible files copied into the matching subfolder are read directly the next time File Manager is opened.
- Exported track audio is written to
Neuro_Music. Recorded source clips remain internal working files and are not shown in the managed Audio list.
Clearing a category deletes its managed files and cannot be undone. Back up files outside Neuro_Save before clearing a list.
ADB is optional. You can also install the release package directly:
- Download
Neuro-demo-1.7-arm64-v8a.apkfrom the v1.7 release on the Android device, or transfer the APK to the device over USB, cloud storage, or a messaging app. - Open the APK in the device's file manager and confirm Install.
- If Android blocks the installation, enable Allow from this source for the file manager or browser when prompted, then retry.
The package is signed as a debug APK for this release build. Android may ask you to uninstall a package signed with a different key before installing it.
assets/scripts/GameManager.ts Main UI, touch mapping, image performance
assets/scripts/NativeBridge.ts JS/native bridge and WebAudio fallback
assets/scripts/DrumLibrary.ts Drum-kit catalog and waveform metadata
assets/scripts/SynthMapping.ts Position and color to sound mapping
assets/scripts/GridSettings.ts Grid configuration UI and persistence
assets/scripts/FxUI.ts Wavetable and effect-chain UI
native/engine/android/app/src/... Android activity, bridge, and AudioTrack synth
native/engine/android/app/drum-assets Bundled redistributable drum samples
.tooling/build-android.json Reproducible Android build configuration
- Open the round menu and choose an image.
- Touch the image to play; hold and slide for a sustained, continuous note.
- Open Settings for Wavetable, Grid, and Output FX configuration.
- Open How to Play for the in-app reference guide.
- Use Calibrate if the device orientation or touch mapping needs correction.
The repository publishes releases 1.0 through 1.7. Releases 1.0 and 1.1 are preserved as the APK archives supplied for those versions; active source documentation follows the current 1.7 tree.
No open-source license has been selected yet. Until a license is added, all rights are reserved by the copyright holder.