Lib.rs

Spotify for Unix

What does that even mean? It means that this is how I like to search for music and listen to music on a Unix system. This is a spotify controller and does not (yet anyway) include a way to stream the actual music. But there's already a very good such player (which I use with Spotnix): https://github.com/spotifyd/spotifyd.

It's really really early days so there's likely to be some rough edges, missing features and scrappyness... however, I use it daily.

First, here's a taste of what a session might look like (spotnix on the left, on the right we search and select what to play):

So what's so special about this then? Well, you get three named pipes and that's it. What's not to like :-)? The standard names of those pipes:

./input (eg. play something, pause, list devices, search etc.)

./output (results of a search, results of list devices etc.)

./event (really just playback status atm such as progress, track name etc). This is json.

echo search_playlist electronic > ./input

To get the results and select something to play (you can ofc use https://github.com/junegunn/fzf as well, I like https://github.com/lotabout/skim - probably just because I'm biased as I'm very fond of the Rust programming language):

cat ./output | sk | awk '{print $NF}' | xargs -r -I{} echo play {} > ./input

Or just all in one:

echo search_playlist electronic > ./input; cat ./output | sk | awk '{print $NF}' | xargs -r -I{} echo play {} > ./input

To get playback status (eg. progress, name of song / album etc):

cat ./event

(The above updates every 1 second. Just cat again or read that pipe in a loop or whatever you like for updates.)

Obviously you'd probably put all the above things in scripts - but it's up to you how you use it, these are just building blocks - the Unix way. For some basic example scripts, see: examples

The available commands at the moment are (those you send into the ./input pipe):

play <optional spotify uri> (without uri - resume playback)
pause
shuffle true/false
search_track <search string>
search_album <search string>
search_artist <search string>
search_playlist <search string>
devices (list devices available)
device <device id> (selects the device use for playback)
next
prev

The search results are returned in pages with the spotify enforced maximum of 50 items. Since this tool is meant to be used on the command line and actual selection of what to play will likely happen from a newline delimited list of results (using tools like above mentioned fzf or skim), there's a command line option for setting the number of pages to fetch (default is 4). These pages are fetched concurrently using the awesome rayon crate.

Installing

At the moment there's no packages so you'll have to build it. First, install Rust then

cargo install spotnix

Personally I use Nix to manage dependencies, including the Rust toolchain, but I know Rustup is really good. You do need openssl installed for compilation.

To update spotnix you can run

cargo install spotnix --force

To use this program, you must connect to Spotify's Web API

spotnix talks to Spotify's Web API to do it's thing (eg. search, play, pause etc.).

When you start spotnix the first time, you will be asked to login to spotify BUT - to really make it work, you must actually do a little bit more:

1. Open the Spotify applications dashboard
2. Click Create a Client ID and create an app
3. Click Edit Settings
4. Add http://localhost:8182/spotnix to the Redirect URIs
5. Now you can authenticate with Spotify!
6. So back in the terminal, run CLIENT_ID=abcde12345 CLIENT_SECRET=sasjfijs2983 REDIRECT_URI=http://localhost:8182/spotnix
7. Now you'll be redirected - in your browser - to Spotify which will ask you to grant permissions.
8. After accepting, you'll be redirected to localhost which will very likely refuse the connection (unless you really have a web server running on port 8182). Either way, copy the URL and paste into the the terminal where it asks for it (you may need to close the browser window before it asks you for it in the terminal).

Usage

This is currently the help output of spotnix:

spotnix 0.1.2
spotify as a series of "tubes"... or rather named pipes.

USAGE:
    spotnix [OPTIONS]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -d, --device <device>    Default device to use by name
    -e, --event <event>      All events go here (a named pipe) [default: ./event]
    -i, --input <input>      All input goes here (a named pipe) [default: ./input]
    -o, --output <output>    All output goes here (a named pipe) [default: ./output]
    -r, --pages <pages>      Max number of search result pages to fetch (a page contains 50 items) [default: 4]

So that is Spotify for Unix - you get to use all those command line tools you know and love to find and listen to music!