https://github.com/goriy/pplay
Simple audio player (frontend to vlc) written in python
https://github.com/goriy/pplay
audio-player gui python3 tkinter-python vlc-media-player
Last synced: 25 days ago
JSON representation
Simple audio player (frontend to vlc) written in python
- Host: GitHub
- URL: https://github.com/goriy/pplay
- Owner: goriy
- License: mit
- Created: 2020-06-22T09:23:25.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-06-23T12:02:12.000Z (almost 6 years ago)
- Last Synced: 2025-09-11T19:27:45.111Z (9 months ago)
- Topics: audio-player, gui, python3, tkinter-python, vlc-media-player
- Language: Python
- Size: 87.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
README
# pplay
Simple audio player written in python3.
## Description
This is a small audio player written in python3.
It uses vlc as backend player and mutagen (python3-mutagen)
package to obtain audio files metadata.
## Installation
### Dependencies
Player depends on installed [vlc player](https://www.videolan.org/).
Also it depends on python mutagen package.
On debian linux it can be installed via apt package manager:
```
apt-get install python3-mutagen
```
For Windows it can be downloaded from [unofficial package builds](https://www.lfd.uci.edu/~gohlke/pythonlibs/).
Alternatively, it can also be installed via pip3:
```
pip3 install mutagen
```
### Install
You may clone this repo and run (at the root folder of reposotory clone):
```
pip3 install --upgrade .
```
Alternatively you may download the python *wheel* package and install it:
```
pip3 install --upgrade pplay-1.0-py3-none-any.whl
```
Another way is to install directly from remote repository:
```
pip3 install --upgrade git+https://github.com/goriy/pplay.git
```
## Usage
### Command line
Usage: pplay [file]
### Hotkeys
* Esc - exit
* O - show open file dialog to choose audio file to play.
* L - toggle loop playback
* A - toggle window topmost (always on top) mode
* U - toggle option to unload player after playback
* Space - toggle play/pause
* Left, Right - change current playback position (ff, rewind)
* Up, Down - change volume
## VLC python bindings
Player uses vlc player python bindings. Its source code is copied into
pplay sources *WITHOUT* any modification.
In this regard, it is not mentioned
as a dependency - its source code is already included.
These vlc bindings are licensed under the LGPL license.
This player just imports vlc bindings (links with it).
The source code remains unmodified and is provided with
the source code of the player itself.
This package (vlc bindings) can be downloaded/installed independently as described
[here](https://pypi.org/project/python-vlc/).