A X I O T U N E

The Audiophile Web Streaming Platform Engineered for Aesthetic & Performance

Apple Liquid Glass Architecture · Syllable-Level Karaoke Sync · 3D Vinyl Engine · Web Audio DSP Studio

About • Screen Recordings • Features • Audio DSP • Lyrics Engine • Architecture • Quickstart • Shortcuts

---

Important

⚠️ IMPORTANT - LOGIN PROCESS ⚠️

1. Open the website → You will see a green pill.
2. Press CTRL + SHIFT + B → This will open your bookmarks bar. Drag that green pill into the bookmarks bar.
3. Open YouTube Music in a new tab → Click on the saved green pill bookmark.

⚠️WE DONT ASK FOR PASSWORDS , THIS IS ONLY FOR QUEUE AND SONGS RECCOMENDATIONS

---

Screen Recordings & Media

1. Desktop Playback Interface & 3D Cover Flow

_{Full desktop experience featuring the Apple-inspired seamless frosted top bar, 3D Quick Picks Cover Flow carousel, and ambient visualizer background.}

2. AI Taste Mix & Smart Recommendations

_{Intelligent AI Taste Mix balanced across liked songs, top historical artists, and diverse discovery anchors.}

3. Curated Mood Collections & Thematic Discovery

_{Richly textured genre, era, and seasonal carousels with instant playback and dynamic ambient background matching.}

4. Personal Music Library & Playlists

_{Comprehensive personal library with custom playlist creation, liked tracks collections, and local/cloud synchronization.}

Live Demonstrations

Interface Navigation & Quick Picks	Syllable-Level Lyrics & Hover Dock
Browsing carousels, responsive layout, and track playback. (View Full MP4)	Real-time syllable karaoke vocal wipe and liquid glass dock. (View Full MP4)

---

Core Features

1. Liquid Glass Interface

• Dynamic Specular Optics: Layered backdrop blurs (backdrop-filter: blur(28px) saturate(190%)), subtle border rim reflections, and multi-stop elevation shadows.
• Adaptive Canvas Engine: Extracts dominant and accent colors from the active album cover to paint a smooth, moving GPU gradient backdrop.
• Fluid Spring Animations: Micro-interactions and card transitions driven by cubic-bezier(0.16, 1, 0.3, 1) easing.
• Responsive Layout: Adapts between a desktop split-view (player, lyrics, queue) and a focused mobile-optimized sheet interface.

2. Better-Lyrics Engine

• Syllable-Level Vocal Wipe: Parses word-level timestamps (TTML and extended LRC) for left-to-right progressive karaoke fills.
• Hover-Expandable Control Dock: A compact, floating Apple-style capsule dock that rests non-intrusively and smoothly expands on mouse hover to reveal version switchers, timing controls, and language tools.
• Multi-Provider Fallback: Discovers and switches between available lyrics sources (LRCLIB, synchronized providers, plain text fallbacks).
• Millisecond Timing Offset: Fine-tune lyric sync on the fly with +0.1s / -0.1s adjustment buttons to eliminate audio-display lag.
• Romanization & Translation: One-click toggles for non-Latin script pronunciation and machine translation.

3. Interactive 3D Vinyl Turntable

• Realistic Turntable Physics: Rotational inertia, acceleration/deceleration curves, and realistic vinyl surface specular shine.
• Stylus Tracking: Animated tonearm that positions itself dynamically based on current track progress.

---

Tech Stack

Layer	Technologies	Purpose
Backend	Python 3.10+, FastAPI, Uvicorn	Async REST API, WebSocket party rooms, stream resolving
Audio Resolvers	ytmusicapi, yt-dlp	Search indexing, album metadata, audio stream extraction
Lyrics Provider	LRCLIB API, synced lyrics parser	Word-level TTML timestamps and line-synced LRC text
Frontend Core	Vanilla HTML5, CSS3, ES2022 JavaScript	Lightweight client architecture without framework overhead
Graphics & DSP	WebGL Canvas, Web Audio API	Ambient visualizer canvas, 3D spatializer, 8D orbital panner
Client Storage	IndexedDB, Cache Storage API	Offline audio blob caching and local preferences storage

---

Quickstart

Prerequisites

• Python 3.10 or higher
• FFmpeg (recommended for audio stream processing)
• Git

1. Clone the Repository

git clone https://github.com/Axion-Builds/AxioTune.git
cd AxioTune

2. Install Python Dependencies

pip install -r requirements.txt

3. Launch the Server

Windows:

python backend.py

macOS / Linux:

python3 backend.py

4. Access the Application

Open your web browser and navigate to:

http://localhost:10000

---

Running with Docker

# Build the container image
docker build -t axiotune .

# Run container on port 10000
docker run -d -p 10000:10000 --name axiotune-app axiotune

Access the application at http://localhost:10000.

---

Keyboard Shortcuts

Shortcut	Action
Space	Play / Pause
L	Toggle Synced Lyrics View
K or →	Next Song
J or ←	Previous Song / Restart Track
M	Mute / Unmute Volume
F	Toggle Fullscreen Mode
/	Focus Search Bar
Esc	Close Modal / Exit Fullscreen

---

Deployment Notes

AxioTune is ready for containerized or platform deployments (Render, Railway, Fly.io, VPS):

• Build Command: pip install -r requirements.txt
• Start Command: python backend.py
• Environment: Set PORT=10000 (or allow the platform to assign $PORT).

---

License

This project is licensed under the MIT License.
Developed by Adarsh Shukla (Axion Builds).