2.6 KiB
Clay [alpha]
Standalone command line player for Google Play Music.
This app wouldn't be possible without the wonderful gmusicapi and VLC libraries.
This project is neither affiliated nor endorsed by Google.
It's being actively developed, but is still in the early alpha version, so many features are missing and/or may be bugged.
(Click the image below to see the screencast.)
Requirements
- Python 3.x (native)
- gmusicapi (PYPI)
- urwid (PYPI)
- PyYAML (PYPI)
- libVLC (native, distributed with VLC player)
What works
- Playback
- Music library
- Playlists
- Radio stations
- Queue management
- Notifications
- Configuration
- Caching (partially)
What is being developed
- Search
- Like/dislike
- Caching
- Other functionality that is supported by gmusicapi
Installation
- Install Python 3 and VLC.
Method 1 (automatic)
-
Source the 'activate.sh' script. It will initialize the Python virtual env and install the dependencies:
source activate.sh -
Run the player:
./clay/app.py
Method 2 (manual)
-
Create & activate virtualenv:
virtualenv .env source .env/bin/activate -
Install the requirements:
pip install -r requirements.txt -
Run the player:
./clay/app.py
Configuration
In order to use this app, you need to know your Device ID. Typically gmusicapi should display possible IDs once you type a wrong one. Also be aware that this app has not been tested with 2FA yet.
Controls
General
<UP|DOWN|LEFT|RIGHT>- nagivate around<ALT> + 1..9- switch active tab
Songs
<ENTER>- play highlighted track<CTRL> w- play/pause<CTRL> e- play next song<CTRL> a- append highlighted song to the queue<CTRL> u- remove highlighted song from the queue<CTRL> p- start station from highlighted song
Playback
<CTRL> s- toggle shuffle<CTRL> r- toggle song repeat<SHIFT> <LEFT|RIGHT>- seek backward/forward by 5% of the song duration<CTRL> q- seek to song beginning
Misc
<ESC>- close most recent notification (we should remap this to something else)<CTRL> x- exit app
Credits
Made by Andrew Dunai.