麦麦KTV是一款面向家庭娱乐、包厢点歌和大屏播放场景的 KTV 点歌应用。它把点歌、排队、播放控制、下载管理和歌库配置整合到同一套界面中，适合电视、投屏设备、桌面端和移动端的 KTV 使用场景。
当前仓库处于 Alpha 阶段，最新预发布版本已经提供 Android、macOS、Windows x64 和 iOS 测试分发包。
下图展示了麦麦KTV在“按歌名点歌”场景下的大屏界面。左侧保留视频预览和拼音首字母快捷检索区，右侧集中展示分类筛选、歌曲列表和播放控制，适合横屏电视、投屏设备或包厢点歌机使用。
- 已支持 Android、macOS、Windows x64 与 iOS 测试分发
- Windows x64 首个桌面测试包已接入 GitHub Releases
- iOS 已提供 unsigned IPA 测试包，便于真机安装验证
- iOS 本地媒体导入更稳定，改进了
.dat文件导入和目录扫描处理 - iOS 播放已切换到 MobileVLCKit 后端，兼容性更稳定
- 横屏播放布局与 KTV Shell 切换更稳定，减少预览区和控制层状态不一致
| 平台 | 当前状态 | 说明 |
|---|---|---|
| Android | 已发布 APK | 当前功能最完整；支持本地歌库、百度网盘、原唱/伴唱切换，以及单音轨 KTV 视频资源 |
| macOS | 已发布桌面包 | 适合桌面和大屏测试使用 |
| Windows x64 | 已发布桌面包 | 已提供首个 Windows 桌面测试包 |
| iOS | 已发布 unsigned IPA | 适合真机侧载测试；已支持本地媒体导入和当前播放器链路验证 |
- 仅 Android 支持单音轨 KTV 视频资源，其他平台暂不支持这类资源
- 当前所有平台分发包都属于 Alpha 预发布版本，主要用于测试和验证
- iOS 当前发布的是
unsigned IPA，用于测试交付，不是 App Store 正式分发包
首页提供清晰的点歌入口，用户可以按不同习惯快速进入歌库：
- 按歌名点歌
- 按歌星点歌
- 浏览本地歌曲
- 查看收藏歌曲
- 查看常唱歌曲
应用围绕点歌场景提供快速检索能力，减少翻页和查找成本：
- 支持按歌名搜索
- 支持按歌手搜索
- 支持中文和拼音首字母检索
- 在本地歌曲场景下可按文件名辅助查找
围绕 KTV 使用过程中的高频操作，应用内提供完整的播放控制能力：
- 播放 / 暂停
- 切歌
- 重唱
- 原唱 / 伴唱切换
- 当前播放状态展示
- 大屏预览与全屏播放衔接
- 横屏播放布局与控制层切换
这套控制能力适合包厢多人轮流点歌，也适合家庭场景下由一人统一控场。
点歌后，歌曲会进入统一的已点列表，方便随时查看和调整顺序：
- 展示当前播放歌曲
- 查看后续待播队列
- 支持将歌曲置顶
- 支持从队列中移除歌曲
- 支持在已点列表内继续搜索
- 下载中的歌曲会保留在列表中并展示进度
麦麦KTV支持多种歌曲来源，便于在不同使用环境下灵活组建歌库：
- 本地目录歌曲
- 百度网盘歌曲源
本地与云端歌曲可以纳入同一套点歌流程中，既适合已有本地曲库的场景，也适合按需从云端补充歌曲资源。
针对云端歌曲，应用内提供下载能力与任务管理能力：
- 支持将云端歌曲下载到本地
- 可查看未完成下载任务
- 可查看已下载歌曲列表
- 支持恢复下载、删除已下载内容等管理操作
- 下载未完成前，歌曲会保持明确的排队和就绪状态
为了提高复唱效率，应用内提供贴近 KTV 习惯的沉淀方式：
- 收藏歌曲，方便重复点唱
- 常唱歌曲聚合，快速回到熟悉曲目
设置页围绕“歌库配置”和“日常使用准备”展开：
- 配置本地歌曲目录
- 登录并接入百度网盘
- 设定云端歌曲根目录
- 查看和管理下载内容
- 查看关于页面和开源仓库入口
- 在设置中接入本地目录或百度网盘歌库
- 从首页进入歌名、歌星、本地、收藏或常唱入口
- 通过搜索快速找到目标歌曲并加入已点列表
- 在播放过程中随时切歌、重唱，或切换原唱与伴唱
- 对需要保留的云端歌曲执行下载，逐步沉淀为本地资源
- GitHub Releases: https://github.com/voidvon/maimai-ktv/releases
- 当前预发布包已包含 Android APK、macOS 桌面包、Windows x64 桌面包和 iOS unsigned IPA
- 版本变更记录见 CHANGELOG.md
flutter pub get
flutter analyze
flutter test按平台运行：
flutter run -d android
flutter run -d macos常用构建命令：
flutter build apk --release
cd ../ktv-player && flutter analyze && flutter test更多平台构建说明可参考：
麦麦KTV不是单纯的视频播放器，而是一套围绕“点歌 + 播放 + 下载 + 管理”完整展开的 KTV 使用体验。它希望把找歌更快、排队更清楚、播放更稳定、歌库更好管理这几件事统一起来，让用户更专注于唱歌本身。