一、简介KTV双屏点歌机是一款轻量级的局域网KTV系统仅需一个约12MB的可执行文件即可让整个局域网变成KTV。支持电脑手机双屏控制适合学校、公司、单位、集团内网等场景使用。下载地址https://download.csdn.net/download/weixin_43335288/93217765主界面效果图扫描点歌配置核心特性客户端零依赖电脑和手机均无需安装任何软件有浏览器即可使用双屏互动电脑作为播放屏手机扫码点歌多种点歌方式关键词搜索、拼音首字母搜索、歌手/语种/曲种分类浏览曲库自建支持多个磁盘目录支持网页上传歌曲GPU加速自动检测NVIDIA/AMD/Intel显卡硬件编码转码省流模式手机播放自动转码流媒体节省90%流量音频可视化歌词/波形/频谱条/频谱曲线四种模式颜色自定义16万曲库毫秒级搜索响应缓存秒级启动二、系统要求项目要求操作系统Windows 7/8/10/11运行环境无需安装双击即可运行FFmpegffmpeg.exe 和 ffprobe.exe 放在程序同目录非省流模式可不需要网络局域网环境所有设备在同一网段客户端任意现代浏览器Chrome/Edge/Firefox/Safari无需安装任何软件三、快速开始3.1 安装与启动将 ktv.exe 放到任意目录将 ffmpeg.exe 和 ffprobe.exe 放到同一目录双击运行 ktv.exe选择「3. 修改曲库文件夹」输入歌曲目录路径多个目录用逗号分隔选择「1. 启动服务器」控制台会显示访问地址例如http://192.168.0.47:83513.2 曲库缓存首次扫描曲库后系统会自动保存缓存文件。下次启动时可选择读取缓存快速启动— 秒级加载跳过磁盘扫描重新扫描曲库— 完整扫描适合曲库有变动时3.3 电脑端点歌在电脑浏览器中打开显示的地址推荐Chrome/Edge在搜索框中输入歌名或歌手名搜索点击歌曲即可加入播放队列点击「原唱」「伴奏」按钮切换音轨3.4 手机扫码点歌在电脑点歌页面点击「扫码点歌」按钮用手机微信或浏览器扫描二维码进入手机点歌页面搜索并点歌歌曲会自动加入电脑端的播放队列四、功能详解4.1 搜索点歌支持多种搜索和浏览方式关键词搜索输入歌名、歌手名支持多关键词空格分隔如「周杰伦 晴天」拼音首字母搜索输入拼音首字母即可匹配如输入「zgr」可找到「张国荣」同名歌曲区分自动在歌名后标注文件大小如 (450.2MB)文件越大通常画质越好4.2 歌手分类浏览点击「歌手」标签按首字母分类浏览所有歌手。歌手列表采用平铺按钮布局点击歌手名可查看其所有歌曲。4.3 语种分类浏览点击「语种」标签按语言分类浏览歌曲如国语、粤语、英语、日语、韩语等。文件名格式为「歌手-歌名-语种-歌曲类别」语种信息自动从文件名提取。4.4 曲种分类浏览点击「曲种」标签按歌曲类别浏览如流行歌曲、经典老歌、摇滚、民谣等。4.5 视频播放点播视频歌曲后系统自动在独立窗口打开视频播放器全屏播放MV视频。支持以下功能原唱/伴奏一键切换点击「原唱」「伴奏」按钮切换音轨切歌点击「下一首」或使用快捷键Ctrl↓重播点击「重播」按钮重新播放当前歌曲内嵌歌词实时显示歌曲含歌词时自动展示滚动歌词省流模式开启后视频实时转码为低码率流媒体4.6 播放队列管理播放队列显示在页面右侧实时显示当前播放状态置顶点击「置顶」按钮将歌曲移到队列最前删除点击「×」按钮从队列中移除歌曲随机点歌从曲库随机添加一首到队列末尾转码进度转码中的歌曲实时显示进度条4.7 音频播放器与可视化点播纯音频文件mp3/flac等后系统自动打开音频播放器提供四种可视化效果4.7.1 歌词模式当歌曲包含内嵌歌词时默认自动切换到歌词模式歌词随播放进度实时滚动。支持Lyrics3和ID3v2 USLT歌词格式。无歌词时自动回退到波形模式。4.7.2 波形模式实时音频波形显示支持100ms/200ms/500ms/1s时长选择展示不同时间跨度的音频振幅变化。4.7.3 频谱条模式实时频谱分析采用对数频率刻度支持64/128/256/512条分辨率。底部标注频率刻度100Hz~10kHz。4.7.4 频谱曲线模式将频谱数据以平滑曲线形式展示曲线下方带渐变填充支持快速曲线高性能和平滑曲线精细无锯齿两种样式。4.7.5 频谱自定义选项峰值着色开关开启时按幅度排名分色红→黄→蓝关闭时所有频谱条统一颜色频谱颜色选择预置7种常用色蓝/青/绿/紫/红/橙/黄支持自定义任意颜色频谱条数选择64/128/256/512条条数越多频率分辨率越高曲线样式快速曲线lineTo直线连接或平滑曲线bezierCurveTo贝塞尔插值4.8 扫码点歌点击控制台顶部「扫码点歌」按钮弹出二维码窗口。使用手机微信或浏览器扫码即可打开手机点歌页面。支持多人同时扫码各点各的播放队列共享。扫码点歌特性手机端零安装扫码后直接在浏览器中使用无需下载任何APP密码保护可在设置中配置扫码密码防止陌生人乱点歌跨网段支持部署QR中继服务器后手机即使不在同一局域网也能点歌多会话隔离不同KTV实例互不干扰4.9 省流模式点歌页面右上角有「省流」开关。开启后视频播放时自动转码为低码率流媒体参数手机端电脑端视频分辨率480p720p视频码率384kbps384kbps音频码率128kbps128kbps启动延迟1-2秒1-2秒4.10 歌曲上传点击控制台顶部「上传歌曲」按钮打开上传页面。支持拖拽上传和批量上传。拖拽文件到上传区域或点击选择文件支持批量上传一次选择多个文件上传完成后自动增量扫描秒级更新曲库支持格式mp4, mkv, avi, mov, wmv, rm, rmvb, ts, webm, mpg, mpeg, flv, mp3, wav, flac, aac, m4a, ogg, wma4.11 缺歌登记点击控制台顶部「缺歌登记」按钮打开缺歌登记页面。输入想要的歌曲名称提交即可。用户可提交想唱但曲库中没有的歌曲管理员可查看所有缺歌登记记录系统自动记录搜索无结果的关键词方便后续补充曲库五、系统设置点击控制台「设置」按钮可进行以下配置配置项说明默认值曲库目录歌曲文件所在目录支持多个每行一个D:\CloudMusic服务器端口HTTP服务监听端口82启用扫码点歌开启/关闭手机扫码功能关闭二维码服务器地址QR中继服务器地址公网IP:端口扫码点歌密码手机扫码后需输入的密码留空则无需密码文件名格式歌手-歌名-语种-歌曲类别-注意修改设置后需重启服务器生效。六、转码与GPU加速6.1 自动转码当歌曲编码不被浏览器直接支持时如HEVC/H.265、FLAC音频等系统会自动转码为H.264AAC格式。后台静默转码完成后自动切换播放。支持GPU硬件加速无GPU时自动回退到CPU编码。6.2 GPU加速程序启动时自动检测GPU编码器优先级NVIDIA NVENC推荐— 需NVIDIA显卡AMD AMF— 需AMD显卡Intel QSV— 需Intel核显CPU libx264— 自动回退七、QR中继服务器远程扫码点歌如需在不同局域网使用手机扫码点歌如公司内网手机4G需部署QR中继服务器。将qrserver.exe部署到有公网IP的服务器上运行后默认监听9000端口。在KTV主程序设置中填入公网服务器地址即可。工作原理手机 ↔ 公网中继服务器 ↔ 内网KTV服务器KTV服务器主动连接中继服务器出站连接无需开放端口手机通过中继服务器转发搜索和点歌请求支持多会话隔离。八、快捷键快捷键功能Ctrl ↓切换下一首空格音频播放器 暂停/继续F11音频播放器 全屏切换Escape退出全屏Enter搜索框确认搜索0 / 1切换原唱(0)/伴奏(1)九、性能说明指标数据程序大小~12MB16万曲库搜索10ms16万曲库首次扫描~30秒缓存启动1秒上传后增量扫描1秒省流模式启动延迟1-2秒十、常见问题Q客户端需要安装什么A不需要安装任何软件电脑和手机都只需要一个浏览器Chrome、Edge、Firefox、Safari均可打开网页即可使用。Q启动时提示「媒体目录不存在」A检查 ktv_config.json 中的 mediaDirs 路径是否正确确保目录存在。Q视频无法播放A确保 ffmpeg.exe 和 ffprobe.exe 在程序同目录下。部分编码格式需要转码后才能播放。Q手机扫码连不上A确保手机和电脑在同一局域网。如需跨网段需部署QR中继服务器。Q搜索结果中没有某些歌曲A检查歌曲文件格式是否在支持列表中。文件名应遵循「歌手-歌名-语种-歌曲类别」格式以获得最佳分类体验。Q同名歌曲怎么区分A同名歌曲会自动在歌名后标注文件大小如 (450.2MB)。文件越大通常画面质量越高。Q省流模式卡顿A系统会自动根据实际编码码率调整缓冲策略。如仍有卡顿可尝试关闭省流模式直接播放原文件。QGPU加速不生效A程序启动时会自动检测。如显示「视频编码器: libx264」说明未检测到GPU或驱动不支持。确保显卡驱动为最新版本。Q拼音搜索怎么用A直接在搜索框输入拼音首字母即可如输入「zgr」会匹配到「张国荣」「zjl」匹配「周杰伦」。支持连续输入多个字的拼音首字母。Q上传的歌曲无法播放A上传的歌曲文件会自动加入曲库。如无法播放请确认文件格式在支持列表中并检查服务器是否正常运行。Q频谱条数量选多少合适A一般使用128或256条即可获得良好的视觉效果。选择512条时系统会自动提高FFT分辨率但会增加少量CPU占用。十一、文件名格式建议为获得最佳的分类浏览体验建议歌曲文件名遵循以下格式歌手-歌名-语种-歌曲类别.扩展名示例张国荣-风继续吹-粤语-经典老歌.mp4周杰伦-晴天-国语-流行歌曲.mkv五月天-赌神-国语-流行歌曲.mkvTaylor Swift-Love Story-英语-流行歌曲.mp4系统会自动从文件名中提取歌手、语种和曲种信息用于分类浏览和歌手索引。如果文件名不符合此格式歌手将显示为「未知歌手」语种和曲种为空。