Skip to content

Sharing & Collaboration

ScratchTrack Pro lets you share songs with other users and collaborate in real time with branching and merge requests.

Pro feature

Sharing and collaboration features require a ScratchTrack Pro subscription.

Sharing a Song

Share dialog

  1. Open the song you want to share.
  2. Click the Share button in the toolbar.
  3. Search for a user by name or email (minimum 2 characters).
  4. Select the user from the results.
  5. Choose an access level:
    • Read Only — They can view and listen, but not edit
    • Can Edit — They can create branches and make changes
  6. Grant access.

The shared user will see the song under Shared with Me in their sidebar.

Access Levels

Level Can View Can Listen Can Edit Can Merge to Main
Read Only Yes Yes No No
Can Edit Yes Yes Yes (on branches) No
Owner Yes Yes Yes Yes

Main Branch Protection

The main branch is protected in shared songs:

  • Only the song owner can make direct changes to main.
  • Collaborators with edit access work on branches.
  • To get changes into main, collaborators submit a merge request.

Managing Permissions

To update or revoke access:

  1. Open the Share panel for the song.
  2. See the list of users with access.
  3. Change a user's access level, or revoke their access entirely.

Merge Requests

Merge request

Merge requests are how collaborators propose changes to the main branch.

Creating a Merge Request

  1. Make your changes on a branch (not main).
  2. Click the Merge Requests button in the toolbar.
  3. Select Create Merge Request.
  4. Choose the target branch (typically main).
  5. Submit the request.

Reviewing a Merge Request (Owner)

As the song owner, you can review incoming merge requests:

  1. Click the Merge Requests button.
  2. View the list of pending requests.
  3. Click a request to see the diff — all changes are displayed with visual indicators.
  4. Approve to merge the changes, or Reject to decline.

Cloud Sync

Shared songs sync automatically via the cloud. ScratchTrack uses a two-layer sync system:

  • Database sync — Song structure, commits, branches, and metadata
  • Fragment sync — Audio files (uploaded/downloaded in 10-second chunks)

Sync Status

The toolbar shows a sync indicator with:

  • A spinning icon when syncing is active
  • The current sync phase (e.g., "Uploading fragments")
  • A count of pending operations
  • Error details if something goes wrong

Manual Refresh

Click the refresh button next to the sync indicator to manually trigger a sync.

Offline Support

Works offline

If you lose internet connectivity, you can continue working on your local copy. Changes are queued and will sync automatically when you're back online. The sync queue persists between app sessions — nothing is lost.

Collaboration Workflow

A typical collaboration workflow looks like this:

  1. Owner creates a song and shares it with a collaborator.
  2. Collaborator sees the song under "Shared with Me" and opens it.
  3. Collaborator creates a branch and makes changes (records tracks, edits MIDI, adjusts mix).
  4. Collaborator submits a merge request.
  5. Owner reviews the changes, resolves any conflicts, and approves the merge.
  6. Both users see the updated main branch after sync.

Next Steps