ClipMatrix

ClipMatrix is an Android application for customizing what appears on the Glyph Matrix of the Nothing Phone (4a) Pro. It combines clock, charging, notification, music, and animated pet experiences in one configurable app instead of presenting itself as a single-purpose Glyph Toy.

Compatibility

ClipMatrix is built exclusively for the Nothing Phone (4a) Pro (A069P) running a supported Nothing OS build. The app checks the device model at runtime and shows an unsupported-device screen everywhere else.

Features

Clock

• Stacked hour and minute display
• System, 12-hour, and 24-hour formats
• Always returns as the fallback when no higher-priority state is active

Charging

• Configurable battery milestones
• Circular charging progress indicator
• Adjustable display duration and brightness
• Clean, compact 100% charge face

Notifications and calls

• Counts notifications from user-selected applications
• Adjustable display duration and brightness
• Configurable face priority
• Concerned puppy reaction for an active call or five or more selected notifications

Music

• Live audio waveform on the Glyph Matrix
• YouTube Music and Spotify source controls
• Adjustable frame rate and brightness
• Audio samples are analyzed in memory and are not stored

Animated puppy

• Random appearances with separate minimum and maximum wait times
• Adjustable stay duration and brightness
• Seven animated moods: playful, curious, sleepy, happy, dancing, concerned, and angry
• Smart reactions for calls, notification overload, charging, low battery, and music ending
• Deferred reactions and appearance deadlines survive higher-priority faces and Toy-service restarts
• A quick first greeting confirms the puppy is active before normal random scheduling begins
• Pickup greetings use the phone's low-power significant-motion sensor with a cooldown
• Playful and curious eyes follow the phone's tilt only while the puppy is visible
• Pocket/cover awareness pauses the puppy until the proximity sensor is clear
• Gentle night mode uses ambient light and time for sleepy animation and reduced brightness
• Adjustable smart reactions, night mode, stay duration, brightness, and appearance window

Companion application

• Hardware-style previews for every face
• Automatic preference saving
• Per-app notification selection
• Nothing Phone (4a) Pro compatibility gate
• Direct shortcut to the Nothing Glyph Matrix activation screen

Download and install

1. Open the latest ClipMatrix release.
2. Download the APK listed under Assets.
3. Allow APK installation from your browser or file manager when Android asks.
4. Install and open ClipMatrix.
5. Grant notification access and audio permission for the related features.
6. Tap Activate Toy and select ClipMatrix in Nothing Settings.

Nothing OS currently lists third-party Glyph Matrix applications inside its Always-on Glyph Toy settings screen. ClipMatrix uses that system integration point, but the application itself provides a multi-face Glyph Matrix customization experience.

Build from source

Requirements

• Android Studio with Android 16 / API 36.1 installed
• JDK 21 or Android Studio's bundled JDK
• Android Debug Bridge (adb) for command-line installation
• A Nothing Phone (4a) Pro for physical Glyph Matrix testing

1. Clone the project

git clone https://github.com/Sukhendu2002/ClipMatrix.git
cd ClipMatrix

2. Download the vendor SDK

The proprietary Glyph Matrix SDK is intentionally not committed to this repository. Download it from Nothing's official developer kit:

curl -L \
  https://raw.githubusercontent.com/Nothing-Developer-Programme/GlyphMatrix-Developer-Kit/main/glyph-matrix-sdk-2.0.aar \
  -o app/libs/glyph-matrix-sdk-2.0.aar

Review Nothing's terms in app/libs/GLYPH_SDK_LICENSE.md before using the SDK.

3. Build and verify

./gradlew testDebugUnitTest lintDebug assembleDebug

The debug APK is generated at:

app/build/outputs/apk/debug/app-debug.apk

4. Install on a connected phone

adb install -r app/build/outputs/apk/debug/app-debug.apk

Open ClipMatrix and use Activate Toy to select it in Nothing Settings.

Permissions

Permission or access	Purpose
Nothing Glyph permission	Render ClipMatrix faces on the Glyph Matrix
Notification access	Count selected notifications, detect calls, and observe supported media sessions
Record audio	Generate the live music waveform; audio is not stored

Contributing

Contributions are welcome. Read CONTRIBUTING.md for setup, testing, design, and pull-request guidance. Participation is governed by CODE_OF_CONDUCT.md. Report security issues privately as described in SECURITY.md. Release history is recorded in CHANGELOG.md.

Project structure

.github/                   CI, issue forms, and pull-request template
app/libs/                  SDK download instructions and vendor terms
app/src/main/              Kotlin source and Android resources
docs/images/app/           Application screenshots
docs/images/glyph/         Glyph face design references
docs/images/puppy/         Puppy source frames and previews
docs/ClipMatrix_PRD.md     Product and architecture notes

License

ClipMatrix source code is available under the MIT License.

The Nothing Glyph Matrix SDK is not covered by the MIT License and is not distributed in this repository. It remains governed by Nothing Technology Limited's separate terms in app/libs/GLYPH_SDK_LICENSE.md, including commercial-use and redistribution restrictions.