Woofer player is free open-source cross-platform music player that plays most multimedia files, CDs, DVDs. Whole written in Python and Qt provides easy, reliable, and high quality playback thanks to LibVLC library developed by VideoLAN community.
- Wide media support: Woofer will play almost every possible audio format. Check VLC audio format support page for more information.
- Folder based playback: Your music is not ordered by album or interpret name, but only by its folder structure (on disk).
- Multi-platform: Currently supports both Windows (from XP up to Windows 10) and Linux (tested on Ubuntu distros).
- Fully portable: No installation needed. Woofer will play right from your pen drive.
- Auto-updater: Built-in update checking and installing on Windows.
- Multi-language support: Make your own language .ini file. You can later post it on repo or by email. Finally your translation could be integrated to Woofer player. Currently available languages are English and Czech.
- Gained volume: Ability to set volume level up to 150% without any background tweaking. That means up to 50% gain.
Thanks to Python, Qt and LibVLC, Woofer is developed to run on multiple operating systems. Windows, Linux and Mac OS platforms are supported. Currently Woofer is being tested only on Windows and Linux distribution, because I don't have any Mac OS device to test and debug.
Most recent code is always available here on Github. Python code is readable, well documented and self-explanatory. Feel free to join or fork the project.
Woofer is published under GPL v3 license.
Used packages (Requirements):
- Python 3.5
- PyQt5
- LibVLC Python wrapper
- Send2Trash
- ujson
- Python-XLib (only for Linux)
- PyInstaller v3 (only for build)
- psutil v3 (only for build)
For Windows there are available binary distributions. On Linux you can run Woofer like any other Python application by woofer.py or you can build your own binaries, which however will depend on your distribution (distribution branch). Because there are so many Linux distributions and even most popular Ubuntu-based distributions have major version differences (new compiler, etc.), no pre-build Woofer binaries will be available.
Latest binary version for Windows can be found in release section. This is a standalone version, no other libraries or VLC is needed! Newer versions then could be installed through built-in updater system (auto-updates feature).
Refer to requirements for all needed packages to run Woofer. Both for Windows and Linux there are available suitable binaries (PyQt, etc.). No need to build anything from source. Unfortunately you also need VLC Media player installed (core libraries). Note that all these libraries are shipped with Woofer binary distribution.
Finally run woofer.py or woofer.py --debug in debug mode.
To create standalone binary distribution, install all listed requirements packages. Make sure to install PyInstaller v3 package and add PyInstaller executable binary to PATH. You also need to provide VLC x86/x64 libraries (depending on python binary version) to build standalone distribution. Woofer has been tested with VLC 2.1x libraries, but any newer version should be fine. Download and extract or install VLC Media player. You need to provide paths to libvlc.dll, libvlccore.dll and .\plugins folder in build.py script (header section). For default all these files should be located in Woofer root directory in .\libvlc or .\libvlc64 folder (depending on Python binary version). When you have all packages installed and VLC core files linked, you can run .\build\build.py script. Result will be stored in .\build\release directory.
- only bug fixing