Metadata-Version: 2.2
Name: soundcloudpy
Version: 0.1.2
Summary: Client for async connection to the Soundcloud api.
Author-email: Giel Janssens <giel@music-assistant.io>
License: Apache-2.0
Platform: any
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: aiohttp>=3.11.0
Provides-Extra: test
Requires-Dist: black==24.10.0; extra == "test"
Requires-Dist: codespell==2.3.0; extra == "test"
Requires-Dist: isort==5.13.2; extra == "test"
Requires-Dist: mypy==1.14.1; extra == "test"
Requires-Dist: pre-commit==4.0.1; extra == "test"
Requires-Dist: pre-commit-hooks==5.0.0; extra == "test"
Requires-Dist: pylint==3.3.3; extra == "test"
Requires-Dist: pytest==8.3.4; extra == "test"
Requires-Dist: pytest-aiohttp==1.0.5; extra == "test"
Requires-Dist: pytest-cov==6.0.0; extra == "test"
Requires-Dist: ruff==0.8.5; extra == "test"
Requires-Dist: safety==3.2.14; extra == "test"

# Soundcloud python async client

Async client for connecting to the Soundcloud API.

This is a Wrapped API that it is used from soundcloud web browser, its is subjected to changes and `NOT OFFICIAL`

This package is based on soundcloudpy from Naím Rodríguez https://github.com/naim-prog
Original package https://github.com/naim-prog/soundcloud-py

## Installation

The package is published on PyPI and can be installed by running:
```
pip install soundcloudpy
```

## How to get OAuth and Client id

1. Go to [soundcloud](https://soundcloud.com) and login in
2. Open the "Inspect" tool (F12 on most browsers)
3. Refresh the page
4. Go to the page "Network" on the inspect terminal
5. Search on the column "File" for the "client_id" and the "oauth_token" cookie for "Authorization"

`client_id`: string of 32 bytes alphanumeric

`authorization`: string that begins with OAuth and a string (the o-auth token is "OAuth . . .")

Example (OAuth and client_id are NOT real, use yours):

```
python -m example --client_id jHvc9wa0Ejf092wj3f3920w3F920as02 --auth_token 'OAuth 3-26432-21446-asdif2309fj'
```


## Functions

* Own account details
* User public details
* Own following
* Who to follow
* Last tracks reproduced info
* User profiles from tracks likes
* Track details
* Tracks liked
* Tracks by genre recent
* Tracks by genre popular
* Popular track from user
* Own playlists
* Playlists details
* Playlists by genre
* Playlists from user
* Recommended tracks of a track
* Stream URL's of a track (you can use it to reproduce the audio in VLC for example)
* Comments of a track
* Get mixed selection of playlists
* Search
* Subscribe feed
* Albums from user
* All feed from user


## DISCLAIMER

I take no responsability for the issues you may have with your soundcloud account or for breaching the [Terms of Use](https://developers.soundcloud.com/docs/api/terms-of-use) of soundcloud
