MusicOrb 🎵

A premium, audio-reactive 3D desktop widget built with Electron, Three.js, and Vite. MusicOrb transforms your system audio into stunning, dynamic visuals that float on your screen.

Features

• Audio Reactive: Responds to system audio with exponential precision.
• Desktop Widget: Transparent, frameless, and draggable window.
• Customization: Switch between shapes (Sphere, Heart, Cube, Crystal) and colors (Neon, Gold, Rainbow).
• System Tray Control: Manage all settings directly from the system tray.
• Utility: "Always on Top" and "Run at Startup" support.

Version History

v0.5: The Expert Update (Final Polish)

• Expert Audio Engine: Implemented Math.pow(bass, 2.5) for punchier, "expert-level" beat detection that ignores background noise.
• Bloom Effect: Added a secondary glow mesh with additive blending that expands violently on beats to simulate light scattering.
• Micro-Kicks: Objects now perform subtle rotational "kicks" on strong beats.
• Utilities: Added "Always on Top" (Pin) and "Run at Startup" options to the Tray menu.
• Rotation Control: Added ability to toggle automatic rotation on/off.

v0.4: Customization Suite

• Multi-Shape Support: Added switching between Sphere, Heart ❤️, Cube 🧊, and Crystal 💎.
• Color Themes: Introduced selectable color palettes: Neon Pink, Cyber Blue, Gold, Red, White.
• Rainbow Mode: Added a dynamic "Rainbow" mode that cycles colors over time.
• Visual Toggles: Added options to file/hide background Stars and Grid layers.

v0.3: Visual Overhaul

• New Aesthetic: Replaced the initial wireframe design with a premium, solid "Glass/Glow" material (MeshPhysicalMaterial).
• System Tray: Integrated a System Tray icon (bottom right) for background management.
• Context Menu: Added right-click menu for resizing (Small, Medium, Large) and quitting.

v0.2: Desktop Transformation

• Electron Integration: Ported the web prototype to a standalone Electron application.
• Transparent Window: Configured frameless, transparent window supports.
• System Audio Capture: Implemented desktopCapturer to listen to internal system audio instead of just the microphone.
• Draggable UI: Added custom drag-and-drop logic to move the widget anywhere on the screen.

v0.1: Prototype

• Concept: Initial Web-based 3D visualizer using Three.js.
• Core: Basic frequency analysis using AudioContext.
• Visuals: Simple wireframe sphere and particle field.

Installation

1. Clone the repository.
2. Run npm install.
3. Run npm run electron:dev for development or npm run electron:build to create the executable.

License

MIT