Need help with spotify-cli-mac?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

ersel
142 Stars 28 Forks MIT License 94 Commits 8 Opened issues

Description

ğŸŽ¶ A nodejs app to control Spotify without leaving your terminal. ğŸŽ¶

Services available

!
?

Need anything else?

Contributors list

# 117,196
CSS
HTML
React
spotify
46 commits
# 460,271
JavaScr...
spotify
mac
12 commits
# 470,837
JavaScr...
spotify
mac
11 commits
# 44,630
ls
React
vscode
curl
1 commit
# 660,059
JavaScr...
spotify
mac
1 commit
# 346,487
Objecti...
keepass
spotify
mac
1 commit
# 193,081
HTML
spotify
mac
CSS
1 commit
# 78,336
Twitter
HTML
reddit
reddit-...
1 commit

:notes: Spotify Client for Mac OS X :notes:

A nodejs app to control Spotify without leaving your terminal. Only works with Mac Os as it relies on AppleScript behind the scenes to communicate with the Spotify app.

Installation

npm install spotify-cli-mac -g

Client will be available under the alias

spotify

Set-up

In order to use the client, you'll need to set Spotify Credentials. You can do this by going to developer dashboard and then creating a new application.

Once you have created a new Spotify Application, just run the Spotify CLI with

spotify token
command to set your tokens.

Demo

asciicast

Usage

spotify

Commands:

search|s  [query...]  Search for a  (searches tracks by default)
playlist|pl [username]      Get user's public playlists, by default use username in config.json
recommend|rec               Recommend other songs based on the song currently playing.

info|i Display information about the current track along with player status play [uri] Continue playing current track or play the track with the provided URI pause Pause the current track next|n Play the next track in the queue back|b Play the previous track mute|m Mute player unmute|u Unmute player volume|v Display player volume

  • [deltaVolume] Turn the volume up by given amount (0-100), default:10
  • [deltaVolume] Turn the volume down by given amount (0-100), default:10 p Toggle play/pause replay|r Replay current track position|pos [newPosition] Get or set player position [mm:ss], e.g: pos 1:23 quit|q Quit Spotify :( open|o Open Spotify :) shuffle|ts Toggle shuffle on/off repeat|tr Toggle repeat on/off share|sh [type] Display share and copy value to clipboard token|tk Change Client Spotify tokens user|me Set Spotify Username lyrics|ly Display the lyrics of currently playing track

Options:

-h, --help     output usage information
  • V, --version output the version number
  • Displaying Lyrics

    In order to be able to use the

    lyrics
    command, you will need to get a
    Client Access Token
    for the
    Genius API
    . Sign up for API access here: https://genius.com/api-clients

    Once you have your client access token, edit the

    ~/.spotify-cli-config.json
    with
    GeniusAPIClientKey
    key

    Example

    json
    {
      "spotifyClientID": "XXXXXXX",
      "spotifyClientSecret": "XXXXXXX",
      "spotifyUsername": "XXXXXXX",
      "GeniusAPIClientKey": "XXXXXXX"
    }
    

    Displaying Album artwork

    Album artwork will also be displayed if you're using iTerm 2.9+.

    Contributions and feedback are welcome and encouraged!

    We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.