Yatoro

First Apple Music Player in Terminal

Overview

Yatoro is a standalone Apple Music player written in Swift intended to be used in a Terminal emulator.

Yatoro strives for bringing all the features of the Apple Music app into your Terminal.

Installation

Requirements

• Active Apple Music subscription
• macOS Sonoma or higher
  • MusicKit library is only available on macOS for now. The workaround for Linux is being actively looked into, if you have any ideas please let me know
• Terminal of your preference

Steps

• Download pre-built release or build it from source:

  • Clone the repository:

  git clone https://github.com/jayadamsmorgan/Yatoro.git
  cd Yatoro
  

  • Install notcurses library with homebrew:

  brew install notcurses
  

  • Build it:

  swift build -c release
  

  • Optionally, install it, or add it to PATH:

  sudo cp .build/release/Yatoro /usr/local/bin/.
  

• Important: Add both your Terminal and the Yatoro application in System Settings -> Privacy & Security -> Media & Apple Music

• Run the app

Feature status

The player is still very early in the development, so the features are quite limited for now.

Usage

Default Controls

Configuring

Some of the options might be configured with command line arguments. Check Yatoro -h.

Another way to configure everything is to edit ~/.config/Yatoro/config.yaml. Example configuration:

mappings:
  - key: " " # SPACE
    action: playPauseToggle

  - key: "D"
    modifiers:
      - shift
    action: clearQueue

ui:
  margins:
    all: 10
    left: 20

Default config

mappings:
  - key: "p"
    action: playPauseToggle

  - key: "P"
    modifiers:
      - shift
    action: play

  - key: "p"
    modifiers:
      - ctrl
    action: pause

  - key: "c"
    modifiers:
      - ctrl
    action: stop

  - key: "C"
    modifiers:
      - shift
    action: clearQueue

  - key: "f"
    action: playNext

  - key: "F"
    modifiers:
      - shift
    action: startSeekingForward

  - key: "b"
    action: playPrevious

  - key: "B"
    modifiers:
      - shift
    action: startSeekingBackward

  - key: "r"
    action: restartSong

  - key: "S"
    modifiers:
      - shift
    action: startSearching

  - key: ":"
    modifiers:
      - shift
    action: openCommmandLine

  - key: "q"
    action: quitApplication

ui:
  margins:
    all: 0
    left: null
    right: null
    top: null
    bottom: null

logging:
  ncLogLevel: -1
  logLevel: null

Command line arguments will overwrite the options set in config.yaml