{"id":34683621,"url":"https://github.com/jordanblakey/lumina-media-controller","last_synced_at":"2026-01-13T20:40:29.397Z","repository":{"id":330328127,"uuid":"1122429828","full_name":"jordanblakey/lumina-media-controller","owner":"jordanblakey","description":"Control all linux media players in one Electron app.","archived":false,"fork":false,"pushed_at":"2025-12-24T19:29:55.000Z","size":3242,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-26T08:30:13.568Z","etag":null,"topics":["electron","linux","media-player","music-player","system-utilities"],"latest_commit_sha":null,"homepage":"https://youtu.be/DyoWhIAgIwc","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jordanblakey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-24T17:52:44.000Z","updated_at":"2025-12-24T19:31:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jordanblakey/lumina-media-controller","commit_stats":null,"previous_names":["jordanblakey/lumina-media-controller"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jordanblakey/lumina-media-controller","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanblakey%2Flumina-media-controller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanblakey%2Flumina-media-controller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanblakey%2Flumina-media-controller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanblakey%2Flumina-media-controller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jordanblakey","download_url":"https://codeload.github.com/jordanblakey/lumina-media-controller/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanblakey%2Flumina-media-controller/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28399946,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["electron","linux","media-player","music-player","system-utilities"],"created_at":"2025-12-24T21:36:52.534Z","updated_at":"2026-01-13T20:40:29.392Z","avatar_url":"https://github.com/jordanblakey.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lumina Media Controller\n\nA premium, D-Bus-powered media companion for Linux.\n\nLumina gives you a centralized hub to monitor and control every media player on your system with zero friction. Whether you're juggling Spotify, YouTube, and VLC, Lumina keeps everything organized, identified, and controllable from a single, beautiful interface.\n\nRecorded Demonstration: https://youtu.be/DyoWhIAgIwc\n\n## Key Features\n\n- **Intelligent Player Identification**: Automatically identifies active media players using D-Bus Well-Known Names for high reliability and security.\n- **Interactive Player List**: View all active media sources. Click any player badge to toggle its playback independently.\n- **Dynamic Control Suite**: Full playback controls (Play/Pause, Skip, Previous) and integrated system volume management.\n- **Real-Time Sync**: Proactively monitors D-Bus signals for instant metadata and status updates.\n- **Premium Aesthetics**: A modern, dark-mode interface with glassmorphism, smooth transitions, and custom iconography.\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js and npm\n- Linux with D-Bus and `amixer` (standard on most distros)\n- `busctl` (provided by systemd)\n\n### Installation \u0026 Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm start\n\n# Build a fast distribution (.deb)\nnpm run build:fast\n```\n\n### Quick Reinstall\n\nIf you are testing on a Debian-based system, you can use the built-in reinstall script to refresh the package:\n\n```bash\nnpm run reinstall\n```\n\n## Technical Stack\n\nLumina is built on a hybrid architecture that blends modern web technologies with Linux systems programming:\n\n- **Frontend**: A minimal, high-performance UI built with standard **HTML5**, **CSS3**, and **Vanilla JavaScript**.\n- **Backend (Electron)**: Orchestrates system-level interactions using Node.js.\n- **IPC Bridge**: Uses a secure `contextBridge` and `preload.js` pattern with an asynchronous \"UI Ready\" handshake for reliable initialization.\n- **D-Bus Integration**: Communicates with the MPRIS protocol using **`busctl`** for high-efficiency JSON output parsing.\n- **System Utilities**: Integrates with `amixer` for global hardware volume control.\n\n## Security \u0026 Sandboxing\n\nLumina includes a custom **AppArmor profile** designed to resolve permission issues when communicating with players installed via **Flatpak** or **Snap**. This profile ensures the application has the necessary permissions to talk to the session bus while maintaining a secure security posture.\n\n## How it Works\n\nLumina leverages the **MPRIS (Media Player Remote Interfacing Specification)** over D-Bus. It uses `busctl` to query player metadata and status in real-time. By utilizing Well-Known Names (e.g., `org.mpris.MediaPlayer2.spotify`), Lumina ensures consistent identification across different distribution methods (Native, Flatpak, Snap).\n\n## Credits\n\nLumina was born from a collaborative pair-programming journey between the developer and **Antigravity**, a powerful agentic AI coding assistant designed by the Google Deepmind team. Together, they transformed a simple D-Bus experiment into a refined, intelligent desktop utility.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordanblakey%2Flumina-media-controller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjordanblakey%2Flumina-media-controller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordanblakey%2Flumina-media-controller/lists"}