Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

599 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Web App fully functional (always use brave browser)

A fully private high performance client side music architecture running entirely in your browser with zero backend infrastructure.

License MIT Privacy 100% Backend Zero Frontend Vanilla JS


Octave Player Interface    Octave Playlist View


Live Demo: https://octavemusicapp.pages.dev/
(This link is provided as a technological demonstration. Do not rely on it for permanent usage. Deploy your own static instance for optimal API performance.)


Overview & Philosophy

Most modern streaming applications are heavy, laggy, and actively track your behavior. Octave is a serverless vanilla web technology platform designed for zero latency streaming and uncompromising user privacy.

By operating strictly at the edge and acting as a bridge to public APIs, Octave delivers a premium audio experience without traditional backend bloat.

  • No Account Required: Instant access with zero onboarding.
  • No Telemetry: Zero behavioral tracking or analytics pinging external servers.
  • No Database: 100% of user data is isolated strictly to your device.
  • Self Sovereign Data: Complete export and import control over your listening history.

Strict Requirement for Background Playback

Mobile operating systems and browsers like Google Chrome or Safari natively restrict background media execution to preserve your battery life. Because Octave is a pure client side application without a dedicated backend server, Chrome will aggressively pause your music and kill the stream fetcher the moment your screen turns off.

To bypass this and achieve uninterrupted background playback with the screen locked, you MUST use the Brave Browser.

Brave has a native architecture that respects media session threads and prevents the OS from freezing background JavaScript execution. Octave automatically detects Brave and routes audio through a highly optimized instant loading engine designed specifically to survive background throttling. If you want background play, Brave is strictly required.

Core Features

Predictive Local Algorithm

Octave features a 10 point behavioral tracking system that runs entirely on your device to build your taste profile:

  • Action Tracking: Algorithm scores adjust dynamically based on immediate skips, full completions, and manual track selections.
  • Temporal Context: Automatically analyzes your listening habits by time of day like morning, afternoon, and night.
  • Session Memory: Ensures zero track repetition during an active listening session for a true Auto DJ experience.

Premium UI and UX Rendering

  • Dynamic Liquid Shadows: Real time canvas sampling extracts exact color values from your album art to generate continuously flowing color matched ambient shadow elements.
  • Glassmorphism Design: Built with high end frosted glass aesthetics, hardware accelerated CSS transitions, and minimalist typography.

Aggregated OSINT Integration

  • Synced Lyrics: Real time lyric fetching utilizing the LRCLIB API with a customizable typography engine.
  • Artist Biographies: Uses a dual fallback system between TheAudioDB and targeted Wikipedia API redirects to pull accurate artist history, caching it locally for instant load times later.

Data Vault Protocol

  • Complete Ownership: Export and import your entire ecosystem including listening history, algorithmic stats, liked tracks, and custom playlists via an encrypted JSON blob directly to your local file system.

Deployment Guide

Octave is a purely static application. It requires zero build steps, node modules, or server configurations. It can be deployed in under 60 seconds.

GitHub Pages

  1. Fork this repository.
  2. Navigate to Settings then Pages.
  3. Select the main branch and click save.

Cloudflare Pages, Netlify, or Vercel

  1. Connect your repository to your edge hosting provider.
  2. Ensure Framework Preset is set to None or Static.
  3. Clear any default build commands.
  4. Set the publish directory to the root folder.
  5. Deploy.

Architecture Flow

Octave does not store or host any media. It acts entirely as a client side interface connecting your browser to public APIs:

  • Search & Audio Stream: Proxied via public Invidious instances.
  • Playback Control: Forced IFrame Engine combined with Media Session API.
  • Lyrics: LRCLIB API.
  • Artist Info: TheAudioDB and Wikipedia APIs.
  • Storage Engine: Browser localStorage.

Legal Disclaimer & DMCA Compliance

This software is provided strictly for educational purposes and personal technological demonstration.

  • No Content Hosting: Octave does not host, store, upload, or distribute any copyrighted media files.
  • No DRM Circumvention: This application does not decrypt, rip, download, or permanently save proprietary audio streams.
  • API Utilization: The software acts solely as a client side aggregator executing standard HTTP requests to public third party APIs directly from the end user local IP address.
  • Commercial Restriction: You are allowed to use, modify, and deploy this project for non commercial purposes only. You are strictly prohibited from selling, reselling, sublicensing, or monetizing this project or any modified version of it without explicit permission from the original author.
  • User Responsibility: The creators and contributors of Octave hold no liability for how end users utilize this client side tool or what public APIs they connect to through their local network. By deploying or utilizing this software, you assume all responsibility for compliance with applicable laws and third party terms of service.

Support & Contact

For technical inquiries or project support, reach out via Telegram: https://t.me/ucvezw


If you found this architecture useful, consider starring the repository.

Releases

Packages

Contributors

Languages