Music Streaming App — User Guide

Welcome to the Music Streaming app for SmartLinks. This guide walks you through setting up your music player and managing your track library.

Overview

The Music Streaming app lets you share your music with fans through an embeddable player. You can upload tracks, organise playlists, set up exclusive content for verified users, and customise your artist profile — all from the admin panel.

Getting Started

1. Open the Admin Panel

Navigate to the admin page for your collection. You'll see the Music Admin panel with three tabs: Tracks, Playlists, and Artist Settings.

2. Set Up Your Artist Profile

Go to the Artist Settings tab and fill in:

• Artist / Band Name (required) — The name displayed in the player header.
• Artist Bio — A short biography. Keep it to 2–3 sentences.
• Artist Image URL — A link to your profile photo. This appears in the "Now Playing" header.
• Banner Image URL — A wider image used as a visual backdrop.

3. Add Social Links

Still on the Artist Settings tab, you can add links to your profiles on:

• Spotify
• Apple Music
• Instagram
• Twitter / X
• Your website

These appear as icons in the player so fans can find you elsewhere.

4. Save Your Changes

Click the Save Configuration button at the top of the admin panel. Changes are not saved automatically — always save before navigating away.

Managing Tracks

Adding a Track

1. Go to the Tracks tab.
2. Click Add Track.
3. Fill in the track details:
   • Title (required)
   • Artist (required)
   • Album (optional)
   • Audio File — Upload an MP3 file directly, or paste a URL to a hosted file.
   • Cover Art URL (optional) — A link to the track's artwork.
   • Exclusive — Toggle on if this track should only be fully available to verified users.
   • Preview Duration — For exclusive tracks, how many seconds non-verified users can hear (default: 30).
4. Click Save in the dialog.
5. Click Save Configuration to persist your changes.

Uploading Audio Files

You can drag and drop an MP3 file onto the upload area, or click to browse your files. The file is uploaded to SmartLinks asset storage and the URL is filled in automatically. Duration is detected from the file.

Editing a Track

Click the pencil icon on any track to reopen the editor and change its details.

Deleting a Track

Click the trash icon on a track to remove it. Remember to save afterwards.

Reordering Tracks

Drag tracks by the grip handle (the six-dot icon on the left) to change their order. The order you set here is the order fans see in the player.

Managing Playlists

1. Go to the Playlists tab.
2. Click Add Playlist.
3. Give it a name, optional description, and optional cover art URL.
4. Select which tracks belong to the playlist.
5. Toggle Exclusive if the playlist should only be visible to verified users.
6. Save the playlist, then save the overall configuration.

How Fans Experience the Player

When a fan visits the public link, they see:

• Your artist name and image in the header.
• A list of available tracks they can play immediately.
• Standard playback controls: play/pause, skip forward/back, progress scrubbing, and volume.
• A full-screen player mode with audio visualisation.
• Exclusive tracks show a lock icon and play only a short preview for unverified users.

Bulk Import via CSV

If you have many tracks to add at once, you can import them using a CSV file. The expected columns are:

Example CSV:

title,artist,album,duration,audioUrl,coverArt,isExclusive,previewDuration
Moonshine,The Band,Debut Album,234,https://cdn.example.com/moonshine.mp3,https://cdn.example.com/cover.jpg,false,30
Secret Track,The Band,Debut Album,180,https://cdn.example.com/secret.mp3,,true,15

CSV import is handled through the SmartLinks AI setup wizard — ask the assistant to "import tracks from CSV" and provide your file.

Widgets

The app includes an Example Widget that can be embedded in the SmartLinks portal. It shows a summary card with your app name and a button to open the full player. Widgets appear automatically where the platform places them — no extra setup is needed.

FAQ & Troubleshooting

Q: I saved my config but the player still shows old data. A: Try refreshing the public page. If the issue persists, open the admin panel and verify your changes were saved (check for the success toast message).

Q: Audio plays for the first track but not when I switch tracks. A: This is usually a browser autoplay restriction. Ensure your audio files are served with proper CORS headers. Files uploaded through the admin panel are handled automatically.

Q: My uploaded file shows an error. A: Check that the file is a valid MP3 and under the size limit. The upload progress bar will show an error message with details.

Q: Exclusive tracks play fully for everyone. A: The exclusive/preview gating relies on the SmartLinks platform knowing whether the user is verified. Ensure the platform is passing user context correctly.

Q: I don't see the admin panel. A: Make sure you're accessing the admin URL (/admin.html#/) and that you have admin permissions for the collection.

Q: How do I change the order of tracks? A: On the Tracks tab, drag tracks using the grip handle on the left side of each track row. Save after reordering.