HQ Player Wave is a local webserver that allows you to remotely control HQPlayer from any device on your network using a web browser.
Thanks to Zeropointnine for this excellent program! I added a few new features and redesigned the interface. It was vibe-coded 99%!
Discussion thread on audiophilestyle
HQPWV is a local webserver that allows you to remotely control HQPlayer from any device on your network using a web browser.
- HQPlayer 4
- MacOS, Windows (64-bit), or Linux (64-bit)
- A modern desktop or mobile browser, connected to your local network (If using desktop or mobile Safari, it must be a recent version, circa April 2021)
- Get the latest (unsigned) MacOS, Windows, or Linux executable here. Instructions for running unsigned binaries on MacOS can be found here. If running an unsigned executable is not an option, consider downloading the source code and run the application using Node.js.
- Make sure HQPlayer is running, and that your library is populated. Verify that the "Allow control from network" button is checked.
- Run
hqpwv-server. Running it from the same computer as HQPlayer itself is recommended, but not required. - If all goes well, the console output should give you a webpage url to navigate to (eg, something like
http://192.168.X.XXX:8000). - Navigate to the url from any desktop or mobile browser that's on the same network as HQPlayer and HQPWV.
cdto the project directory.- Make sure Node.js is installed. Then enter:
npm install. - Make sure HQPlayer 4 is running.
- Start the server:
node server/server.js - Browse to the locally served webpage as directed.
Executables are generated with pkg by simply entering:
pkg .
Front-end code consists of untranspiled, vanilla ES6 classes.
The UI uses a unified, project-wide breakpoint set:
max-width: 1024px→ tablet / small desktop adjustmentsmax-width: 768px→ mobile layout switchmax-width: 480px→ compact mobile fine-tuning
Guideline: prefer these three breakpoints for new responsive rules to keep behavior consistent across views.