SoundCloud Sync

A library and CLI tool to sync your SoundCloud likes to local files.

Features

• Download liked tracks from any SoundCloud profile
• Automatic metadata tagging (title, artist, artwork) using ID3v2
• Preserves like dates as file modification times
• Supports incremental syncing (only downloads new likes)
• Can be used as a library in other projects
• No external dependencies required (pure JavaScript/TypeScript implementation)
• Cross-platform support with pre-built binaries

Quick Start

CLI Usage

# Install globally
npm install -g soundcloud-sync

# Download your likes
soundcloud-sync -u your-username

Pre-built binaries are also available from the releases page for:

• Linux (x64, ARM64)
• macOS (x64, ARM64/Apple Silicon)
• Windows (x64)

Library Usage

# Install in your project
npm install soundcloud-sync
# or
yarn add soundcloud-sync

import { soundCloudSync } from 'soundcloud-sync';

await soundCloudSync({
  username: 'your-username',
  limit: 100,
  folder: './my-music'
});

Documentation

• API Reference

Releases

Published automatically to:

• npm
• GitHub Releases (pre-built binaries)