PHPackages                             boxhead/soundcloud-sync - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. boxhead/soundcloud-sync

ActiveCraft-plugin

boxhead/soundcloud-sync
=======================

Sync your Soundcloud track data into Craft Entries

2.0.6(1y ago)022MITPHPPHP ^8.0.2

Since Oct 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/weareboxhead/soundcloud-sync)[ Packagist](https://packagist.org/packages/boxhead/soundcloud-sync)[ RSS](/packages/boxhead-soundcloud-sync/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (12)Used By (0)

Soundcloud Sync plugin for Craft CMS 4.x
========================================

[](#soundcloud-sync-plugin-for-craft-cms-4x)

Sync your Soundcloud track data into Craft Entries

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 4.0.0 or later.

Installation
------------

[](#installation)

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

    ```
    cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
    composer require boxhead/soundcloud-sync

    ```
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Soundcloud Sync.

Soundcloud Sync Overview
------------------------

[](#soundcloud-sync-overview)

Take the headache out of syncing your Soundcloud data into your site with Soundcloud Sync. For the time being syncing only happens one-way, Soundcloud » Craft.

This plugin authorizes with the Soundcloud API using the 'client\_credentials' grant type and can therefore only access plublic content and that from the Soundcloud account owner of the Soundcloud app.

Configuring Soundcloud Sync
---------------------------

[](#configuring-soundcloud-sync)

1. Open up the Soundcloud Sync settings and specify your Soundcloud app details including Client ID, Client Secret and Soundcloud User ID.
2. Specify which Craft Section and Entry Type to have the plugin sync the data to by their respective IDs.
3. You may also optionally specify a comma separated list of Craft category groups by their handle. If these are present the plugin will search for tags associated with a Soundcloud tag that are prefixed with these handles allowing it to automatically create and attach those categories to the resulting Craft Entry. FOr example you may set 'speaker' as a category group handle. If a track contains a tag for 'speaker:Joe Bloggs', 'Joe Bloggs' will be created as a Craft category added to the Craft entry for that track.

Fields
------

[](#fields)

SoundCloud Sync works by saving API data to Craft fields. The fields it looks for by handle include:

- `soundcloudArtwork500`
- `soundcloudArtwork300`
- `soundcloudBpm`
- `soundcloudCommentCount`
- `soundcloudDescription`
- `soundcloudDownloadCount`
- `soundcloudDownloadUrl`
- `soundcloudDuration`
- `soundcloudDurationHuman`
- `soundcloudFavoritingsCount`
- `soundcloudFileId`
- `soundcloudPermalinkUrl`
- `soundcloudPlaybackCount`
- `soundcloudPurchaseUrl`
- `soundcloudRelease`
- `soundcloudStreamUrl`
- `soundcloudStreamable`
- `soundcloudUserPermalink`
- `soundcloudWaveformUrl`

You can setup one, multiple or all of these fields in your Craft installation.

Categories
----------

[](#categories)

As described above the plugin can automatically save genre and tag data to Craft categorfies if formatted in an expected way.

1. Setup your Craft category groups e.g. 'Theme', 'Genre', 'Artist', 'Speaker'
2. Setup category fields that can map to these groups using the following format for the field handles `soundcloudCategories{{ category group handle}}`, so in the case of an 'Artists' categroy group you'd have a field called `soundcloudCategoriesArtist`

Using Soundcloud Sync
---------------------

[](#using-soundcloud-sync)

Soundcloud Sync can be set to run periodically using a Cron task pointing at `{{ your site url }}/actions/soundcloud-sync/sync`. This will search for an create new Craft entries for any Soundcloud tracks that don't yet exist, and will update any existing entries with an updated counts for playback, favourited and comments.

Soundcloud Sync Roadmap
-----------------------

[](#soundcloud-sync-roadmap)

Brought to you by [Boxhead](https://boxhead.io)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity62

Established project with proven stability

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~115 days

Recently: every ~96 days

Total

11

Last Release

529d ago

Major Versions

v1.1.4 → 2.0.22023-11-14

PHP version history (2 changes)2.0.2PHP &gt;=8.0.2

2.0.5PHP ^8.0.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/e4d728d173f94929c1e3161eae8fa21dbca8af5569c303ef32fe5d3253b5f4f5?d=identicon)[boxhead](/maintainers/boxhead)

---

Tags

cmsCraftcraftcmscraft-pluginsoundcloud sync

### Embed Badge

![Health badge](/badges/boxhead-soundcloud-sync/health.svg)

```
[![Health](https://phpackages.com/badges/boxhead-soundcloud-sync/health.svg)](https://phpackages.com/packages/boxhead-soundcloud-sync)
```

###  Alternatives

[nystudio107/craft-seomatic

SEOmatic facilitates modern SEO best practices &amp; implementation for Craft CMS 5. It is a turnkey SEO system that is comprehensive, powerful, and flexible.

1741.4M46](/packages/nystudio107-craft-seomatic)[verbb/image-resizer

Resize assets when they are uploaded.

127269.1k7](/packages/verbb-image-resizer)[verbb/tablemaker

Create customizable and user-defined table fields.

40168.8k1](/packages/verbb-tablemaker)[wrav/oembed

A simple plugin to extract media information from websites, like youtube videos, twitter statuses or blog articles.

36205.0k3](/packages/wrav-oembed)[verbb/hyper

A user-friendly links field for Craft.

24130.9k9](/packages/verbb-hyper)[verbb/social-poster

Automatically post entries to social media.

918.5k](/packages/verbb-social-poster)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
