https://github.com/f0903/soundclouder

A client for the SoundCloud API which does not require an auth key.
https://github.com/f0903/soundclouder

api-client downloader no-token soundcloud soundcloud-api soundcloud-downloader

Last synced: 2 months ago
JSON representation

A client for the SoundCloud API which does not require an auth key.

• Host: GitHub
• URL: https://github.com/f0903/soundclouder
• Owner: F0903
• Created: 2022-04-08T04:12:15.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-04-27T17:41:46.000Z (8 months ago)
• Last Synced: 2024-09-26T12:01:19.841Z (3 months ago)
• Topics: api-client, downloader, no-token, soundcloud, soundcloud-api, soundcloud-downloader
• Language: C#
• Homepage:
• Size: 74.2 KB
• Stars: 4
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Soundclouder

A minimal asynchronous client for the SoundCloud API which requires no Auth Key.

You only need a client_id, which can be gotten by inspecting intercepted requests from SoundCloud under the "network" tab in the developer window from any browser.

Currently, the library is very primitive.

It also includes a convenient test console app, that can be used standalone to download tracks and playlists from SoundCloud.

### Examples

#### Basic Stream URL

```cs

using Soundclouder;

var client = new SearchClient("*your client id*");

var searchResult = await client.SearchAsync("*your search query*");

var media = searchResult.First(); // Filter your result.

var url = await media.GetStreamURLAsync();

```

#### Download and Conversion

**(Requires [FFmpeg.exe](https://ffmpeg.org/download.html) in app directory or PATH!)**

```cs

using Soundclouder;

var client = new SearchClient("*your client id*");

var searchResult = await client.SearchAsync("*your search query*");

var media = searchResult.First(); // Filter your result.

await media.DownloadAsync("./out.mp3"); // You can use any path and extension, and ffmpeg will convert automatically.

```

### Logging

The library also includes very basic optional logging output via Soundclouder.Logging.Log.

To use this, simply set the Handler property to a method of your choice.

```cs

using Soundclouder.Logging;

Log.Handler += (severity, message) => Console.WriteLine($"[{severity.ToString().ToUpper()}] {message}");

```