lifeart/ya-namp

ya-namp brings back the look of the classic Winamp music player, but wires it up to play music from Yandex Music, the streaming service popular in Russia. You can try it right away in the live demo, which runs completely inside your web browser: it generates six sample tracks on the fly, so there is nothing to install and no account is needed. Clone the project and run it yourself if you want to connect your own Yandex Music account and browse the real catalog. The interface copies Winamp closely: beveled buttons, a green LCD style marquee that scrolls the track name, a spectrum and oscilloscope visualizer you can click to cycle through, and sliders for seek, volume, and balance. Keyboard shortcuts control playback, shuffle, repeat, and the radio feature. There is a playlist editor, a search box that queries the full Yandex catalog once connected, and support for liking or unliking tracks. A ten band graphic equalizer lets you shape the sound in real time using the browser's audio tools. The app also supports Yandex's personalized AI radio feature, called My Wave, which keeps adding new tracks to the queue as you listen and adjusts based on what you play. To connect a real account, you paste a Yandex OAuth token into the app, or save it to a local settings file using a provided command. The token stays on the server in memory and is never saved into the project's source code. For people who do not want to set up a development environment, the project ships ready to run binaries for macOS, Linux, and Windows, plus a prebuilt Docker container image that also works on Synology NAS devices. Locally, it is built with TypeScript throughout: a small typed contract file that both sides agree on, an Express server that proxies Yandex's API and streams audio, and a Vite based client that renders the Winamp style interface without using any UI framework.