63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
|
|
|
|
|
|
# Librespot-Python
|
|
Open Source Spotify Client
|
|
## About The Project
|
|
This project was developed to make the music streaming service Spotify available on any device.
|
|
## 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.
|
|
## Getting Started
|
|
### Prerequisites
|
|
* [Python](https://python.org/)
|
|
### Installation
|
|
Stable Version **\*still not working.**
|
|
```commandline
|
|
pip install librespot
|
|
```
|
|
Snapshot Version \***Recommended**
|
|
```commandline
|
|
pip install git+https://github.com/kokarare1212/librespot-python
|
|
```
|
|
## Usage
|
|
### Get Spotify's OAuth token
|
|
```python
|
|
from librespot.core import Session
|
|
|
|
|
|
session = Session.Builder() \
|
|
.user_pass("<Username>", "<Password>") \
|
|
.create()
|
|
|
|
aceess_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
|
|
|
|
|
|
session = Session.Builder() \
|
|
.user_pass("<Username>", "<Password>") \
|
|
.create()
|
|
|
|
track_id = TrackId.from_uri("<TrackID(ex, spotify:track:xxxxxxxxxxxxxxxxxxxxxx)>")
|
|
|
|
stream = session.content_feeder().load(track_id, VorbisOnlyAudioQuality(AudioQuality.AudioQuality.VERY_HIGH), False, None)
|
|
|
|
# stream.input_stream.stream().read() to get one byte of the music stream
|
|
```
|
|
Please read [this document](https://librespot-python.rtfd.io) for detailed specifications.
|
|
## Roadmap
|
|
Please read [ROADMAP.md](https://github.com/kokarare1212/librespot-python/blob/main/ROADMAP.md).
|
|
## Contributing
|
|
Pull requests are welcome.
|
|
## License
|
|
Distributed under the Apache-2.0 License. See `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)
|
|
## Special thanks
|
|
Coming soon
|