https://github.com/kokarare1212/librespot-python
Open Source Spotify Client
https://github.com/kokarare1212/librespot-python
hacktoberfest librespot librespot-python music-streaming python roadmap
Last synced: 3 months ago
JSON representation
Open Source Spotify Client
- Host: GitHub
- URL: https://github.com/kokarare1212/librespot-python
- Owner: kokarare1212
- License: apache-2.0
- Created: 2021-02-23T23:44:55.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-06-13T05:18:59.000Z (4 months ago)
- Last Synced: 2025-06-13T06:29:32.775Z (4 months ago)
- Topics: hacktoberfest, librespot, librespot-python, music-streaming, python, roadmap
- Language: Python
- Homepage: http://librespot-python.rtfd.io
- Size: 934 KB
- Stars: 262
- Watchers: 5
- Forks: 57
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: docs/supported.md
Awesome Lists containing this project
README
[](https://deepsource.io/gh/kokarare1212/librespot-python/?ref=repository-badge)
# Librespot-Python
Open Source Spotify Client
## Support Project
If you find our project useful and want to support its development, please consider making a donation. Your contribution will help us maintain and improve the project, ensuring that it remains free and accessible to everyone.
[](https://github.com/sponsors/kokarare1212)
[](https://liberapay.com/kokarare1212/)
## About The Project
This project was developed to make the music streaming service Spotify available
on any device.
## Attention!
This repository has been completely rewritten from the transplant.
There may be some functions that are not implemented yet.
If so, please feel free to open an issue.
## Note
It is still in the idea stage, so there is a possibility of unintended behavior
or major specification changes.
We **DO NOT** encourage piracy and **DO NOT** support any form of downloader/recorder designed with the help of this repository and in general anything that goes against the Spotify ToS.
For other guidelines, please see [CODE_OF_CONDUCT.md](https://github.com/kokarare1212/librespot-python/blob/main/CODE_OF_CONDUCT.md).
## Getting Started
### Prerequisites
- [Python](https://python.org/)
### Installation
Stable Version
```commandline
pip install librespot
```
Snapshot Version \***Recommended**
```commandline
pip install git+https://github.com/kokarare1212/librespot-python
```
## Usage
### Use Zeroconf for Login
```python
from librespot.zeroconf import ZeroconfServer
zeroconf = ZeroconfServer.Builder().create()
```
### Use OAuth for Login
#### Without auth url callback
```python
from librespot.core import Session
# This will log an url in the terminal that you have to open
session = Session.Builder() \
.oauth(None) \
.create()
```
#### With auth url callback
```python
from librespot.core import Session
# This will pass the auth url to the method
def auth_url_callback(url):
print(url)
session = Session.Builder() \
.oauth(auth_url_callback) \
.create()
```
### Get Spotify's OAuth token
```python
from librespot.core import Session
session = Session.Builder() \
.oauth(None) \
.create()
access_token = session.tokens().get("playlist-read")
```
### Get Music Stream
*Currently, music streaming is supported, but it may cause unintended behavior.
```python
from librespot.core import Session
from librespot.metadata import TrackId
from librespot.audio.decoders import AudioQuality, VorbisOnlyAudioQuality
session = Session.Builder() \
.oauth(None) \
.create()
track_id = TrackId.from_uri("spotify:track:xxxxxxxxxxxxxxxxxxxxxx")
stream = session.content_feeder().load(track_id, VorbisOnlyAudioQuality(AudioQuality.VERY_HIGH), False, None)
# stream.input_stream.stream().read() to get one byte of the music stream.
```
Other uses are
[examples](https://github.com/kokarare1212/librespot-python/tree/main/examples)
or read [this document](https://librespot-python.rtfd.io) for detailed
specifications.
## Debug
To display the debug information, you need to inject the following code at the
top of the code.
```python
import logging
logging.basicConfig(level=logging.DEBUG)
```
## Contributing
Pull requests are welcome.
## License
Distributed under the Apache-2.0 License. See
[LICENSE.txt](https://github.com/kokarare1212/librespot-python/blob/main/LICENSE.txt)
for more information.
## Related Projects
- [Librespot](https://github.com/librespot-org/librespot) (Concept)
- [Librespot-Java](https://github.com/librespot-org/librespot-java) (Core)