SHiNeVtoWsyncV1.3 + SHiNe Share

中文简介

这是一个面向 VirtualDJ、Wallpaper Engine 和网页分享场景的 Windows 工具套件。它通过 VirtualDJ Network 插件提供的 URL 查询接口读取主轨道歌曲，并用 Windows 默认播放器打开当前歌曲，让 Wallpaper Engine 能识别 VirtualDJ 主轨道音乐；完整分享版还会把当前歌曲和曲目信息上传到 SHiNe Share 服务端，让网页实时展示当前播放歌曲、封面、BPM、Key、Artist、Title，并提供 Download 直接下载。

视频教程

【教程】如何用 Wallpaper Engine 做 VJ，识别 Virtual DJ 的专辑封面，软件下载

项目结构

• SHiNeVtoWsyncV1.3.py：轻量版客户端。读取 VirtualDJ 主轨道文件路径，打开歌曲，可手动/自动保存。
• client/：完整 SHiNe Share 客户端。读取主轨道文件路径、Title、Artist、BPM、Musical Key、Harmonic Key，并上传歌曲和 track_info.txt。
• server/：SHiNe Share Flask 服务端网站。接收上传文件，提取封面，渲染当前播放网页，并提供歌曲下载。
• config.example.ini：轻量版配置示例。
• client/config.example.ini：完整分享客户端配置示例。
• requirements.txt：根目录统一依赖。

工作流

1. VirtualDJ 安装并启用 Network 插件。
2. 客户端通过 URL 查询 VirtualDJ master deck 当前歌曲。
3. 客户端可用 Windows 默认播放器打开当前歌曲，让 Wallpaper Engine 识别主轨道音乐。
4. 完整分享客户端生成 track_info.txt，并上传当前歌曲和曲目信息到服务端。
5. 服务端网页显示当前歌曲、封面、BPM、Key、Artist 和 Title。
6. 网页端通过 Download 按钮直接下载当前歌曲。

前置要求

• Windows。
• Python 3。
• VirtualDJ。
• VirtualDJ Network 插件。VirtualDJ 需要这个插件，才允许通过 URL 控制和读取当前 deck 数据。
• 如果要使用网页分享功能，需要运行 server/ 里的 Flask 服务端。

轻量版客户端

适合只需要让 Wallpaper Engine 识别 VirtualDJ 主轨道歌曲的场景。

pip install -r requirements.txt
copy config.example.ini config.ini
python .\SHiNeVtoWsyncV1.3.py

快捷键：

• F1：保存当前歌曲到 downloadsound。
• F2：切换自动保存模式。

完整分享客户端

适合同时需要本机同步和网页分享的场景。

cd client
pip install -r requirements.txt
copy config.example.ini config.ini
python .\SHiNe_ShareV1.0.py

client/config.ini 示例：

[Settings]
base_url = http://127.0.0.1:80
mode = local
network_base = \\127.0.0.1
file_upload_url = http://127.0.0.1:5000/upload

• base_url：VirtualDJ Network 插件提供的 URL 根地址。
• mode：local 使用本机路径；network 把盘符路径转换为网络共享路径。
• network_base：网络共享根路径，仅 mode = network 时使用。
• file_upload_url：SHiNe Share 服务端上传地址，通常是 http://服务器IP:5000/upload。

完整分享客户端检测到主轨道换歌后，会读取并上传：

• 当前歌曲文件。
• Title Remix。
• Artist。
• BPM。
• Musical Key。
• Harmonic Key。

快捷键：

• F1：切换自动打开模式。开启后，新歌会用 Windows 默认播放器打开，方便 Wallpaper Engine 识别。

服务端网站

服务端用于接收完整分享客户端上传的歌曲和 track_info.txt，并渲染当前播放网页。

cd server
pip install -r requirements.txt
python .\SHiNe_music_shre_sever.py

默认监听：

http://0.0.0.0:5000

主要地址：

• /：当前播放页面。
• /upload：客户端上传接口。
• /upload_img.jpg：当前歌曲封面。
• /download_song：下载当前歌曲。
• /check_file/<filename>：客户端检查文件是否存在。

运行时上传的歌曲、封面和 track_info.txt 会放在 server/SHiNe Music Data/。仓库只保留空目录占位，不提交真实音频。

打包 exe

轻量版：

pip install pyinstaller
pyinstaller .\SHiNeVtoWsyncV1.3.spec

完整分享客户端：

cd client
pip install pyinstaller
pyinstaller .\SHiNe_ShareV1.0.spec

公开仓库说明

本仓库只提交源码、示例配置、文档和网站静态资源，不提交真实 config.ini、下载歌曲、上传歌曲、构建产物、日志、缓存、虚拟环境、服务器备份包或服务器连接信息。

上传功能指的是上传到你自己的 SHiNe Share 服务端，用于网页展示和下载当前播放歌曲，不是上传到 GitHub。