A local karaoke application for Android TV and landscape song-selection devices
Remote Control · Song Discovery · Request Queue · Download Management · Stable Playback
## Core Features - Full TV remote navigation with directional keys, confirmation, back, and long-press actions. - Consistent focus feedback for buttons, lists, cards, switches, and dialogs. - Home entries for charts, song titles, singers, frequently played songs, favorites, categories, and local songs. - Online and local search with language filters, paging, and initial-letter keyboard input. - Singer browsing with portrait tags and singer-specific song lists. - Song ordering, batch ordering, queue prioritization, favorites, and file management. - Real-time synchronization across queued, played, and downloaded song lists. - New requests join the end of the queue without interrupting the current requested song. - Automatic playback when requested songs are available, including smooth transitions from public playback. ## Playback - IJK-based playback for local and downloaded songs. - Continuous playback while navigating between pages or switching between windowed and full-screen modes. - Play, pause, skip, replay, progress display, and seeking controls. - Original-vocal and accompaniment switching without changing the current play or pause state. - Synchronized playback state across windowed controls, full-screen controls, and status overlays. - Song title overlays, temporary mode prompts, and persistent pause indicators. - Video ratio, automatic full screen, audio-video synchronization, and public playback settings. - Maximum song volume and configurable original-vocal and accompaniment behavior. ## Downloads And Data - Background downloads with progress, resume support, and automatic retry. - Automatic cleanup and retry after download or decryption failures. - Recognition, counting, and playback of downloaded local songs. - Segmented database download, verification, merge, and atomic update. - Directory creation, database scanning, and download startup only after storage permission is granted. - Local disk and USB song scanning, reserved storage settings, and automatic cleanup. - Unified Maidong KTV data storage to avoid conflicts with other applications. ## Settings - Data settings for library updates, local scanning, reserved space, automatic cleanup, and database maintenance. - Playback settings for public playback, automatic full screen, video ratio, synchronization, and title overlays. - Sound settings for volume behavior, maximum song volume, original vocals, and accompaniment. - Interface settings for language, floating controls, carousel content, and song title overlays. - Dialog selections remain temporary until confirmed and provide clear remote-control focus feedback. ## Interface And Interaction - Landscape TV layout optimized for long-distance viewing. - Consistent state and meaning across top, windowed, and full-screen playback controls. - Stable focus during list refreshes, paging, tab changes, and song ordering. - Focus changes color only and preserves each control's original dimensions, corners, and layout. - A consistent circular Maidong logo across the home screen, player, and application information. ## Project Notice > **This repository**: [https://gitea.kasugano.cn/zijunchiang/maidong-ktv](https://gitea.kasugano.cn/zijunchiang/maidong-ktv) > > **UI/feature framework credit**: [https://gitee.com/yangyachao-X/maidong-ktv](https://gitee.com/yangyachao-X/maidong-ktv) > > This repository reworks the upstream "Maidong KTV" UI and feature framework, and the core/data layer was > rewritten with **DSH (DeepSeek Harness)**: library sync, song-source integration, device auth, > risk-control handling, remote logging, and ad blocking are all new implementations. Highlights of the reworked data layer: - **Library**: synced exclusively from the official Muse service (`mconn.cherryonline.cn` `mls-api/v1/sqlite/sync`); the code host carries source only, no database files. - **Song source**: `w.w345.my` (`i.php` token → `do.php` playback URL) with fixed device identity and reproduced signing; ad/mismatched resources (e.g. `wb66.cn/.../719.ts`) are blocked and retried. - **JS hot-update**: `app/src/main/assets/mobile/ktv_api.js`, requires the `KTV_BRIDGE_API: 7` marker. ## Building Requirements: JDK 17, Android SDK (`compileSdk 35`, `minSdk 21`, `targetSdk 25`), Gradle wrapper 8.13 (bundled). ```bash cd maidong-ktv export JAVA_HOME=/path/to/jdk-17 export ANDROID_HOME=/path/to/android-sdk export ANDROID_SDK_ROOT=$ANDROID_HOME ./gradlew assembleRelease ``` The release signing config in `app/build.gradle` expects `../../ktv_keystore.jks` (one level above the repo root) with alias `ktv` / password `123456`; adjust paths or use `signingConfigs.debug` for a quick unsigned build. Output: `app/build/outputs/apk/release/app-release.apk` (dual ABI: `armeabi-v7a` + `arm64-v8a`). Install with `adb install -r