{"id":13580911,"url":"https://github.com/plietar/librespot","last_synced_at":"2025-05-16T11:03:50.502Z","repository":{"id":28481985,"uuid":"31998071","full_name":"plietar/librespot","owner":"plietar","description":"Open Source Spotify client library","archived":false,"fork":false,"pushed_at":"2019-08-23T23:29:46.000Z","size":1072,"stargazers_count":1144,"open_issues_count":83,"forks_count":186,"subscribers_count":79,"default_branch":"master","last_synced_at":"2025-04-09T06:07:13.500Z","etag":null,"topics":["rust","spotify","spotify-connect"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/plietar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-11T04:21:05.000Z","updated_at":"2025-03-28T16:09:16.000Z","dependencies_parsed_at":"2022-09-04T04:00:22.241Z","dependency_job_id":null,"html_url":"https://github.com/plietar/librespot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plietar%2Flibrespot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plietar%2Flibrespot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plietar%2Flibrespot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plietar%2Flibrespot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plietar","download_url":"https://codeload.github.com/plietar/librespot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254518384,"owners_count":22084374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["rust","spotify","spotify-connect"],"created_at":"2024-08-01T15:01:56.204Z","updated_at":"2025-05-16T11:03:50.477Z","avatar_url":"https://github.com/plietar.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"# librespot\n*librespot* is an open source client library for Spotify. It enables\napplications to use Spotify's service, without using the official but\nclosed-source libspotify. Additionally, it will provide extra features\nwhich are not available in the official library.\n\nNote: librespot only works with Spotify Premium.\n\n# Unmaintained\nUnfortunately I am unable to maintain librespot anymore. It should still work,\nbut issues and Pull requests will be ignored. Feel free to fork it and continue\ndevelopment there. If a fork gains traction I will happily point to it from the\nREADME.\n\n## Building\nRust 1.17.0 or later is required to build librespot.\n\n**If you are building librespot on macOS, the homebrew provided rust may fail due to the way in which homebrew installs rust. In this case, uninstall the homebrew version of rust and use [rustup](https://www.rustup.rs/), and librespot should then build.** \n\nIt also requires a C, with portaudio.\n\nOn debian / ubuntu, the following command will install these dependencies :\n```shell\nsudo apt-get install build-essential portaudio19-dev\n```\n\nOn Fedora systems, the following command will install these dependencies :\n```shell\nsudo dnf install portaudio-devel make gcc\n```\n\nOn macOS, using homebrew :\n```shell\nbrew install portaudio\n```\n\nOnce you've cloned this repository you can build *librespot* using `cargo`.\n```shell\ncargo build --release\n```\n\n## Usage\nA sample program implementing a headless Spotify Connect receiver is provided.\nOnce you've built *librespot*, run it using :\n```shell\ntarget/release/librespot --username USERNAME --cache CACHEDIR --name DEVICENAME\n```\n\n## Discovery mode\n*librespot* can be run in discovery mode, in which case no password is required at startup.\nFor that, simply omit the `--username` argument.\n\n## Audio Backends\n*librespot* supports various audio backends. Multiple backends can be enabled at compile time by enabling the\ncorresponding cargo feature. By default, only PortAudio is enabled.\n\nA specific backend can selected at runtime using the `--backend` switch.\n\n```shell\ncargo build --features portaudio-backend\ntarget/release/librespot [...] --backend portaudio\n```\n\nThe following backends are currently available :\n- ALSA\n- PortAudio \n- PulseAudio\n\n## Cross-compiling\nA cross compilation environment is provided as a docker image.\nBuild the image from the root of the project with the following command :\n\n```\n$ docker build -t librespot-cross -f contrib/Dockerfile .\n```\n\nThe resulting image can be used to build librespot for linux x86_64, armhf (compatible e. g. with Raspberry Pi 2 or 3, but not with Raspberry Pi 1 or Zero) and armel.\nThe compiled binaries will be located in /tmp/librespot-build\n\n```\ndocker run -v /tmp/librespot-build:/build librespot-cross\n```\n\nIf only one architecture is desired, cargo can be invoked directly with the appropriate options :\n```shell\ndocker run -v /tmp/librespot-build:/build librespot-cross cargo build --release --no-default-features --features alsa-backend\ndocker run -v /tmp/librespot-build:/build librespot-cross cargo build --release --target arm-unknown-linux-gnueabihf --no-default-features --features alsa-backend\ndocker run -v /tmp/librespot-build:/build librespot-cross cargo build --release --target arm-unknown-linux-gnueabi --no-default-features --features alsa-backend\n```\n\nDon't forget to set the `with-tremor` feature flag if your target device does not have floating-point capabilities.\n\n## Development\nWhen developing *librespot*, it is preferable to use Rust nightly, and build it using the following :\n```shell\ncargo build --no-default-features --features \"nightly portaudio-backend\"\n```\n\nThis produces better compilation error messages than with the default configuration.\n\n## Disclaimer\nUsing this code to connect to Spotify's API is probably forbidden by them.\nUse at your own risk.\n\n## Contact\nCome and hang out on gitter if you need help or want to offer some.\nhttps://gitter.im/sashahilton00/spotify-connect-resources\n\n## License\nEverything in this repository is licensed under the MIT license.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplietar%2Flibrespot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplietar%2Flibrespot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplietar%2Flibrespot/lists"}