# Mineradio — Immersive Music Player with Cinematic Visuals

> An open-source music player that combines cinematic camera effects, particle visuals, and lyric stage performances for an immersive listening experience.

## Install

Save as a script file and run:

# Mineradio — Immersive Music Player with Cinematic Visuals

## Quick Use
```bash
git clone https://github.com/XxHuberrr/Mineradio.git
cd Mineradio
# Open index.html in a browser or serve locally
npx serve .
```

## Introduction
Mineradio is an open-source immersive music player that transforms audio playback into a visual experience. It combines cinematic camera movements, particle-based visuals, and synchronized lyric stages to create a concert-like atmosphere in your browser, making it a creative showcase for web audio and WebGL technologies.

## What Mineradio Does
- Plays music with real-time audio visualization driven by frequency analysis
- Renders cinematic camera effects that respond to beat and rhythm
- Displays synchronized lyrics on a virtual stage with animated typography
- Generates particle systems and visual effects tied to audio energy levels
- Supports custom playlists and configurable visual themes

## Architecture Overview
Mineradio is built as a single-page HTML/JS application using the Web Audio API for frequency analysis and Canvas/WebGL for rendering. The audio analyzer extracts frequency bins in real time, feeding them to a visual pipeline that drives camera motion, particle emission rates, and lyric animation timing. The lyric synchronization engine uses LRC-format timestamps to coordinate text display with the audio track.

## Self-Hosting & Configuration
- Clone the repository and serve the directory with any static file server
- Add music files and LRC lyrics to the configured media directory
- Customize visual themes by editing the shader and particle configuration files
- No build step required — runs directly in modern browsers
- Deploy to any static hosting service (Netlify, Vercel, GitHub Pages)

## Key Features
- Real-time audio-reactive visuals with WebGL particle systems
- Cinematic camera system with smooth transitions tied to musical structure
- LRC lyric synchronization with animated typography effects
- Configurable visual themes for different musical genres
- Fully client-side with no server dependencies

## Comparison with Similar Tools
- **Spotify** — streaming service with basic visualizers; Mineradio offers deep visual customization
- **MilkDrop/Butterchurn** — classic Winamp visualizer; Mineradio adds lyric integration and cinematic cameras
- **Wavesurfer.js** — audio waveform library; Mineradio is a complete player experience, not a component
- **Three.js audio examples** — demo-level projects; Mineradio is a polished, playlist-capable player
- **Navidrome** — self-hosted music server; Mineradio focuses on the playback and visual experience

## FAQ
**Q: What browsers are supported?**
A: Any modern browser with Web Audio API and WebGL support (Chrome, Firefox, Edge, Safari).

**Q: Can I use my own music library?**
A: Yes, add audio files and optional LRC lyric files to the media directory for a personalized experience.

**Q: Does Mineradio support streaming from external sources?**
A: It is primarily designed for local files, but you can point it at any URL-accessible audio source.

**Q: How demanding is it on hardware?**
A: The particle and WebGL effects run smoothly on most modern devices. You can reduce visual complexity in the config for lower-end hardware.

## Sources
- https://github.com/XxHuberrr/Mineradio

---
Source: https://tokrepo.com/en/workflows/asset-b30e1fc8
Author: Script Depot