coolwuzizai/maidong-ktv

Maidong KTV is a local karaoke app built for Android TV boxes and other landscape-screen devices used for song selection at karaoke setups. It is designed to be controlled entirely with a TV remote, letting a person browse a song library, queue up songs, download tracks, and play them back reliably on a big screen. The README states plainly that the app is free and open source for personal learning and technical exchange, and it forbids anyone from selling it, bundling it into hardware, or charging for technical support. It warns that if someone paid money for this app, they were scammed and should report the seller and ask for a refund. Full license terms are kept in the project's LICENSE file. On the home screen, users can browse a chart of popular songs, search by song title or singer, look through categories, check songs they often sing, and see saved favorites. There is also a section for songs stored locally on the device. Search supports filtering by language, paging through long lists, and typing the first letters of a song's name to jump to it quickly. Each singer has their own page showing their photo and their available songs. For playback, the app uses a media player component to handle both local files and downloaded songs. It can run in a small window or full screen, and switching between pages does not interrupt a video that is already playing. It supports pausing, skipping, replaying a song, and switching between the original vocal track and an instrumental version. Songs can be downloaded in the background with progress shown, and the app can resume a broken download or retry one that failed. It also lets a person scan for songs on external USB drives, manage available storage space, and set songs to delete automatically to free up room. Settings cover things like how the song library updates, playback behavior such as automatic full screen and video ratio, volume rules for instrumental tracks, and interface options like language and on screen carousel banners. The README closes with a note thanking users for their support and a casual request for donations.