QtUnblockNeteaseMusic

A desktop client for UnblockNeteaseMusic, made with Qt.

Features

• Choose the UNM server's starting arguments
• Remembers the options from the last run in a config file
• View real time log output from the server
• Dark theme support

Supports

The original nondanee/UnblockNeteaseMusic

The enhanced UnblockNeteaseMusic/server

Screenshot

Usage

1. Download the latest version from releases
2. Install Node.js Runtime if you wish to use script server instead of packaged executable
3. Download the server from nondanee/UnblockNeteaseMusic or UnblockNeteaseMusic/server, and place it in the same directory with QtUnblockNeteaseMusic.exe

   QtUnblockNeteaseMusic  
   ├─ ...  
   ├─ QtUnblockNeteaseMusic.exe  
   └─ server  
      ├─ ...  
      └─ app.js
   

   or

   QtUnblockNeteaseMusic  
   ├─ ...  
   ├─ QtUnblockNeteaseMusic.exe  
   └─ unblockneteasemusic.exe
   

4. Run QtUnblockNeteaseMusic.exe and set the necessary arguments
5. Set the proxy in the Netease Cloud Music client accordingly & enjoy!

[!IMPORTANT] When used on your personal devices, avoid using the default 8080 port, and change the host address to 127.0.0.1 to avoid unwanted access from others.

[!NOTE] Newer client versions have stricter SSL verification, so if you encountered the "connection failed" issue, enable the HTTPS port and install UnblockNeteaseMusic CA certificate. Right click on QtUnblockNeteaseMusic.exe, select Run as administrator, and click Install certificate in the Advance menu.

Build

1. Set up the Qt development environment (Qt 6.4+)
2. Clone the repository
3. Open the project in Qt Creator / VS Code (extra extensions needed)
4. Compile & Run

• If you want to generate a complete package with libraries,
  copy QtUnblockNeteaseMusic.exe to a new directory and run windeployqt.exe .\QtUnblockNeteaseMusic.exe

Thanks

This little tool wouldn't have been made possible without these incredible projects:

• Qt: Providing a powerful but easy-to-use development framework
• nondanee/UnblockNeteaseMusic: The project that started everything
• UnblockNeteaseMusic/server: Maintaining and enhancing the UNM server

To be solved

• The log output from the enhanced server is messy (#791) Fixed in upstream (#798)
• Build everything with cmake Done
  There's a bug in Qt 6 preventing lupdate from working with CMake, thus we have to lupdate manually
• Untested/unsupported on macOS, Linux, and Windows 8 or lower
• Better update checking / auto update
• I'm a newbie