Restyled by prettier-markdown

This commit is contained in:
Restyled.io 2021-05-22 01:26:37 +00:00
parent adb111fa8b
commit 632fc07c00
5 changed files with 78 additions and 30 deletions

View File

@ -2,28 +2,50 @@
![Stars](https://img.shields.io/github/stars/kokarare1212/librespot-python.svg) ![Stars](https://img.shields.io/github/stars/kokarare1212/librespot-python.svg)
![Forks](https://img.shields.io/github/forks/kokarare1212/librespot-python.svg) ![Forks](https://img.shields.io/github/forks/kokarare1212/librespot-python.svg)
[![DeepSource](https://deepsource.io/gh/kokarare1212/librespot-python.svg/?label=active+issues&show_trend=true)](https://deepsource.io/gh/kokarare1212/librespot-python/?ref=repository-badge) [![DeepSource](https://deepsource.io/gh/kokarare1212/librespot-python.svg/?label=active+issues&show_trend=true)](https://deepsource.io/gh/kokarare1212/librespot-python/?ref=repository-badge)
# Librespot-Python # Librespot-Python
Open Source Spotify Client Open Source Spotify Client
## About The Project ## 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 ## 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. It is still in the idea stage, so there is a possibility of unintended behavior
For other guidelines, please see [CODE_OF_CONDUCT.md](https://github.com/kokarare1212/librespot-python/blob/main/CODE_OF_CONDUCT.md). 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 ## Getting Started
### Prerequisites ### Prerequisites
* [Python](https://python.org/)
- [Python](https://python.org/)
### Installation ### Installation
Stable Version **\*still not working.** Stable Version **\*still not working.**
```commandline ```commandline
pip install librespot pip install librespot
``` ```
Snapshot Version \***Recommended** Snapshot Version \***Recommended**
```commandline ```commandline
pip install git+https://github.com/kokarare1212/librespot-python pip install git+https://github.com/kokarare1212/librespot-python
``` ```
## Usage ## Usage
### Get Spotify's OAuth token ### Get Spotify's OAuth token
```python ```python
from librespot.core import Session from librespot.core import Session
@ -34,7 +56,9 @@ session = Session.Builder() \
aceess_token = session.tokens().get("playlist-read") aceess_token = session.tokens().get("playlist-read")
``` ```
### Get Music Stream ### Get Music Stream
\*Currently, music streaming is supported, but it may cause unintended behavior. \*Currently, music streaming is supported, but it may cause unintended behavior.
```python ```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. # 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.) # 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 ## 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 ```python
import logging import logging
logging.basicConfig(level=logging.DEBUG) logging.basicConfig(level=logging.DEBUG)
``` ```
## Roadmap ## 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 ## Contributing
Pull requests are welcome. Pull requests are welcome.
## License ## 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 ## 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 ## Special thanks
Coming soon Coming soon

View File

@ -16,6 +16,5 @@ currently being supported with security updates.
Use this section to tell people how to report a vulnerability. Use this section to tell people how to report a vulnerability.
Tell them where to go, how often they can expect to get an update on a Tell them where to go, how often they can expect to get an update on a reported
reported vulnerability, what to expect if the vulnerability is accepted or vulnerability, what to expect if the vulnerability is accepted or declined, etc.
declined, etc.

View File

@ -1,2 +1,3 @@
# API Reference # API Reference
Coming soon :)
Coming soon :)

View File

@ -7,13 +7,14 @@
## Contents ## Contents
* [Get Started](index.md) - [Get Started](index.md)
* [Supported Futures](supported.md) - [Supported Futures](supported.md)
* [API Reference](api.md) - [API Reference](api.md)
## What's librespot-python? ## What's librespot-python?
librespot-python is a python port of Spotify's open source client library [librespot](https://github.com/librespot-org/librespot). librespot-python is a python port of Spotify's open source client library
[librespot](https://github.com/librespot-org/librespot).
It was created to play Spotify on various platforms and devices. It was created to play Spotify on various platforms and devices.
@ -29,19 +30,20 @@ Please keep in mind that this library is not like Spotify approved.
Therefore, the worst that can happen is that you will be banned from Spotify. Therefore, the worst that can happen is that you will be banned from Spotify.
Also, please keep in mind that this library is in alpha and may behave in unintended ways. Also, please keep in mind that this library is in alpha and may behave in
unintended ways.
## Installation ## Installation
You can download this library in the following way. You can download this library in the following way.
Stable Version ***still not working.** Stable Version **\*still not working.**
```commandline ```commandline
pip install librespot pip install librespot
``` ```
Snapshot Version ***Recommended** Snapshot Version **\*Recommended**
```commandline ```commandline
pip install git+https://github.com/kokarare1212/librespot-python pip install git+https://github.com/kokarare1212/librespot-python
@ -64,7 +66,7 @@ aceess_token = session.tokens().get("playlist-read")
### Get Music Stream ### Get Music Stream
*Currently, music streaming is supported, but it may cause unintended behavior. \*Currently, music streaming is supported, but it may cause unintended behavior.
```python ```python
from librespot.core import Session from librespot.core import Session
@ -85,11 +87,12 @@ stream = session.content_feeder().load(track_id, VorbisOnlyAudioQuality(AudioQua
## Debug ## 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 ```python
import logging import logging
logging.basicConfig(level=logging.DEBUG) logging.basicConfig(level=logging.DEBUG)
``` ```

View File

@ -6,10 +6,11 @@
| Get Metadata | | | Get Metadata | |
| Play Music | △*1 | | Play Music | △\*1 |
| Spotify Connect | ×*2 | | Spotify Connect | ×\*2 |
*1 It is currently possible to retrieve the music stream, but it requires separate software for decoding. \*1 It is currently possible to retrieve the music stream, but it requires
separate software for decoding.
*2 This feature will be added in the future. \*2 This feature will be added in the future.