· apps · musica · discovery · playlists · guide

Musica: playlists, library search, SoundCloud in-app audio

Playlist and search notes for Musica—not a streaming product. SoundCloud worked in-app; other links are mostly collection + outbound search.

You can bookmark the web. You can’t always play it here.

Experiment, not product. Changelog and blunt scope: Musica app overview + changelog. Discovery here means finding and saving links; hearing them in gato still means SoundCloud (plus a few edge cases), because rights holders and embed rules keep everyone else inside their own clients.

Musica’s preview does a few useful things: search playlists you already saved, call Audius / Internet Archive where fetch is allowed, and hand you deep links to Spotify/Apple/YouTube search when in-app audio is not realistic. Playlists are a fine personal link manager. They are not proof we shipped a universal jukebox — SoundCloud was the listen column that didn’t lie.

Unified Search: Your Music Discovery Command Center

Multi-Source Search in Action

When you search in Musica, you’re not just searching one platform — you’re querying multiple sources simultaneously:

Search: "ambient techno"
├── Local Library: 12 tracks across 3 playlists
├── Audius: 25 live tracks from independent artists  
├── Internet Archive: 8 historical electronic recordings
└── External Links: SoundCloud, YouTube, Spotify search pages

The interface presents results in organized sections, each with context about where the music comes from and how to access it.

Local Library Search: Your Personal Archive

Every search starts with your existing collection:

Smart Pattern Matching — Searches across track titles, artist names, and even URLs to find matches in your playlists.

Cross-Playlist Discovery — Find tracks you forgot you had, scattered across different themed playlists.

Contextual Results — Each result shows which playlist contains the track, making it easy to rediscover organizational patterns.

Live Web Search: Real-Time Discovery

Audius Integration: Independent Artist Discovery

Musica directly integrates with Audius’s discovery API, giving you access to thousands of independent artists and experimental tracks not available on mainstream platforms.

Why Audius? — Decentralized music platform with artist-friendly policies and unique content not found elsewhere.

Direct Integration — Real API calls return rich metadata, cover art, and direct streaming capabilities.

Quality Filtering — Results are normalized and ranked for relevance, filtering out incomplete or low-quality entries.

Internet Archive: Historical Music Discovery

The Internet Archive integration opens up decades of historical recordings, rare performances, and public domain content.

Unique Content — Live concert recordings, rare radio shows, historical performances.

Metadata Rich — Archive entries include detailed descriptions, dates, and provenance information.

Legal Clarity — All Archive content is legally available for streaming and sharing.

For platforms requiring authentication or blocking cross-origin requests, Musica generates optimized search URLs that open directly in each platform’s native interface:

SoundCloud → https://soundcloud.com/search/sounds?q=your+query
YouTube → https://www.youtube.com/results?search_query=your+query
Spotify → https://open.spotify.com/search/your+query

This approach respects each platform’s technical constraints while still giving you one place to search and collect links — even when the listen step only reliably works for SoundCloud today.

Smart Playlist Management

Cross-Provider Playlist Creation

Musica’s killer feature is creating playlists that span multiple streaming platforms:

Mixed-Source Playlists

Playlist: "Electronic Focus"
├── SoundCloud: Deep house mix by underground DJ
├── YouTube: Ambient space music video  
├── Audius: Original experimental track by indie artist
├── Spotify: Mainstream electronic album
└── Archive: Historical Kraftwerk concert recording

Each track maintains its provider-specific metadata and playback method while appearing in a unified playlist interface.

Platform-Agnostic Organization

  • By Mood — “Study Focus” playlist mixing lo-fi YouTube videos with Audius ambient tracks
  • By Genre — “Techno Evolution” spanning Archive historical recordings to current Audius releases
  • By Discovery Source — “New Finds” collecting tracks discovered across all platforms

Advanced Playlist Features

Smart Metadata Management

Track Data Structure:
{
  title: "Track Title",
  artist: "Artist Name", 
  provider: "soundcloud",
  url: "https://...",
  addedAt: "2026-04-23T10:30:00Z",
  discoverySource: "audius-search", // How you found it
  playbackMode: "embed", // embed, direct, or local
  downloadAvailable: true, // SoundCloud downloadable tracks
  tags: ["ambient", "study", "electronic"] // User-defined tags
}

Playlist Analytics and Insights

  • Discovery Tracking — See which search methods yield the best additions
  • Provider Balance — Visualize the mix of platforms in your playlists
  • Playback Patterns — Understanding which tracks get played most often

Playlist Import/Export and Migration

Export Capabilities

// Export playlist as structured data
{
  name: "My Playlist",
  tracks: [
    {
      title: "Track Name",
      artist: "Artist",
      url: "https://platform.com/track",
      provider: "soundcloud",
      notes: "Found via Audius search"
    }
  ],
  metadata: {
    created: "2026-04-23",
    trackCount: 25,
    providers: ["soundcloud", "youtube", "audius"]
  }
}

Migration Strategy

  • Platform Independence — Playlists aren’t locked to any single streaming service
  • URL Preservation — Direct links maintained for maximum compatibility
  • Metadata Backup — Rich context preserved for future migration or sharing

Discovery Workflows and Power User Features

The Discovery Loop

1. Seed Discovery

Start with any track from any platform:

  • Paste a SoundCloud link you heard in a mix
  • Find a YouTube music video through social media
  • Discover an Audius artist through their community features

2. Cross-Platform Exploration

Use Musica’s search to find related content:

  • Search for the artist name across all platforms
  • Explore genre tags to find similar content
  • Use Archive search to find historical context

3. Playlist Integration

Add discoveries to themed playlists:

  • Immediate addition with one-click “Add to Playlist”
  • Automatic metadata extraction and normalization
  • Smart suggestions for existing playlist matches

4. Playback and Refinement

Experience your curated collection:

  • Embedded players when the site allows it — SoundCloud is what we expect to work; others may fail silently or need the native app
  • Audius direct stream when the discovery endpoint returns a URL (nice when it works; not the main “ship” promise yet)
  • Local playback for downloaded SoundCloud files in Electron (when the artist marked the track downloadable)

Advanced Discovery Techniques

Genre Archaeology

Use Internet Archive to explore the historical roots of modern genres:

  1. Search Archive for “early electronic music”
  2. Find influential recordings from the 1960s-80s
  3. Cross-reference with modern Audius artists citing those influences
  4. Create “Genre Evolution” playlists showing progression over decades

Independent Artist Discovery

Leverage Audius for finding artists outside mainstream platforms:

  • Fresh Content — Artists uploading direct to decentralized platforms
  • Unreleased Tracks — Demos and experimental content not available elsewhere
  • Direct Support — Streaming directly supports artists without platform intermediaries

Remix and Mashup Discovery

Use SoundCloud’s remix culture combined with other platforms:

  • Find original tracks on mainstream platforms
  • Discover remixes and covers on SoundCloud
  • Explore DJ mixes incorporating multiple sources
  • Create “Original vs. Remix” comparative playlists

Integration with Gato Ecosystem

Calendar Integration for Music Events

Link music discovery to real-world events:

  • Concert Reminders — Add dates to Gato Calendar when discovering new artists
  • Album Release Tracking — Set reminders for upcoming releases from followed artists
  • Festival Playlist Preparation — Build playlists for upcoming music events

Drive Integration for Music Projects

Connect playlists with creative projects:

  • Mood Boards — Link playlists to visual projects stored in Gato Drive
  • Production References — Organize inspiration tracks for music production
  • Collaboration Sharing — Share playlist exports through Drive for team projects

CRM Integration for Music Professional Use

For music industry professionals:

  • Artist Database — Track discovered artists in CRM with contact information
  • Venue Playlist Curation — Organize music by venue type and event style
  • Client Preference Tracking — Build custom playlists based on client feedback and preferences

Download Management and Offline Capabilities

SoundCloud Download Integration (Electron)

When running in the Electron app, Musica can download SoundCloud tracks marked as downloadable by artists:

Download Workflow

  1. URL Validation — Check if track is marked downloadable
  2. Metadata Extraction — Gather title, artist, artwork information
  3. File Download — Handle download progress and file placement
  4. Library Integration — Add download metadata to playlist entries

Local File Management

Downloaded Track Structure:
{
  ...standardMetadata,
  filePath: "/Users/name/Music/gato/artist-track.mp3",
  downloadedAt: "2026-04-23T10:30:00Z",
  fileSize: "8.5 MB",
  quality: "128kbps MP3",
  playbackMode: "local" // Enables HTML5 audio playback
}

Hybrid Playlists

Combine downloaded tracks with streaming-only content:

  • Offline Capability — Downloaded tracks available without internet
  • Streaming Fallback — Non-downloaded tracks use embed playback
  • Mode switching — UI tries to hide whether a row is local file vs embed; reliability still tracks SoundCloud + downloads first

Backup and Synchronization

Playlist Backup Strategy

  • Local Storage — All playlists backed up in structured JSON
  • Cross-Platform Sync — Same playlists available on web and Electron
  • Export Options — Multiple formats for external backup and sharing

Power User Tips and Advanced Features

Keyboard Shortcuts and Efficiency

Discovery Shortcuts:
Cmd+K: Quick search across all sources
Cmd+Enter: Add current search result to active playlist  
Cmd+Shift+P: Create new playlist from search
Space: Play/pause current track
Cmd+L: Focus search input

Playlist Management:
Cmd+N: New playlist
Cmd+D: Duplicate current playlist
Cmd+E: Export playlist
Delete: Remove selected track from playlist

Search Operators and Advanced Queries

Genre-Specific Discovery

  • ambient artist:biosphere — Find ambient tracks by specific artist
  • live recording archive — Historical live performance search
  • remix -original — Find remixes while excluding original versions

Platform-Specific Searches

  • Use provider buttons to constrain search to specific platforms
  • Combine local matches with outbound web search when in-catalog search is not available
  • Leverage each platform’s unique content strengths

Playlist Strategy for Different Use Cases

Study/Focus Playlists

  • Source Mix — YouTube ambient videos + Audius instrumental tracks
  • Length Strategy — Long-form content to minimize interruptions
  • Discovery Method — Archive historical minimalism + modern lo-fi

DJ Set Preparation

  • Platform Diversity — SoundCloud exclusives + mainstream Spotify tracks
  • Beatmatching Notes — Use playlist notes for BPM and key information
  • Remix Collections — Group originals with all known remixes

Music Production Reference

  • Genre Archaeology — Archive historical recordings + modern interpretations
  • Technical Analysis — Multiple versions (original, remix, cover) for comparison
  • Inspiration Tracking — Link tracks to specific production techniques or sounds

Future Discovery Features

Planned Enhancements

AI-Powered Recommendations

  • Cross-Platform Analysis — Understanding listening patterns across all providers
  • Genre Evolution Tracking — Suggesting historical context for modern discoveries
  • Collaborative Filtering — Learning from Gato community listening patterns

Social Discovery Features

  • Playlist Sharing — Export/import between Gato users
  • Discovery Communities — Platform for sharing cross-provider playlists
  • Influence Mapping — Visualizing musical influence networks across platforms

Advanced Integration

  • Smart Notifications — Alert when followed artists release new content
  • Festival Integration — Auto-generate playlists from festival lineups
  • Radio Station Creation — Algorithm-driven playlist generation from seed tracks

Getting Started with Discovery

New User Workflow

1. Seed Your Library

  • Import a few favorite tracks from different platforms
  • Create 2-3 genre-based playlists to start
  • Experiment with different provider combinations

2. Explore Search Features

  • Try the same search across different provider tabs
  • Explore Audius and Archive for content not found elsewhere
  • Use external search links to discover on native platforms

3. Develop Curation Habits

  • Set aside time for regular discovery sessions
  • Create themed playlists for different activities or moods
  • Export playlists regularly as backup and sharing mechanism

Best Practices for Music Discovery

Diversify Your Sources

  • Mainstream + Independent — Balance popular platforms with decentralized alternatives
  • Historical + Contemporary — Use Archive to understand genre evolution
  • Regional + Global — Explore different cultural approaches to similar genres

Organize for Rediscovery

  • Consistent Naming — Use clear, searchable playlist names
  • Tag Strategy — Develop personal tagging system for cross-playlist discovery
  • Regular Curation — Periodically review and reorganize growing collections

Summary

Musica’s discovery and playlist tools already help you collect and organize links from all over the web — library search, Audius/Archive where the network cooperates, and outbound tabs for the rest. Playback inside gato is still a preview: SoundCloud is the dependable listen path; everything else is “try it and see” while we finish the product.

That is still useful: one place to remember what you found, queue it for later, and understand which services play nice in an embed. When more platforms do, the playlists you built today still pay off.

One canvas for curation — honest headphones for SoundCloud first.

Discovery Sources: src/apps/musica/services/musicaSearchService.js, user workflows, platform APIs, and the collective wisdom of cross-platform music curation.