🎵 Arya Music OS

A premium, cross-platform music operating system built for the next generation of listeners.

Arya Music OS is more than just a music player. It's an immersive, high-performance "operating system" for your sonic consciousness. Built with a modern tech stack, it features real-time audio visualization, dynamic theme adaptation, and intelligent fallback streaming.

✨ Features

• 🌊 Real-time Visualizers: Experience your music with a custom "Liquid Wave" canvas visualizer that reacts to bass and frequency in real-time.
• 🎨 Dynamic Accents: The UI automatically shifts its color palette to match the album art of the currently playing track.
• 🚀 Intelligent Streaming: Powered by yt-dlp, with a built-in SoundCloud fallback mechanism to ensure your music never stops.
• 📈 Sonic Intelligence: Quantify your listening habits with "Acoustic Mass" and "Frequency Sync" metrics.
• 📂 Bulk Migration: Easily transfer your existing music collection from legacy platforms using the Bulk Import tool.
• 🎭 Cinematic View: A dedicated full-screen experience designed for deep listening.

🛠 Tech Stack

• Frontend: Next.js (App Router), TypeScript, Zustand, Framer Motion
• Backend: Fastify, MongoDB, yt-dlp
• Tooling: Turbo, pnpm
• Mobile: Capacitor (ready for Android/iOS deployment)

🚀 Getting Started

Prerequisites

• Node.js >= 20.0.0
• pnpm >= 10.0.0
• MongoDB (running locally or a connection string)

Installation

1. Clone the repository:

   git clone https://github.com/AryaVL/AryaMusicOS.git
   cd AryaMusicOS

2. Install dependencies:

   pnpm install

3. Set up environment variables: Create a .env file in the server directory:

   MONGODB_URI=your_mongodb_uri
   BACKEND_PORT=3001
   DATA_DIR=./data

4. Start the development environment:

   pnpm dev:all

   • Frontend: http://localhost:3000
   • Backend: http://localhost:3001

🧩 Architecture

• apps/web: The Next.js frontend application.
• server: Fastify backend handling streaming, search, and library management.
• apps/web/android: Capacitor-based Android project.

---

Developed with ❤️ by Arya VL