Grayjoy

Grayjoy is a Jetpack Compose and Material 3 rewrite of the Grayjay Android user interface. It keeps the JavaScript source/plugin machinery and other backend behavior derived from the original Grayjay project while shipping as a separate Android application.

Screenshots

The complete Android project is in grayjay-android/. The unpacked Chromium extension for local YouTube handoff is in browser-extension/; see its README.md for installation and pairing.

The optional offline voice companion is in grayjay-android/voice-companion/. Install the separate Grayjoy Voice APK from the same GitHub release, then enable voice access in Grayjoy and download the selected speech models in the companion. Voice control is off by default; the companion supports Android 9 or later on ARM64 and x86-64 devices. See its setup guide.

Build

Requirements:

• Android SDK
• JDK 21

From the repository root:

cd grayjay-android
./gradlew :app-compose:assembleDebug

On Windows, use gradlew.bat instead of ./gradlew. The debug APK is produced under grayjay-android/app-compose/build/outputs/apk/debug/.

The Compose application uses the package com.futo.platformplayer.compose, so it can be installed alongside the official Grayjay application.

Project layout

• grayjay-android/app-compose/ — Compose/Material 3 application and UI.

• grayjay-android/voice-companion/ — optional offline voice assistant and local MCP client.

• grayjay-android/grayjay-engine/ — compatibility layer around the legacy Grayjay plugin and playback backend.

• grayjay-android/app/ — upstream backend sources reused by the engine build.

• grayjay-android/app/src/*/assets/sources/ — vendored JavaScript source plugins for stable and unstable builds.

• grayjay-android/dep/ — vendored Polycentric and FUTO Pay dependencies.

• grayjay-android/docs/compose-rewrite.md — rewrite architecture and notes.

• browser-extension/ — Manifest V3 YouTube handoff and PC remote-control extension. It communicates directly with Grayjoy over the local network.

The snapshot vendors the external source and dependency repositories directly. It does not require Git submodule initialization, and the bundled AAR files are stored as ordinary files rather than unresolved Git LFS pointers.

Attribution and license

This is an independent derivative project based on FUTO's Grayjay Android project. Grayjay and its original source remain the work of their respective copyright holders. See grayjay-android/LICENSE.md for the license included with the source snapshot.