https://github.com/dspearson/librespot-auth
https://github.com/dspearson/librespot-auth
Last synced: 11 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dspearson/librespot-auth
- Owner: dspearson
- License: isc
- Created: 2024-08-05T16:04:34.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-26T15:04:45.000Z (almost 2 years ago)
- Last Synced: 2024-08-27T17:08:27.661Z (almost 2 years ago)
- Language: Rust
- Size: 23.4 KB
- Stars: 31
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# librespot-auth
A simple program for populating a `credentials.json` via Spotify's zeroconf authentication.
## Optional Arguments
- `--name`: Name of the virtual speaker (default: "Speaker").
- `--path`: Target path for credentials (default: `credentials.json` relative to execution).
- `--class`: Class of device, defaults on omission to speaker,
one of: computer, tablet, smartphone,
speaker, tv, avr, stb, audiodongle,
gameconsole, castaudio, castvideo,
automobile, smartwatch, chromebook,
carthing, homething.
## How It Works
While running on the same network as a Spotify client, it should appear as a Spotify Connect device with the given name. Select it once as an output device, and the Spotify client will transmit the required authentication blob. This blob is received by this application, written to the specified credentials path, and the application immediately exits.
This process is useful in cases where you run librespot on remote hosts on a different network (thus complicating zeroconf). As of version 3.203.235 of the Spotify eSDK, the `SpConnectionLoginPassword` API has been removed.
## Pre-built binaries
Pre-built statically-linked binaries are available under the releases section for 64-bit Linux systems.
## Building
Install the rust toolchain (see https://rustup.rs/), and run `cargo build --release`.
## Example Usage (spotifyd)
A kind user pointed out that if you select a device type of class 'computer' then premium is not required, so this functionality is implemented (but optional, defaulting to speaker, which is what I use):
```bash
$ ./target/release/librespot-auth --name "Second Laptop" --class=computer
Open Spotify and select output device: Second Laptop
```
Open the Spotify client from a machine on the same network as you ran this, ensuring no proxy is in use that may interfere with zeroconf. Select the speaker you just defined, i.e. "Second Laptop", as an output device. The credentials are then saved to `credentials.json` in the provided path. Ensure spotifyd is stopped, i.e. `sudo systemctl stop spotifyd`, copy this file to your spotifyd `cache_directory`, and then start spotifyd again (`sudo systemctl start spotifyd`).