whatisgithub

What is mineradio?

xxhuberrr/mineradio — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2026-06-27

7,156HTMLAudience · generalComplexity · 1/5ActiveLicenseSetup · easy

In one sentence

Free Windows desktop music player with cinematic visuals, particle effects, a 3D playlist shelf, and weather-based playlists that connects to NetEase Cloud Music and QQ Music accounts.

Mindmap

mindmap
  root((mineradio))
    What it does
      Immersive music player
      Particle visualizations
      Weather-based radio
    Tech Stack
      HTML
      Windows desktop
    Use Cases
      Full-screen visualizer
      Animated lyrics stage
      Podcast and DJ mode
    Audience
      Music enthusiasts
      Windows users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play music from your existing NetEase Cloud Music or QQ Music account through a cinematic, particle-synced interface.

USE CASE 2

Generate a weather-based playlist that matches your local weather and mood.

USE CASE 3

Browse your library through a 3D playlist shelf instead of a plain list view.

USE CASE 4

Use the dedicated long-form mode for podcasts and DJ sets with an animated lyrics stage.

What is it built with?

HTMLWindows

How does it compare?

xxhuberrr/mineradioblackrockdigital/startbootstrapsindresorhus/screenfull
Stars7,1567,1617,148
LanguageHTMLHTMLHTML
Last pushed2026-06-27
MaintenanceActive
Setup difficultyeasyeasyeasy
Complexity1/51/51/5
Audiencegeneralvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Installer is not digitally signed, so Windows or your browser may flag it as unfamiliar software.

GPL-3.0: free to use and modify, but if you distribute a modified version you must also share your source code.

So what is it?

Mineradio is a free Windows desktop music player that turns listening into a cinematic, visually immersive experience. Instead of a plain interface with album art and a progress bar, you get a private music space with particle effects synced to your songs, a 3D playlist shelf, and a lyrics stage that feels more like a live performance than a media app. At its core, the app pulls together several music sources, including NetEase Cloud Music and QQ Music, so you can search, browse playlists, and play tracks through accounts you already have. It also features a weather-based radio that generates playlists matching your local weather and mood. When you hit play, the screen shifts into a rhythm-driven visual mode with cinematic camera movements and particle animations that move with the music. There's a dedicated mode for long podcasts and DJ sets, and you can right-click to bring up a 3D shelf for browsing your playlists. This is built for people who treat music as an experience, not just background noise. If you're someone who enjoys full-screen visualizers, animated lyrics, and an interface that responds to the mood of what you're listening to, this app is aimed at you. It's a Windows-only desktop application, you download an installer and run it like any other program, no technical setup required. One thing worth noting: the app isn't affiliated with any music platform. It works as a personal client for services you already use, respecting their membership and copyright rules. It doesn't bypass paywalls or redistribute music. Your data, login cookies, search history, custom lyrics, and album covers, stays on your own machine. The project is open source under GPL-3.0, though the visual design and branding remain the creator's own. Because the installer isn't digitally signed, Windows or your browser may flag it as unfamiliar software. The README walks through how to safely bypass those warnings, and stresses downloading only from the official links provided.

Copy-paste prompts

Prompt 1
Walk me through downloading and installing mineradio safely, including bypassing the unsigned installer warning.
Prompt 2
Explain how mineradio's weather-based radio feature picks playlists based on local weather and mood.
Prompt 3
Show me how to connect my NetEase Cloud Music account to mineradio to browse my existing playlists.
Prompt 4
Describe what mineradio's rhythm-driven visual mode with particle effects looks like when I play a song.
Prompt 5
Explain what data mineradio stores locally, like login cookies and search history, and confirm it stays on my machine.

Frequently asked questions

What is mineradio?

Free Windows desktop music player with cinematic visuals, particle effects, a 3D playlist shelf, and weather-based playlists that connects to NetEase Cloud Music and QQ Music accounts.

What language is mineradio written in?

Mainly HTML. The stack also includes HTML, Windows.

Is mineradio actively maintained?

Active — commit in last 30 days (last push 2026-06-27).

What license does mineradio use?

GPL-3.0: free to use and modify, but if you distribute a modified version you must also share your source code.

How hard is mineradio to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mineradio for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.