am-cli

(appleMusic-cli-player Fork)

Control your music directly from the terminal

Overview

This is a fork of the appleMusic-cli-player tool by talz-a. It was made to extend the original tool's features to include these new abilities:

• add songs to playlists
• make new playlists
• go back to the previous song
• build and run the tool with Docker
• (Possibly later) gaming controller support

All credit for creating the project, the original commands, and the album art features goes to talz-a.

[FROM OG REPO]

appleMusic-cli-player is a command-line interface (CLI) tool designed to control music playback on Apple Music. Built using Go and the Cobra CLI library, it allows you to manage your music without leaving the terminal. With commands for playing, pausing, skipping tracks, and more, this tool offers seamless control over your Apple Music experience.

Usage

• List of Commands:

  music [command]

  • completion - Generate the autocompletion script for the specified shell
  • current - Display currently playing song information
  • help - Get help about any command
  • next - Skip to the next track in Apple Music
  • open - Open Apple Music
  • pause - Pause music playback
  • play - Play the current song in Apple Music
  • playlists - Choose a playlist to play
  • shuffle - Toggle shuffle mode in Apple Music
  • volume - Set the volume for Apple Music

  New commands in this fork:

  • back - Go back to the previous song
  • add - Add the song that is currently playing to a playlist
  • new - Create a new playlist

• Flags:

  -h, --help     Help for music
  -t, --toggle   Help message for toggle

Use music [command] --help for more information about a specific command.

Run

• Clone the (fork) repository

  git clone https://github.com/ofdryads/am-cli.git

• Navigate to the project directory

  cd am-cli

• Build the project

  go build

• Run the CLI

  ./music

Docker

In the project directory,

1. Build

docker build -t am-cli .

2. Run

docker run am-cli ./music [command-here]