Python Soundcloud API
Project description
# Soundcloud-lib
This is a Soundcloud API library that doesn't require a client ID to function. It's basic, it can really only fetch tracks and playlists, but doesn't require the user to go through the soundcloud app approval process.
# Why
I once applied for API access and was approved. I used this access for months until it was revoked for some reason and all my emails and new applications were ignored. I decided to create a library that allows me to do Soundcloud API stuff without an approved application.
# Features
* Does not require a client ID
* Fetches and writes mp3 metadata (Album artist, title, artwork)
* Can fetch entire playlists of tracks
# Installation
This library is installable as a pip package.
```
pip install soundcloud-lib
```
# How
This library uses **programming** and **algorithms** to find a client ID that can be used to access the Soundcloud API. If you want, you can pass your own client ID as the first argument of `SoundcloudAPI()`.
## Saving an mp3 to a file.
This will write the ID3 tags for album artist, track title AND will embed the album artwork into the mp3.
```python
from sclib import SoundcloudAPI, Track, Playlist
api = SoundcloudAPI()
track = api.resolve('https://soundcloud.com/itsmeneedle/sunday-morning')
assert type(track) is Track
filename = f'./{track.artist} - {track.title}.mp3'
with open(filename, 'wb+') as fp:
track.write_mp3_to(fp)
```
## Fetch a playlist
```python
from sclib import SoundcloudAPI, Track, Playlist
api = SoundcloudAPI()
playlist = api.resolve('https://soundcloud.com/playlist_url')
assert type(playlist) is Playlist
for track in playlist.tracks:
print(f'Downloading {track.artist} - {track.title}')
write_mp3_to_file(track)
```
# Bugs or Features
Please report any and all bugs using the issues tab.
Feel free to suggest new features too.
# Contributing
Sure, submit a pull request.
This is a Soundcloud API library that doesn't require a client ID to function. It's basic, it can really only fetch tracks and playlists, but doesn't require the user to go through the soundcloud app approval process.
# Why
I once applied for API access and was approved. I used this access for months until it was revoked for some reason and all my emails and new applications were ignored. I decided to create a library that allows me to do Soundcloud API stuff without an approved application.
# Features
* Does not require a client ID
* Fetches and writes mp3 metadata (Album artist, title, artwork)
* Can fetch entire playlists of tracks
# Installation
This library is installable as a pip package.
```
pip install soundcloud-lib
```
# How
This library uses **programming** and **algorithms** to find a client ID that can be used to access the Soundcloud API. If you want, you can pass your own client ID as the first argument of `SoundcloudAPI()`.
## Saving an mp3 to a file.
This will write the ID3 tags for album artist, track title AND will embed the album artwork into the mp3.
```python
from sclib import SoundcloudAPI, Track, Playlist
api = SoundcloudAPI()
track = api.resolve('https://soundcloud.com/itsmeneedle/sunday-morning')
assert type(track) is Track
filename = f'./{track.artist} - {track.title}.mp3'
with open(filename, 'wb+') as fp:
track.write_mp3_to(fp)
```
## Fetch a playlist
```python
from sclib import SoundcloudAPI, Track, Playlist
api = SoundcloudAPI()
playlist = api.resolve('https://soundcloud.com/playlist_url')
assert type(playlist) is Playlist
for track in playlist.tracks:
print(f'Downloading {track.artist} - {track.title}')
write_mp3_to_file(track)
```
# Bugs or Features
Please report any and all bugs using the issues tab.
Feel free to suggest new features too.
# Contributing
Sure, submit a pull request.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
soundcloud-lib-0.2.1.tar.gz
(4.5 kB
view details)
File details
Details for the file soundcloud-lib-0.2.1.tar.gz
.
File metadata
- Download URL: soundcloud-lib-0.2.1.tar.gz
- Upload date:
- Size: 4.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e72d86aff7fa15b3d033343e195113fb53286c8d42f406f5388f0314bbeb61eb |
|
MD5 | 1b9ba1127e9737a151b96995e47f5e96 |
|
BLAKE2b-256 | 8a1bb5b88d9f0477b15c0ded0d78c9b4ada5335b8de860d76f22a1367811fd5e |