https://github.com/ansh2222949/neonplayer
Offline desktop media controller built in Python using pywebview
https://github.com/ansh2222949/neonplayer
desktop-application media-controller offline-app python research-project system-tools windows
Last synced: about 2 months ago
JSON representation
Offline desktop media controller built in Python using pywebview
- Host: GitHub
- URL: https://github.com/ansh2222949/neonplayer
- Owner: ansh2222949
- Created: 2025-12-24T23:54:06.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-25T20:16:34.000Z (6 months ago)
- Last Synced: 2025-12-26T13:15:28.873Z (6 months ago)
- Topics: desktop-application, media-controller, offline-app, python, research-project, system-tools, windows
- Language: Python
- Homepage:
- Size: 52.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
🎧 NeonPlayer
Floating System Media Controller for Windows
Glassmorphism UI • System Sync • Always-on-Top
---
## 🎵 What is NeonPlayer?
**NeonPlayer** is a lightweight, floating desktop widget that automatically syncs with your Windows system media session.
Whether you are listening to **Spotify, YouTube (Browser), VLC, or Apple Music**, NeonPlayer detects it instantly and gives you a beautiful, transparent glass control panel. It stays on top of your windows so you never have to Alt-Tab to skip a song.
---
## ✨ Key Features
| Feature | Description |
| :--- | :--- |
| 🎧 **System Sync** | Automatically connects to Spotify, Chrome, Edge, VLC, etc. |
| 🪟 **Glass UI** | Modern **Glassmorphism** design with blur effects. |
| 📌 **Always-on-Top** | Pin the widget so it floats over other apps. |
| 🎨 **6+ Themes** | Neon, Night, Cyber, Emerald, Sunset, Rose. |
| 💎 **Dynamic BG** | Album art is blurred and animated as the background. |
| ⚡ **Performance** | Asynchronous polling ensures 0% lag or CPU load. |
---
## 🏗️ Architecture
NeonPlayer uses a hybrid architecture to combine the power of Python with the beauty of Web Technologies.
```mermaid
graph TD;
Windows_OS[Windows Media API]-->Python_Backend;
Python_Backend[Python Core]-->|JSON Data|Bridge[pywebview Bridge];
Bridge-->Frontend_UI[HTML/JS Interface];
Frontend_UI-->|User Clicks|Bridge;
Bridge-->|Media Commands|Python_Backend;
Python_Backend-->Windows_OS;
```
* **Python (Backend):** Handles WinRT (Windows Runtime) APIs to read media status.
* **JavaScript (Frontend):** Manages animations, progress bars, and theme switching.
* **pywebview:** Acts as the bridge between Python logic and the UI.
---
## 📂 Project Structure
```text
NeonPlayer/
├── core/
│ ├── media_control.py # Windows Media Transport Controls (WinRT)
│ ├── pin_logic.py # Window pinning & positioning logic
│ └── __init__.py
│
├── web/ # The Frontend Layer
│ ├── index.html # Main UI Structure
│ ├── script.js # Logic for UI updates & bridge calls
│ └── style.css # Glassmorphism styles & animations
│
├── main.py # Entry point (Starts Python & WebView)
├── app_icon.ico # App Icon
├── build.bat # One-click build script
└── requirements.txt # Python Dependencies
```
---
## 🚀 How to Run
### 1️⃣ Prerequisites
* Windows 10 or Windows 11 (Required for Media APIs).
* Python 3.8+.
### 2️⃣ Installation
```bash
# Create Virtual Environment (Optional but Recommended)
python -m venv venv
venv\Scripts\activate
# Install Dependencies
pip install -r requirements.txt
```
### 3️⃣ Start App
```bash
python main.py
```
---
## 📦 How to Build (.exe)
To create a standalone executable file that runs without Python installed:
1. Make sure you have `pyinstaller` installed:
```bash
pip install pyinstaller
```
2. Run the build script:
```bash
build.bat
```
3. Find your app in the `dist/` folder.
---
## 🎨 Controls & Shortcuts
* **Play/Pause:** Click the center button.
* **Seek:** Drag the progress bar.
* **Pin/Unpin:** Click the 📌 icon to toggle "Always on Top".
* **Change Theme:** Click the palette icon to cycle through themes.
* **Minimize:** The widget auto-compacts when media is paused for too long (configurable).
---
Built with ❤️ using Python & WinRT
```