soundcloud-search

CLI to query Soundcloud for tracks matching a given query

Usage no npm install needed!

<script type="module">
  import soundcloudSearch from 'https://cdn.skypack.dev/soundcloud-search';
</script>

README

soundcloud-search

CLI to query Soundcloud for tracks matching a given query

Installation

npm install soundcloud-search

Add -g to install globally, otherwise execute using node_modules/.bin/soundcloud-search

Usage

NAME
  soundcloud-search - CLI to query Soundcloud for tracks matching a given query

SYNOPSIS
  soundcloud-search [OPTION]... FILE

DESCRIPTION
  Resolve track queries to Soundcloud tracks, taking queries as each line of FILE.
  Unfortunately an explicit input file and output file has to be given since
  STDIN and STDOUT are used to prompt the user to resolve tracks for each query.

  -o, --output-file
    required. Where to write resulting JSON objects. Output as NDJSON

  -n, --num-results
    max number of results to display when prompting the user to resolve queries

  -s, --soundcloud-client-id
    soundcloud client ID to use when accessing their API. Can also be set with
    the env var SC_CLIENT_ID

EXAMPLE

  Read all track plays from a CSV file with headers `artist` and `track`

    export SC_CLIENT_ID="..."
    soundcloud-search -o results/tracks.ndjson \
      <(cat data/plays.csv | \
        csv-parser --seperator=";" | \
        jq -r '.artist + " - " + .track' \
      )

License

ISC