mirror of
https://github.com/vale981/clay
synced 2025-03-05 17:41:42 -05:00
176 lines
4.3 KiB
Markdown
176 lines
4.3 KiB
Markdown
- [About](#clay-alpha)
|
|
- [Quick start](#quick-start)
|
|
- [Documentation](#documentation)
|
|
- [Requirements](#requirements)
|
|
- [What works](#what-works)
|
|
- [What is being developed](#what-is-being-developed)
|
|
- [Installation](#installation)
|
|
* [Method 1 (PyPi, automatic)](#method-1-pypi-automatic)
|
|
* [Method 2 (from source, manual)](#method-2-from-source-manual)
|
|
- [Configuration](#configuration)
|
|
- [Controls](#controls)
|
|
* [General](#general)
|
|
* [Songs](#songs)
|
|
* [Playback](#playback)
|
|
* [Equalizer](#equalizer)
|
|
* [Misc](#misc)
|
|
- [Troubleshooting](#troubleshooting)
|
|
- [Credits](#credits)
|
|
|
|
# Clay [alpha]
|
|
|
|
[](https://travis-ci.org/and3rson/clay) [](http://clay.readthedocs.io/en/latest/?badge=latest)
|
|
|
|
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.)
|
|
|
|
[](https://asciinema.org/a/69ygwYGRDyB5a7pFgyrwWo1ea)
|
|
|
|
# Quick start
|
|
|
|
```bash
|
|
sudo pip install clay-player
|
|
clay
|
|
```
|
|
|
|
# Documentation
|
|
|
|
Documentation is .
|
|
|
|
# Requirements
|
|
|
|
- Python 3.x (native)
|
|
- [gmusicapi] (PYPI)
|
|
- [urwid] (PYPI)
|
|
- [PyYAML] (PYPI)
|
|
- lib[VLC] (native, distributed with VLC player)
|
|
|
|
# What works
|
|
- Playback
|
|
- Music library browsing & management
|
|
- Playlists
|
|
- Radio stations
|
|
- Song search
|
|
- Filtering results
|
|
- Queue management
|
|
- Notifications
|
|
- Audio equalizer
|
|
- Global hotkeys
|
|
- Configuration UI
|
|
- Token caching for faster authorizations
|
|
- Song operations (add to library, start station etc.)
|
|
- Caching (not for song data, that one is coming soon)
|
|
- PYPI package
|
|
|
|
# What is being developed
|
|
|
|
- Like/dislike tracks
|
|
- Playlist editing
|
|
- Artist/album search
|
|
- Other functionality that is supported by [gmusicapi]
|
|
|
|
# Installation
|
|
|
|
0. Install Python 3 and VLC.
|
|
|
|
## Method 1 (PyPi, automatic)
|
|
|
|
Just install the player using `pip`:
|
|
|
|
```bash
|
|
pip install clay-player
|
|
clay
|
|
```
|
|
|
|
## Method 2 (from source, manual)
|
|
|
|
1. Clone the source code.
|
|
|
|
2. Create & activate virtualenv:
|
|
|
|
```bash
|
|
virtualenv .env
|
|
source .env/bin/activate
|
|
```
|
|
|
|
3. Install the requirements:
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
4. Run the player:
|
|
|
|
```bash
|
|
./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.
|
|
- Please 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
|
|
- `<ALT> m` - show context menu for this 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
|
|
|
|
## Equalizer
|
|
- `+` - increase amplification
|
|
- `-` - decrease amplification
|
|
|
|
## Misc
|
|
|
|
- `<ESC>` or `<CTRL> /` or <CTRL> _ - close most recent notification or popup
|
|
- `<CTRL> x` - exit app
|
|
|
|
# Troubleshooting
|
|
|
|
At some point, the app may fail. Possible reasons are app bugs,
|
|
Google Play Music API issues, [gmusicapi] bugs, [urwid] bugs etc.
|
|
|
|
If you encounter a problem, please feel free to submit an .
|
|
I'll try to figure it out ASAP.
|
|
|
|
Most issues can be reproduced only with specific data coming from Google Play Music servers.
|
|
|
|
Use "debug" tab within app to select the error and hit "Enter" to copy it into clipboard.
|
|
This will help me to investigate this issue.
|
|
|
|
# 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
|
|
|