A modern, ultra-compact media player for Windows, macOS, and Linux with professional file association support. Built with PyQt6 and designed for simplicity and performance.
- Universal Format Support: MP4, AVI, MKV, MOV, WMV, FLV, WebM, M4V, MP3, FLAC, WAV, OGG, M4A, AAC, WMA
- Ultra-Compact Design: Minimalist interface with maximum functionality
- True Volume Amplification: Up to 200% volume boost for quiet media
- Professional File Associations: Double-click any media file to open with VoxPlayer
- Advanced Playlist Management: Smart playlist behavior with search, filtering, and import/export
- Torrent Streaming: qBittorrent integration for streaming media
- Auto-Update System: GitHub-based update checking
- Cross-Platform: Windows, macOS, and Linux support
# 1) Install dependencies
pip install -r requirements.txt
# 2) Run VoxPlayer
python app.py
# Or with a file
python app.py "path/to/video.mp4"Windows:
- Download
VoxPlayer.exefrom Releases - Run
VoxPlayer.exeto start - Run
register_file_associations.batas Administrator for file associations
macOS:
- Download
VoxPlayer-1.0.0-macOS.dmgfrom Releases - Install by dragging VoxPlayer.app to Applications
- Launch from Applications folder
Linux:
- Debian/Ubuntu:
sudo dpkg -i voxplayer_1.0.0_amd64.deb - Fedora/CentOS/RHEL:
sudo dnf install voxplayer-1.0.0-1.x86_64.rpm - Arch Linux:
sudo pacman -U voxplayer-1.0.0-1-x86_64.pkg.tar.zst
git clone https://github.com/voxhash/voxplayer.git
cd voxplayer
pip install -r requirements.txt
python app.pypip install VoxPlayer-1.0.0.tar.gz
voxplayer- Double-Click: Set up file associations, then double-click any media file
- Command Line:
python app.py "path/to/video.mp4" - Drag & Drop: Drag files/folders onto VoxPlayer window
- Add Files: File → Open File(s) or Open Folder, or drag & drop
- Search: Type in search box to filter playlist
- Remove Items: Click X button next to any item
- Import/Export: File → Import/Export Playlist (M3U, PLS, XSPF)
| Shortcut | Action |
|---|---|
Space |
Play/Pause |
Left/Right |
Seek backward/forward |
Up/Down |
Volume up/down |
M |
Mute/Unmute |
F11 |
Toggle fullscreen |
Ctrl+O |
Open file(s) |
Ctrl+L |
Toggle playlist |
Ctrl+Q |
Quit |
Access via File → Settings or Ctrl+,:
| Setting | Description | Default |
|---|---|---|
| Audio Output | Default or Manual device selection | Default |
| Volume | Master volume level | 50% |
| Theme | Dark theme (default) | Dark |
| Auto-Update | Enable/disable update checking | Enabled |
| Update Channel | Stable or Beta updates | Stable |
- Register:
register_file_associations.bat(run as Administrator) - Unregister:
unregister_file_associations.bat - Test:
test_file_associations.bat
# Play a video file
python app.py "movie.mp4"
# Play an audio file
python app.py "song.mp3"- Drag multiple files/folders to create a playlist
- Use search to filter large playlists
- Export playlists for backup or sharing
- Use keyboard shortcuts for efficient control
Planned milestones live in ROADMAP.md. For changes, see CHANGELOG.md.
Upcoming Features:
- Enhanced format support (HEVC, AV1, Opus)
- Audio equalizer with presets
- Playlist shuffle and repeat modes
- Plugin system architecture
- Cloud storage integration
We welcome PRs! Please read CONTRIBUTING.md and follow the PR template.
Please report vulnerabilities via SECURITY.md.
This project is licensed under the terms in LICENSE.
- Changelog - Version history
- Contributing Guide - How to contribute
- Roadmap - Development roadmap
- Development Goals - Technical goals
- Support - Getting help
- PyQt6 - Cross-platform GUI framework
- FFmpeg - Media processing backend
- qBittorrent - Torrent streaming integration
- Community - Feedback and contributions
Made with ❤️ by VoxHash
VoxPlayer - Professional media playback made simple! 🎬✨