Skip to main content

A fancy TUI client for Google Play Music

Project description

TUIJam

A fancy TUI client for Google Play Music.

TUIJam seeks to make a simple, attractive, terminal-based interface to listening to music for Google Play Music All-Access subscribers.

asciicast

Dependencies

Installation

git clone git@github.com:cfangmeier/tuijam.git
cd tuijam
python setup.py install --user

Or from pypi

pip install --user tuijam

Configuration

When you first launch TUIJam, it checks for a config file in $HOME/.config/tuijam/config.yaml with the following content:

email: you@your-email.com
password: your-password
device_id: yourdeviceid

If this file doesn't exist, TUIJam will guide you through a first-time setup where you will need to supply your google music email, password, and (optionally) a separate password to encrypt your google credentials locally.

Note that if you have 2-factor setup on your Google account, you need to make an app-password for TUIJam.

Additional Configuration

  • persist_queue: (Default: True) Saves the current queue and reloads it when the app resumes
  • reverse_scrolling: (Default: False) Switches the direction of mouse scrolling

MPRIS Support

TUIJam supports a subset of the MPRIS spec to allow for external control via clients such as playerctl. Currently, the following behavior is supported:

  • Get current song metadata (Title/Album/Artist)
  • Get player status (Playing/Paused/Stopped)
  • Play/Pause current song
  • Next Song
  • Stop

If this causes problems for you, please feel free to create an issue, but this feature can also be disabled by placing the following line in your config file:

mpris_enabled: false

Controls

  • ctrl-c quit
  • ctrl-p toggle play/pause
  • ctrl-k stop
  • ctrl-q add all songs in search result to queue
  • ctrl-n move to next song
  • ctrl-r view recently played songs
  • ctrl-w Clear the current queue
  • ctrl-s shuffle queued songs (Note: If this hangs, try running stty -ixon in your terminal and restarting tuijam)
  • ctrl-u Thumbs up the currently playing song
  • ctrl-d Thumbs down the currently playing song
  • > seek forward 10 seconds
  • < seek backwards 10 seconds
  • + volume up
  • - volume down
  • tab/shift-tab cycle focus through search/queue/input windows
  • In search window,
    • q Add selected song/album to queue
    • r Create radio station around selected song/album/artist and add 50 songs from it to queue
    • e view information about selected song/album/artist
    • backspace go back in search/expand history
  • In queue window,
    • u move selected song up in queue
    • d move selected song down in queue
    • delete remove selected song from queue
  • In input window,
    • Type search query and press enter. Results are shown in search window.
    • Enter an empty query to view the suggested "Listen Now" stations and albums.

Thanks

TUIJam was heavily inspired by the gpymusic project, and, of course, could not exists without the great gmusicapi.

This project is neither affiliated with nor endorsed by Google.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tuijam-0.2.13.tar.gz (13.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page