Metadata-Version: 2.1
Name: tuijam
Version: 0.3.3
Summary: A fancy TUI client for Google Play Music
Home-page: https://github.com/cfangmeier/tuijam
Author: Caleb Fangmeier
Author-email: caleb@fangmeier.tech
License: MIT
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](https://asciinema.org/a/155875.png)](https://asciinema.org/a/155875)
        
        # Dependencies
        * [Python >= 3.6](https://www.python.org/downloads)
        * [mpv](https://mpv.io)
        * [youtube-dl](https://rg3.github.io/youtube-dl/)
        
        # Installation
        ```bash
        git clone git@github.com:cfangmeier/tuijam.git
        cd tuijam
        python setup.py install --user
        ```
        
        Or from pypi
        ```bash
        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:
        ```yaml
        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](https://specifications.freedesktop.org/mpris-spec/latest/) spec to allow for external control via clients such as [playerctl](https://github.com/acrisci/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:
        
        ```yaml
        mpris_enabled: false
        ```
        # Youtube
        From version 0.3.0, Youtube videos are included in search results. By default, no video is shown during playback, but this can be changed by adding the following line to the config file:
        
        ```yaml
        video: true
        ```
        
        
        # 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](https://github.com/christopher-dG/gpymusic) project, and, of course,
        could not exists without the great
        [gmusicapi](https://github.com/simon-weber/gmusicapi).
        
        This project is neither affiliated with nor endorsed by Google.
        
Keywords: terminal music streaming
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: Unix
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3 :: Only
Description-Content-Type: text/markdown
