Audio Streaming Feature

Overview

The Audio Streaming feature lets you build a complete music and podcast experience inside your app. You can organize content by genres, artists, albums, and tracks — or set up podcast categories with episodes. The feature supports multiple visual themes, custom colors, and flexible homepage layouts.

Getting Started

To add the Audio feature to your app:

1. Go to Features in the editor sidebar
2. Find Audio in the feature list and click Add
3. Once added, click on it to open the Audio editor

How Content Hosting Works

Since Swiftspeed does not store media files directly, you have two options for providing your audio and image content:

Option 1: Use Direct URLs (Simplest)

If you already have your music and images hosted somewhere (your own website, a file hosting service, etc.), simply paste the direct URL into the appropriate fields when adding genres, artists, albums, or tracks.

• For images: paste the full URL to a JPG or PNG file (e.g., https://yoursite.com/images/album-cover.jpg)
• For audio tracks: paste the full URL to an MP3 or M4A file (e.g., https://yoursite.com/music/track1.mp3)

Tip: If you don't have hosting yet, you can set up a simple website or use any file hosting service to upload your content and get URLs.

Option 2: Configure Cloud Storage

For a more integrated experience, you can connect a cloud storage provider in the Audio editor's Storage settings. Supported providers include:

• Amazon S3 (or S3-compatible services)
• Google Cloud Storage
• FTP/SFTP — Connect to your own server via FTP

Once configured, you'll be able to browse and select files from your cloud storage directly within the editor, rather than pasting URLs manually.

Content Hierarchy

Audio content is organized in a drill-down hierarchy. Each level opens the next:

• Genres — Top-level categories (e.g., Hip Hop, Jazz, Rock)
• Artists — Listed within a genre
• Albums — Listed within an artist
• Tracks — Individual songs within an album (this is where you provide audio file URLs)

Think of it like: Genre → Artist → Album → Track

Adding a Genre

1. In the Audio editor, go to the Music tab
2. Click the + Add Genre button
3. Enter a genre name and paste a URL for the cover image (or use cloud storage if configured)
4. Click Save

Adding an Artist

1. Click on the genre you created to open it
2. Click + Add Artist
3. Enter the artist name, provide an image URL, and click Save

Adding an Album

1. Click on an artist to open their page
2. Click + Add Album
3. Enter the album title, provide a cover art URL, optionally set the year
4. Click Save

Adding Tracks

1. Click on an album to open it
2. Click + Add Track
3. Enter the track name and artist name
4. Paste the direct URL to your audio file (MP3, M4A, etc.) hosted on your own server or cloud storage
5. Click Save

Tip: You can reorder tracks by dragging them into your preferred order.

Podcasts

The Audio feature also supports podcast-style content with a separate Podcasts tab.

Adding a Podcast Category

1. Go to the Podcasts tab in the Audio editor
2. Click + Add Category
3. Enter a category name, provide an image URL, and add an optional subtitle and description
4. Click Save

Adding Podcast Episodes

1. Click on a podcast category to open it
2. Click + Add Episode
3. Enter the episode name, description, and paste the URL to your audio file
4. Click Save

Homepage Layout

The Homepage tab in the Audio editor lets you control what sections appear on the audio feature's main screen. You can toggle and reorder these sections:

• Hero Banner — A large banner at the top (set custom image URL and text)
• Featured Tracks — Highlighted tracks that appear prominently
• Recent Tracks — Latest tracks added
• Top Tracks — Most popular tracks by play count
• Genres — Browse by genre
• Artists — Browse by artist
• Playlists — Curated playlists
• Podcasts — Podcast categories

Use the toggle switches to show or hide each section, and drag to reorder them.

Playlists

Create curated playlists from your existing tracks:

1. Go to the Playlists tab
2. Click + New Playlist
3. Enter a name and provide a cover image URL
4. Add tracks to the playlist by selecting from your existing library
5. Click Save

Themes & Customization

The Audio feature comes with 8 visual themes to match your app's style. Select a theme from the Design tab in the Audio editor.

Custom Colors

You can customize the following colors to match your brand:

• Background Color — Main background of the audio screens
• Text Color — Primary text color
• Title Color — Heading and title color
• Tint Color — Accent color for buttons and highlights
• Player Background — Now Playing screen background
• Player Text Color — Text on the Now Playing screen
• Player Controls Color — Play/pause and control button colors
• Mini Player Background — The mini player bar color
• Mini Player Text — Text color on the mini player

Guest Screen & Access Control

You can set up a guest screen that appears before users access the audio content. This is useful for showing a welcome message, promotional banner, or requiring login. Configure it in the Settings tab of the Audio editor.

In-App Experience

Once set up, your app users will see:

• Home Screen — Customizable layout with your chosen sections
• Browse — Navigate through genres, artists, albums
• Now Playing — Full-screen player with album art, progress bar, and controls (play, pause, next, previous, shuffle, repeat)
• Mini Player — Persistent bottom bar showing current track while browsing
• Search — Search across all tracks, artists, albums, and podcasts
• Playlists — Access curated playlists

Tips

• Use high-quality cover images (at least 500×500px) for the best visual experience
• MP3 format offers the best compatibility across all devices
• Organize your content logically — users navigate by drilling down from genres to tracks
• Enable only the homepage sections you need to keep the interface clean
• Make sure your hosted audio file URLs are publicly accessible (not behind login walls)
• If you don't have your own hosting, consider setting up a simple cloud storage account (Amazon S3, Google Cloud) to host your files
• Preview your audio feature in the editor to see how it looks before publishing