2017-12-28 15:09:40 +02:00
|
|
|
# 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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Requirements
|
|
|
|
|
|
|
|
|
|
- Python 3.x (native)
|
|
|
|
|
- [gmusicapi] (PYPI)
|
|
|
|
|
- [urwid] (PYPI)
|
|
|
|
|
- [pyyaml] (PYPI)
|
|
|
|
|
- lib[vlc] (native, distributed with VLC player)
|
|
|
|
|
|
|
|
|
|
# What works
|
|
|
|
|
- Playback
|
|
|
|
|
- Music library
|
|
|
|
|
- Playlists
|
|
|
|
|
- Queue
|
|
|
|
|
- Configuration
|
|
|
|
|
- Caching (partially)
|
|
|
|
|
- Basic error handling
|
|
|
|
|
|
|
|
|
|
# What is developer
|
|
|
|
|
|
|
|
|
|
- Search
|
|
|
|
|
- Add to playlist
|
|
|
|
|
- Like/dislike
|
|
|
|
|
- Caching
|
|
|
|
|
- Other functionality that is supported by [gmusicapi]
|
|
|
|
|
|
|
|
|
|
# Installation
|
|
|
|
|
|
|
|
|
|
0. Install Python 3 and VLC.
|
|
|
|
|
|
|
|
|
|
## Method 1 (automatic)
|
|
|
|
|
|
|
|
|
|
1. Source the 'activate.sh' script. It will initialize the Python virtual env and install the dependencies:
|
|
|
|
|
|
2017-12-28 15:11:16 +02:00
|
|
|
```bash
|
|
|
|
|
source activate.sh
|
|
|
|
|
```
|
2017-12-28 15:09:40 +02:00
|
|
|
|
|
|
|
|
2. Run the player:
|
|
|
|
|
|
2017-12-28 15:11:16 +02:00
|
|
|
```bash
|
|
|
|
|
./app.py
|
|
|
|
|
```
|
2017-12-28 15:09:40 +02:00
|
|
|
|
|
|
|
|
## Method 2 (manual)
|
|
|
|
|
|
|
|
|
|
1. Create & activate virtualenv:
|
|
|
|
|
|
2017-12-28 15:11:16 +02:00
|
|
|
```bash
|
|
|
|
|
virtualenv .env
|
|
|
|
|
source .env/bin/activate
|
|
|
|
|
```
|
2017-12-28 15:09:40 +02:00
|
|
|
|
|
|
|
|
2. Install the requirements:
|
|
|
|
|
|
2017-12-28 15:11:16 +02:00
|
|
|
```bash
|
|
|
|
|
pip install -r requirements.txt
|
|
|
|
|
```
|
2017-12-28 15:09:40 +02:00
|
|
|
|
|
|
|
|
3. Run the player:
|
|
|
|
|
|
2017-12-28 15:11:16 +02:00
|
|
|
```bash
|
|
|
|
|
./app.py
|
|
|
|
|
```
|
2017-12-28 15:09:40 +02:00
|
|
|
|
|
|
|
|
# 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
|
|
|
|
|
|
|
|
|
|
- `<UP|DOWN|LEFT|RIGHT>` - nagivate around
|
|
|
|
|
- `<ALT> + 1..9` - switch active tab
|
|
|
|
|
- `<ENTER>` - play selected track
|
|
|
|
|
- `<CTRL> w` - play/pause
|
|
|
|
|
- `<CTRL> e` - play next song
|
|
|
|
|
- `<SHIFT> <LEFT|RIGHT>` - seek backward/forward by 5% of the song duration
|
|
|
|
|
- `<CTRL> s` - toggle shuffle
|
|
|
|
|
- `<CTRL> r` - toggle song repeat
|
|
|
|
|
|
|
|
|
|
# Credits
|
|
|
|
|
|
|
|
|
|
Made by Andrew Dunai.
|
|
|
|
|
|
|
|
|
|
Regards to [gmusicapi] and [VLC] who made this possible.
|
|
|
|
|
|
|
|
|
|
[gmusicapi]: https://github.com/simon-weber/gmusicapi
|
|
|
|
|
[VLC]: https://wiki.videolan.org/python_bindings
|
|
|
|
|
[urwid]: urwid.org/
|
|
|
|
|
[pyyaml]: https://github.com/yaml/pyyaml
|
|
|
|
|
|
