halilkaandogan/kaaninhos-mp3

kaaninho's mp3 is a small, retro-styled desktop music player built with Electron.js, the same technology used to build many cross-platform desktop apps out of web code. The creator built it because they wanted a simple, uncluttered way to play music on their computer without ads or complicated menus, and gave it a pixel-art visual style. The app lets a user search for and play any song directly from YouTube, rather than requiring the user to already own the music files. Users can build their own playlists and reorder songs by dragging and dropping them. A caching system remembers what has already played so the next song starts instantly instead of waiting to load again, and shuffle mode works together with that same cache. The player also includes audio effects such as slowing a track down, speeding it up, adding reverb, boosting the bass, an 8D audio effect, and a muffled sound effect, plus several color themes to change the app's look. As an extra, it includes a small basketball mini-game a user can play while listening. For most people, using the app requires no installation at all: they just download the finished .exe file from the project's releases page and open it directly on Windows. For anyone who wants to look at the source code or run it themselves, the process involves cloning the repository, installing Node.js, and downloading a separate tool called yt-dlp, which is used to pull audio from YouTube, placing it in the project's root folder. From there, the usual npm install and npm start commands run the app from source, and a separate command builds a new .exe file. The project is written in JavaScript and released under the MIT license, meaning it can be freely used, modified, and redistributed, including commercially.