GIXPLAY

A mobile-first, multi-source music streaming PWA with a pure black theme, offline capabilities, shared rooms, and deep personal analytics.

Universal Playback Engine with Aggressive Background Audio Support

---

About Gixplay

Gixplay is a privacy-first, optimized music and audio streaming Progressive Web App. It allows users to search, play, and organize music from multiple global sources while keeping all personal data fully local to the device.

NO ACCOUNTS	NO CLOUD PROFILES	NO ADS	NO TRACKING

---

Installation Options

PWA Install (Windows, macOS, iPhone) Native-like experience with background audio support Open site → Install from browser menu

Android App (Play Store) Join testing program to install Become a tester now

---

Search & Create Playlists

---

Source code will be revealed at 300 stars

Stars over time

---

Feature Guide

	Stable Search System The stable page uses high-quality APIs for searching audio and video. To control costs and quotas, this page is limited to one search per hour. For unlimited discovery, switch to the secondary search server via the top-right button. Direct Import: Paste a direct URL from supported platforms into the input field to fetch and add tracks instantly.
	Get Popular Songs (Trending) Discover what the world is listening to by clicking the Refresh icon on the top right corner. This feature fetches the currently most-listened music and trending tracks directly from global sources. Limit: Refreshing is limited to once every 10 minutes to ensure stability and up-to-date results. Instantly play or add these popular hits to your local playlists with one tap.
	Secondary Search Server A free, Python-powered backend for unlimited searches by song or artist name. Self-Waking Server: If it shows "Offline," simply search and wait 30-40 seconds. The server wakes up automatically to save costs. If traffic is extremely high, please switch back to the Stable Search page.
	Anti-Abuse Verification To keep the service free and prevent bot abuse, a quick math question may appear before processing a search. Once verified, you can add music directly to your local playlists.
	Listening History Every song you play automatically appears on your History Page for quick access. Users can directly replay music or view details of past tracks without searching again. Privacy Controls: In the settings, you can delete specific entries, clear your entire history, or pause history tracking completely. Like all other data, your history is stored 100% locally on your device.
	Smart Playlists Add tracks with a single tap using the + icon on search results or the player screen. Everything is stored via IndexedDB on your device for total privacy. Includes Shuffle, Repeat, and standard loop modes.
	Data Portability (Sharing) Share playlists by exporting them as JSON strings or .txt files. To import, simply paste the code or upload the file into a new playlist. This allows you to move your library across devices without a cloud account.
	Shared Listening Rooms Create or join a room using a short code to listen with friends in real-time. A live activity log shows exactly what’s happening (joins, plays, pauses). Synced playback ensures everyone hears the same beat at the same time.
	Room Features Inbuilt Chat: Communicate with room members without leaving the app. Queue Control: Anyone can add URLs to the shared queue. No Limits: No cap on members or the number of songs queued. Clean Exit: Use the delete button to close rooms when finished.
	Deep Personal Analytics Insightful Stats: Tracks Total Plays (with 30s cooldown for accuracy), Active Days, and Joining Date. Visual Habits: Interactive line graphs and yearly heatmaps showing your listening frequency. Top Content: Automated ranking of your Top 10 tracks and artists based on local history.
	Secure Analytics Export Export your entire history as an encrypted string to prevent data tampering. Moving to a new phone? Just import your backup file to restore your heatmaps and play counts.

---

Key Features

Category	Feature Detail
Streaming	Multi-Source Playback: Universal search and direct URL importing.
Discovery	Trending Music: Get popular songs with a 10-minute refresh cooldown.
History	Local Playback History: View past plays with full delete/pause privacy settings.
UI	Pure Black OLED Interface: Minimal, distraction-free UI optimized for battery saving.
Storage	Local-First: Playlists, history, and analytics stay in your device storage.
App	PWA & APK: Full desktop and mobile support with offline data access.
Playback	Aggressive Background Audio: Android APK maintains playback even when closed or on calls.
Analytics	Privacy-Focused Insights: Streak tracking and activity heatmaps generated locally.
Privacy	Zero Tracking: No telemetry, no remote profiling, no hidden scripts.

---

Rooms (Shared Listening)

How Rooms Work

• No host system — every participant has equal control over the music.
• Real-time synchronization of:
  • Playback state (Play/Pause/Seek)
  • Queue order and current track
• Live Activity Log: Color-coded logs show real-time actions.

---

Architecture Overview

Metadata Engine > Scrapes and fetches trending and search data from global endpoints.

Local DB > Uses IndexedDB for high-performance storage of large libraries, history, and analytics.

Sync Engine > Lightweight real-time socket/database layer for room coordination.

Encryption > Custom local encryption for exported analytics data.

---

Platform Support

• Android (APK for aggressive background playback / Browser)
• iOS (PWA support for background play)
• Windows & macOS (Full PWA support)

---

Usage Notice

Gixplay is intended for personal and educational use. It does not host media, does not redistribute content, and relies on publicly accessible playback mechanisms. All rights belong to their respective content owners.

Support

If you find this project helpful, consider supporting the development:

© Gixplay — Personal music, shared moments, full control.