[SYSTEM_STATUS: OPERATIONAL] A procedural 3D multiverse for audio-reactive digital DNA. Transform sound into geometry.
DJ-OS is not just a music player; it is a Neural Operating System. It uses the Web Audio API to extract real-time frequency data from tracks, feeding that data into a custom-built 3D engine. Every track generates a unique "DNA Seed" that morphs the environment across 12+ mathematical realms.
- Frontend: Next.js 14 (App Router) for high-performance hydration.
- 3D Engine: @react-three/fiber & Three.js using
Float32Arrayfor GPU-accelerated particle systems. - State Management: Zustand for low-latency sync between audio nodes and 3D uniforms.
- Aesthetics: Tailwind CSS + Framer Motion for the "Neon-Glass" HUD.
- Backend: Supabase for Realtime sync, Auth, and the Community Poster Archive.
The engine features 12+ unique mathematical mappings determined by the track's DNA:
- 0x00 Torus Knot: Braided orbital particles.
- 0x02 DNA Archive: Double-helix structural mapping.
- 0x08 Quantum Foam: Wave-particle duality simulation.
- 0x11 Quantum Pringle: Hyperbolic paraboloid geometry.
git clone [https://github.com/Sm0k367/dj-os.git](https://github.com/Sm0k367/dj-os.git)
cd dj-os
npm install
2. Configure Neural UplinkCreate a .env.local in the root directory:Code snippetNEXT_PUBLIC_SUPABASE_URL=your_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
3. Ignite EngineBashnpm run dev
📡 KEY MODULESModuleDescriptionNeuralCanvas.tsxThe WebGL heartbeat. Handles particle interpolation and physics.AudioEngine.tsxInvisible controller managing AudioContext and AnalyserNode.realmCalculations.tsThe "Math Core". Trigonometric formulas for all 12 realms.PosterGenerator.tsxViral engine. Composites 1080p snapshots for social sharing.🛡 ARCHITECT ACCESSUsers who authenticate via the Neural Identity gateway can:Manual Override: Use the Architect Tools to manually manipulate realm variables.Archive DNA: Save generated posters to the Community Gallery.Sync Session: Host real-time "Neural Raves" where others see your visualizer state.🤝 CONTRIBUTINGSystem logs indicate room for more realms. If you have a mathematical formula that generates beautiful geometry, feel free to open a PR in lib/realmCalculations.ts.DEVELOPED_BY_SM0K367 Exploring the intersection of Sound, Math, and the Void.