Click to expand
Universal Media Player is a cutting-edge, high-performance, offline-first media solution exclusively designed for Windows. Built from the ground up using Python, PyQt5, and the powerful VLC Media Engine, it delivers a seamless blend of professional-grade audio tools, immersive real-time visualizations, and a sleek, modern user interface.
Whether you're a music enthusiast who loves visualizing beats, a content creator needing voice transformation tools, or a movie lover seeking a distraction-free cinema experience — Universal Media Player has you covered.
| 🎯 Mission | 🔐 Philosophy | 🚀 Vision |
|---|---|---|
| Deliver the ultimate offline media experience | Privacy-first, no tracking, no telemetry | Empower users with professional-grade tools |
100% Offline No internet required |
Zero Tracking Complete privacy |
Lightning Fast Hardware accelerated |
Stunning Visuals Beat-synced effects |
|
Transform your audio playback instantly with professional-grade voice presets:
|
|
| Feature | Description | Status |
|---|---|---|
| 200% Volume Boost | Integrated software amplification with high-visibility safety indicators | ✅ |
| A-B Loop System | Set precise start and end points to loop specific segments of any track | ✅ |
| Real-time Processing | All effects applied in real-time without any lag or buffering | ✅ |
| Effect Reset | One-click reset to return to standard audio playback | ✅ |
| Preset Memory | Remembers your last used voice preset and settings | ✅ |
🎨 Studio Tab — Where Music Comes Alive
|
|
┌─────────────────────────────────────────────────────────────────┐
│ 🌈 HSV-Based Color Cycling │
│ ├── Smooth 360° hue rotation │
│ ├── Dynamic saturation based on audio intensity │
│ ├── Brightness sync with beat detection │
│ └── Customizable color palettes │
└─────────────────────────────────────────────────────────────────┘
🎥 Cinema Tab — Your Personal Theater
|
|
| Feature | Description |
|---|---|
| High Resolution | Captures at native video resolution |
| Auto-Naming | Timestamps and movie name included |
| Custom Location | Choose your save directory |
| Format Support | PNG, JPG, BMP export options |
| Quick Access | Ctrl + S keyboard shortcut |
📷 Coming Soon — Beautiful screenshots showcasing all features
| Cinema Mode | Studio Mode | Voice Effects |
|---|---|---|
| 🎬 Screenshot | 🎨 Screenshot | 🎤 Screenshot |
| HD Video Playback | Music Visualizer | Voice Changer |
|
|
| Tab | Purpose | Best For |
|---|---|---|
| 🎬 Cinema | High-definition video playback | Movies, TV Shows, Video Content |
| 🎨 Studio | Music + Live visualizations | Music, Audio Files, Podcasts |
Step 1: Navigate to Studio Tab
│
▼
Step 2: Select preset from "Voice" dropdown
│
├── 👧 Girl/Child
├── 👦 Boy/Man
├── 👹 Demon
└── 🐿️ Chipmunk
│
▼
Step 3: Fine-tune with Pitch Slider (optional)
│
▼
Step 4: Click "Reset Effects" to restore normal audio
|
Keep the player visible while working in other applications:
|
Compact view for minimal screen usage:
|
| Key | Action | Key | Action |
|---|---|---|---|
Space |
M |
🔇 Mute / Unmute | |
← |
⏪ Seek -10 seconds | → |
⏩ Seek +10 seconds |
↑ |
🔊 Volume Up | ↓ |
🔉 Volume Down |
| Key | Action | Key | Action |
|---|---|---|---|
F |
🎬 Toggle Fullscreen | Alt+Enter |
🎬 Toggle Fullscreen |
Esc |
❌ Exit Fullscreen | T |
📌 Always on Top |
P |
🔲 Mini-Player Mode | Ctrl+M |
➖ Minimize Window |
Ctrl+W |
❎ Close Application |
| Key | Action | Key | Action |
|---|---|---|---|
A |
🔁 Set A-B Loop | B |
🌓 Brightness Adjust |
Ctrl+S |
📸 Take Screenshot | Ctrl+F |
🔍 Focus Search Bar |
┌─────────────────────────────────────────────────────────────────────┐
│ ⌨️ KEYBOARD SHORTCUTS │
├─────────────────────────────────────────────────────────────────────┤
│ PLAYBACK │ WINDOW │ ADVANCED │
│ ───────────────── │ ───────────── │ ────────────────────── │
│ Space = Play/Pause│ F = Fullscreen │ A = A-B Loop │
│ ←/→ = Seek ±10s │ T = Pin on Top │ B = Brightness │
│ ↑/↓ = Volume ±5% │ P = Mini-Player │ Ctrl+S = Screenshot │
│ M = Mute │ Esc = Exit │ Ctrl+F = Search │
└─────────────────────────────────────────────────────────────────────┘
|
|
# Ensure Python 3.8+ is installed
python --version
# Ensure pip is up to date
python -m pip install --upgrade pip
⚠️ Important: Download the 64-bit version of VLC
# Install required packages
pip install PyQt5 python-vlc
# Or install from requirements.txt (if available)
pip install -r requirements.txt# Navigate to project directory
cd universal-media-player
# Launch the application
python main.py❌ VLC not found error
Ensure VLC is installed in the default location:
C:\Program Files\VideoLAN\VLC
Or add VLC to your system PATH.
❌ PyQt5 installation fails
Try installing with specific version:
pip install PyQt5==5.15.9❌ python-vlc import error
Ensure you have the 64-bit versions of both Python and VLC:
python -c "import struct; print(struct.calcsize('P') * 8)"
# Should output: 64universal-media-player/
│
├── 📄 main.py # 🚀 Application entry point
├── 📄 settings.json # ⚙️ Local settings storage
├── 📄 requirements.txt # 📦 Python dependencies
├── 📄 README.md # 📖 Documentation (you are here!)
├── 📄 LICENSE # 📜 License information
│
├── 📂 assets/ # 🎨 Static resources
│ ├── 📂 icons/ # 🖼️ Application icons
│ │ ├── app_icon.ico
│ │ ├── play.png
│ │ ├── pause.png
│ │ └── ...
│ ├── 📂 fonts/ # 🔤 Custom fonts
│ └── 📂 themes/ # 🎨 UI themes
│
├── 📂 modules/ # 🧩 Core functionality
│ ├── 📄 __init__.py
│ ├── 📄 player.py # 🎬 VLC player wrapper
│ ├── 📄 visualizer.py # 🌈 Music visualizations
│ ├── 📄 voice_effects.py # 🎤 Audio transformations
│ ├── 📄 ui_components.py # 🖼️ Custom UI widgets
│ └── 📄 settings_manager.py # ⚙️ Settings handler
│
├── 📂 ui/ # 🎨 UI definitions
│ ├── 📄 main_window.py # 🏠 Main window layout
│ ├── 📄 cinema_tab.py # 🎬 Cinema mode UI
│ └── 📄 studio_tab.py # 🎨 Studio mode UI
│
└── 📂 utils/ # 🔧 Utility functions
├── 📄 file_handler.py # 📂 File operations
├── 📄 media_info.py # ℹ️ Media metadata
└── 📄 helpers.py # 🛠️ Helper functions
| Principle | Description | Guarantee |
|---|---|---|
| 🔌 100% Offline | App never connects to the internet | ✅ Verified |
| 🚫 Zero Tracking | No telemetry, analytics, or data collection | ✅ Verified |
| 💾 Local Storage | All settings stored locally on your device | ✅ Verified |
| 🔓 Open Source | Transparent code with no hidden backdoors | ✅ Verified |
| 🔐 No Cloud Sync | Your media never leaves your computer | ✅ Verified |
┌─────────────────────────────────────────────────────────────────┐
│ 📂 LOCAL DATA STORAGE │
├─────────────────────────────────────────────────────────────────┤
│ │
│ settings.json │
│ ├── 🔊 Volume level │
│ ├── 🎵 Last played track │
│ ├── 📋 Recent playlists │
│ ├── 🎨 UI preferences │
│ ├── 🎤 Last used voice preset │
│ └── 🖼️ Window size and position │
│ │
│ 📍 Location: Same directory as main.py │
│ 🗑️ Delete anytime to reset all settings │
│ │
└─────────────────────────────────────────────────────────────────┘
| Rule | Description |
|---|---|
| 🆓 Personal Use Only | This software is free for personal, non-commercial use |
| 🚫 No Malicious Use | Do not use to distribute malware or pirated content |
| ✏️ Attribution Required | Maintain "Designed by Sudhir Kumar" credit when sharing |
| 🔧 Modification Allowed | You may modify the code for personal use |
| 📤 Redistribution | Contact author before redistributing modified versions |
🤔 Is this player really 100% offline?
Yes! Universal Media Player is designed to work completely offline. It never connects to the internet, ensuring your media and usage patterns remain completely private.
🤔 What media formats are supported?
Universal Media Player supports all formats that VLC Media Player supports, including:
- Video: MP4, MKV, AVI, MOV, WMV, FLV, WebM, and more
- Audio: MP3, FLAC, WAV, AAC, OGG, M4A, and more
🤔 Can I use this commercially?
The current license is for personal use only. For commercial licensing inquiries, please contact the author.
🤔 Why does it require VLC to be installed?
Universal Media Player uses the VLC media engine (libVLC) for reliable, high-quality media playback. This provides support for virtually all media formats without additional codec installations.
🤔 Can I contribute to this project?
Contributions are welcome! Please see the Contributing section for guidelines.
🤔 How do I report bugs or request features?
Please open an issue on the GitHub repository with a detailed description of the bug or feature request.
- 🎬 Cinema Mode with frameless UI
- 🎨 Studio Mode with visualizations
- 🎤 Real-time voice changer
- 🔊 200% volume boost
- 🔁 A-B loop functionality
- 📸 Video screenshot capture
- 📌 Always on top mode
- 🔲 Mini-player mode
- 🎨 Additional visualization modes
- 🌙 Light/Dark theme toggle
- 📝 Subtitle support
- 🎧 Audio equalizer
- 🌐 Streaming URL support
- 📱 Companion mobile remote app
- 🎵 Spotify-like music library
- 🤖 AI-powered audio enhancement
- 🎙️ Custom voice preset creator
Version 2.0.0 (Current)
New Features:
- ✨ Complete UI overhaul with modern design
- 🎤 Real-time voice changer with 4 presets
- 🌈 4 new visualization modes
- 📸 High-resolution screenshot capture
- 🔲 Mini-player mode
Improvements:
- ⚡ 50% faster startup time
- 🎨 Smoother animations (30+ FPS)
- 💾 Better settings persistence
- 🖼️ Improved window management
Bug Fixes:
- 🐛 Fixed volume slider responsiveness
- 🐛 Fixed fullscreen exit on Escape
- 🐛 Fixed memory leak in visualizer
Version 1.5.0
New Features:
- 🔁 A-B Loop functionality
- 🔊 Volume boost up to 200%
- 📌 Always on top mode
Improvements:
- Better keyboard shortcut handling
- Improved playlist management
Version 1.0.0
Initial Release:
- Basic video and audio playback
- Cinema and Studio tabs
- Simple visualizer
- Volume and seek controls
Contributions are welcome and appreciated! 🎉
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
| Type | Guidelines |
|---|---|
| 🐛 Bug Reports | Include steps to reproduce, expected vs actual behavior |
| ✨ Feature Requests | Describe the feature and its use case |
| 📝 Code Contributions | Follow existing code style, add comments |
| 📖 Documentation | Clear, concise, and helpful |
Need help? Have questions? Reach out!
| Role | Description |
|---|---|
| 🎨 Designer | Created the modern, intuitive UI/UX |
| 💻 Developer | Built the entire application from scratch |
| 📖 Documentation | Wrote comprehensive documentation |
| 🔧 Maintainer | Actively maintains and updates the project |
"Empowering your offline media experience with style and privacy."
Special thanks to the amazing open-source projects that made this possible:
| Project | Contribution |
|---|---|
| VideoLAN / VLC | Powerful media engine |
| Python Software Foundation | Amazing programming language |
| Riverbank Computing | PyQt5 framework |
| Open Source Community | Inspiration and support |
This project is licensed for Personal Use Only.
© 2026 Universal Media Player by Sudhir Kumar
All Rights Reserved.
This software is provided for personal, non-commercial use only.
Redistribution or commercial use requires explicit permission from the author.