Restyled by prettier-markdown
This commit is contained in:
66
README.md
66
README.md
@@ -2,28 +2,50 @@
|
||||

|
||||

|
||||
[](https://deepsource.io/gh/kokarare1212/librespot-python/?ref=repository-badge)
|
||||
|
||||
# Librespot-Python
|
||||
|
||||
Open Source Spotify Client
|
||||
|
||||
## About The Project
|
||||
This project was developed to make the music streaming service Spotify available on any device.
|
||||
|
||||
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.
|
||||
For other guidelines, please see [CODE_OF_CONDUCT.md](https://github.com/kokarare1212/librespot-python/blob/main/CODE_OF_CONDUCT.md).
|
||||
|
||||
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/)
|
||||
|
||||
- [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
|
||||
|
||||
@@ -34,7 +56,9 @@ session = Session.Builder() \
|
||||
|
||||
aceess_token = session.tokens().get("playlist-read")
|
||||
```
|
||||
|
||||
### Get Music Stream
|
||||
|
||||
\*Currently, music streaming is supported, but it may cause unintended behavior.
|
||||
|
||||
```python
|
||||
@@ -53,24 +77,44 @@ stream = session.content_feeder().load(track_id, VorbisOnlyAudioQuality(AudioQua
|
||||
# stream.input_stream.stream().read() to get one byte of the music stream.
|
||||
# ex: 1 (If there is no more voice data, -1 is received as the result.)
|
||||
```
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
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)
|
||||
```
|
||||
|
||||
## Roadmap
|
||||
Please read [ROADMAP.md](https://github.com/kokarare1212/librespot-python/blob/main/ROADMAP.md).
|
||||
|
||||
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](https://github.com/kokarare1212/librespot-python/blob/main/LICENSE.txt) for more information.
|
||||
|
||||
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)
|
||||
|
||||
- [Librespot](https://github.com/librespot-org/librespot) (Concept)
|
||||
- [Librespot-Java](https://github.com/librespot-org/librespot-java) (Core)
|
||||
|
||||
## Special thanks
|
||||
|
||||
Coming soon
|
||||
|
||||
Reference in New Issue
Block a user