WickedMP3 is a high-fidelity, offline-first audio engine built in Rust. It bypasses browser audio sandboxes where possible to deliver uncompressed playback. There are no accounts, no telemetry, and no cloud syncing.
WickedMP3 is portable software. There is no installer.
WickedMP3.exe and the assets folder together..dmg file.WickedMP3.app AND the assets folder to your Applications directory (or any folder of your choice).| Play / Pause | SPACE |
| Next Song | RIGHT ARROW (Skips to next in queue) |
| Rewind | LEFT ARROW (Restarts track) |
| Camera Move | LEFT CLICK or MIDDLE CLICK + Drag |
| Search | Click the Magnifying Glass icon next to "All Tracks". |
| Delete Track | Right Click > Remove/Delete |
The queue uses a "Flow State" logic rather than a static list.
If the queue runs out of songs, the engine automatically pulls your entire Favorites playlist, shuffles it, and injects it into the queue. Music never stops.
Clicking the Loop Icon (next to "QUEUE") disables the auto-fill behavior and loops only the songs currently in your queue.
The interface unifies 2D lists and 3D space into a single synced data structure.
You can drag items directly from the 3D Sphere into the 2D Sidebar.
The "Queue" is not just a temporary list—it is a draggable object.
You can export the entire engine to run on your phone via a web browser (WASM).
1. Go to your Library view.
2. Click the Rocket Icon (Export).
3. This generates a dist folder containing the web engine.
NOTE: No audio files are copied automatically. The export creates an empty favorites folder.
4. Manual Import: You must manually copy your MP3s from your desktop favorites folder into the newly created dist/assets/music/favorites folder.
5. Self-Host: Upload the contents of dist to any static web host. If you are unfamiliar with web development, ask your favorite LLM.
The "Mobile Export" feature provides a self-hosted runtime environment intended solely for personal, private use. By utilizing this feature, you acknowledge and agree that you are solely responsible for all content hosted and distributed through your instance. Public broadcasting or sharing of copyrighted material without authorization is a violation of international law and our acceptable use policy.
For comprehensive legal guidelines on self-hosting and usage rights, please refer to our Terms of Service and Privacy Policy.
WickedMP3 discards the traditional Document Object Model (DOM) in favor of a native game-engine architecture. It bridges the gap between high-performance computing and audiophile-grade playback.
Every UI element is rendered as a textured quad directly to the GPU via WGPU (wrapping Vulkan/Metal/DirectX 12). This eliminates CSS layout thrashing and ensures frame-perfect 60fps responsiveness.
Using the Bevy Engine, data is stored in contiguous memory arrays (Struct of Arrays) rather than scattered objects. This maximizes CPU cache locality, allowing the engine to process 50,000+ entities with sub-millisecond latency.
Powered by the Kira Audio middleware, the engine utilizes a 32-bit floating-point precision signal chain. It bypasses standard web-audio bottlenecks on desktop by leveraging CPAL to talk directly to the OS kernel (WASAPI/CoreAudio). This delivers sample-accurate timing and dynamic routing without the forced compression artifacts found in browser-based Electron players.
The drag-and-drop system uses custom ray-casting algorithms to translate 2D mouse coordinates into 3D world space. This enables 'Inter-Dimensional' file management—dragging a floating album art sphere from the 3D void directly into a 2D playlist folder works seamlessly because both views share the same ECS memory address.
The 2D Library and 3D Visualization are not distinct applications but synchronized viewports observing a single source of truth. Drag-and-drop operations trigger atomic state changes that propagate instantly across both projections, eliminating desynchronization errors.
The core logic compiles to machine code for desktop and WebAssembly (WASM) for the web from a single source. This guarantees bit-for-bit feature parity across high-end workstations and mobile browsers.
The "Flow State" queue system uses an intelligent shuffling algorithm that automatically injects tracks from your favorites when the queue depletes, creating an infinite, non-repeating radio station customized to your library.
The application is self-contained. It writes no registry keys, requires no installation, and sends zero telemetry. Your library metadata is stored in local, human-readable RON files, ensuring you own your data forever.
The "Battleground" of modern audio is the signal path. WickedMP3 eliminates the browser middleware bottlenecks found in standard consumer applications to deliver studio-reference fidelity.
Modern Apps: Relies on Ogg Vorbis or AAC compression (~320kbps), discarding "inaudible" frequencies to save bandwidth.
WickedMP3: Agnostic playback engine. Dragging FLAC/WAV files provides a mathematically lossless, uncompressed reproduction of the studio master, decoded instantly in memory.
Standard: Most players process audio using 16-bit integers. Loud signals cause digital clipping (distortion) instantly.
WickedMP3: Utilizes a 32-bit floating-point DSP chain. This provides "Infinite Headroom," allowing for complex mixing and filtering without internal signal degradation, identical to professional DAWs like Ableton Live.
By utilizing CPAL (Cross-Platform Audio Library), WickedMP3 communicates natively with the OS audio kernel (WASAPI on Windows, CoreAudio on macOS). This completely bypasses the high-latency Web Audio API and Chromium sandbox that cripple standard Electron apps, delivering uncompressed, native-grade decoding directly to the system mixer.