Music Library Guide

Welcome to your music library! This comprehensive guide will help you navigate, organize, and enjoy all your AI-generated music tracks. The music library is your central hub for managing and playing your creative compositions.

Introduction to Music Library

Your music library is a personalized collection of all the AI-generated music you've created. It provides a clean, organized interface to browse, play, and manage your tracks. Whether you're looking for a specific song or want to enjoy your entire collection, the library offers multiple viewing options and powerful playback features.

Key Features

Organized Collection: All your music in one place
Multiple View Modes: Switch between grid and list layouts
Version Management: View and play different versions of each track
Single Track Playback: Play individual songs
Play All Feature: Enjoy your entire collection
Pagination: Easy navigation through large collections
Global Player Integration: Seamless playback experience
Track Management: View details, download, and organize

Accessing Your Music Library

From Dashboard: Click on "Music Library" or "My Music" in the main navigation
Music Library
Quick Access: Use the music icon () in the top navigation

Library Overview

When you open your music library, you'll see:

Total Track Count: Number of songs in your collection
View Mode Toggle: Switch between grid and list views
Play All Button: Start playing your entire collection
Refresh Button: Update the library with new tracks
Pagination Controls: Navigate through multiple pages

Playing Single Track

How to Play a Single Song

Grid View

In grid view, each track appears as a card with album artwork:

Locate the Track: Find the song you want to play
Click the Play Button: Hover over the track card and click the play icon ()
Player Appears: The Global Music Player appears at the bottom of the screen
Track Information: View song name, artist, and progress

List View

In list view, tracks appear in a table format:

Find the Track: Browse through the list
Click Play Icon: Click the play button () in the track row
Playback Starts: The track begins playing immediately
Visual Indicator: The current track is highlighted in green

Track Information Display

Each track shows:

Artwork: Album cover or default music icon
Song Name: Title of the composition (editable)
Artist: Creator name or "Unknown Artist"
Duration: Total length of the track
Creation Date: When the music was generated
Prompt: The AI prompt used to create the music

Playback Controls

Once a single track is playing:

Play/Pause (/): Control playback
Progress Bar: Seek to any position in the track
Download (): Save the track to your device
Expand (): View full track details and lyrics
Close (): Hide the player

Managing Track Versions

Understanding Music Versions

When you generate music with AI, you often receive multiple versions of the same creation. Our version management system helps you explore and enjoy all variations of your tracks effortlessly.

What are Versions?

Multiple Variations: Each music generation typically produces 2 versions
Same Prompt, Different Results: AI creates unique interpretations
Organized Display: All versions grouped under one track entry
Easy Access: Switch between versions with a single click

Viewing Available Versions

Version Indicator

Each track card displays version information:

Version Badge: Shows total number of versions
- Appears in the top-right corner of track card
- Example: "2 versions" or "3 versions"
- Click to expand version list
Primary Version: The main version displayed by default
- Shows as the cover image
- Plays when you click the main play button
- Usually the first generated version

Accessing Version List

Grid View:

Locate the version badge on any track card
Click the badge or the expand icon
Version list appears below the main track
Each version shows as a smaller card

List View:

Find the version indicator in the track row
Click to reveal all available versions
Versions display as sub-rows
Click any version to play

Playing Different Versions

Quick Version Switching

Method 1 - Direct Play:

Expand Versions: Click the version badge or expand button
View All Versions: See thumbnails of all available versions
Click to Play: Click the play button on any version
Seamless Playback: Selected version starts playing immediately
Visual Feedback: Currently playing version is highlighted

Method 2 - From Player:

Open Global Player: Play any version to activate the player
Version Selector: Look for version options in the expanded player view
Switch Versions: Click on a different version thumbnail
Instant Switch: New version plays from the beginning

Version Playback Features

Smooth Transitions:

Instant switching between versions
No loading delays or interruptions
Automatic progress reset for new version
Previous playback state preserved

Smart Highlighting:

Currently playing version is clearly marked
Visual indicators show active version
Easy to identify which variation is playing
Consistent across all view modes

Version-Specific Actions

Each version has individual controls:

Download Versions

Individual Downloads: Download any specific version
Format Options: MP3 or WAV (based on subscription)
Version Labels: Downloads include version number in filename
Quality: Each version maintains high audio quality

Specific Version Sharing: Share exact version you prefer
Version Context: Recipients see the same variation
Professional Use: Choose best version for projects

Benefits of Version Management

Creative Flexibility

Compare Variations: Listen to different interpretations
Choose Best Fit: Select version that matches your vision
A/B Testing: Compare versions for projects
Backup Options: Multiple choices ensure usability

Enhanced Experience

No Lost Variations: All generated versions preserved
Easy Discovery: Find the perfect version quickly
Organized Library: Clean interface despite multiple versions
Efficient Storage: Smart grouping saves space

Professional Workflow

Client Options: Present multiple versions to clients
Project Matching: Pick version that fits project mood
Quality Assurance: Always have alternatives
Creative Insurance: Never settle for one interpretation

Version Best Practices

Organization Tips:

Listen to all versions before selecting favorite
Note which version works best for specific uses
Keep track of version preferences for future reference
Use version variety to match different project needs

Quality Comparison:

Play versions back-to-back for direct comparison
Check melody variations between versions
Notice rhythm and tempo differences
Identify unique elements in each version

Download Strategy:

Download preferred version for immediate use
Save alternate versions for future projects
Organize downloads with clear version labels
Keep backups of all versions for important tracks

Editing Track Titles

Customizing Music Titles

Give your music tracks personalized, meaningful titles that help you organize and identify your collection more effectively.

Why Edit Titles?

Better Organization:

Create descriptive names that reflect the track's mood or purpose
Use consistent naming conventions across your library
Make tracks easier to find and identify
Build a professional-looking music collection

Enhanced Workflow:

Quickly identify tracks in large collections
Match titles to project requirements
Organize music by theme, genre, or client
Share tracks with clear, descriptive names

How to Edit Track Titles

Step-by-Step Process

Locate the Track: Find the music track you want to rename in your library
Click Edit Icon: Look for the edit button next to the track title
Enter New Title: Type your desired title in the input field
Save Changes: Click the save button or press Enter to confirm
Instant Update: Title updates immediately across your library and player

Title Editing Tips

Naming Best Practices:

Keep titles concise but descriptive (recommended: under 60 characters)
Include genre or mood keywords for easy searching
Use consistent formatting (e.g., "Genre - Mood - Description")
Avoid special characters that may cause display issues

Organizational Strategies:

By Project: "Client Name - Project Type - Version"
By Mood: "Upbeat Pop - Summer Vibes"
By Genre: "Ambient Chill - Meditation Music"
By Date: "2025-10 - Epic Orchestral Theme"

Title Editing Across Views

Grid View

Edit icon appears when hovering over track card
Click the pencil icon next to the title
Inline editing without leaving the page
Title updates reflect immediately in the card

List View

Edit button available in each track row
Quick access for batch renaming sessions
More space for viewing longer titles
Easier to maintain consistency across multiple tracks

Benefits of Custom Titles

Personal Organization

Quick Recognition: Instantly identify tracks by meaningful names
Easy Searching: Find specific tracks using descriptive keywords
Project Management: Group related tracks with similar naming patterns
Memory Aid: Titles help recall the purpose or context of each track

Professional Use

Client Presentations: Present tracks with professional, clear titles
Portfolio Building: Showcase work with well-named compositions
Collaboration: Share tracks with team members using descriptive names
License Management: Track usage rights with clear identification

Library Management

Scalability: Manage large collections without confusion
Categorization: Virtual organization through naming conventions
Export Ready: Downloaded files have meaningful filenames
Future-Proof: Clear titles remain useful as your library grows

Title Editing Best Practices

Consistency is Key:

Develop a naming convention and stick to it
Use the same format across similar track types
Document your naming system for reference
Review and update titles periodically

Make Titles Meaningful:

Avoid generic names like "Track 1" or "Untitled"
Include context that helps future identification
Consider how you'll search for this track later
Think about how others might interpret the title

Optimize for Discovery:

Include searchable keywords
Use descriptive adjectives (upbeat, melancholic, energetic)
Mention instruments or key characteristics
Add version numbers or iteration indicators if needed

Playing All Tracks

Play All Feature

The "Play All" button is a powerful feature that lets you enjoy your entire music collection as a continuous playlist.

How to Use Play All

Locate the Button: Find the "Play All" button at the top of your music library
- Icon: with "Play All" text
- Position: Near the view mode toggle and refresh button
Click Play All: Click the button to start playback
- Loads all tracks from your library
- Creates a playlist in order of display
- Starts playing from the first track
Player Opens: The Global Music Player appears with:
- Full playlist loaded
- Track navigation controls (, )
- Playback mode options (, , )
- Playlist panel access ()

Playlist Behavior

When playing all tracks:

Sequential Playback: Plays tracks in the order displayed in your library
Auto-Next: Automatically plays the next track when one finishes
Continuous Play: Loops back to the first track after the last one
Full Control: Use next/previous buttons to navigate

Playback Modes

After starting "Play All", you can change the playback mode:

Loop All (Default)

Plays all tracks in order
Returns to the first track after finishing the last
Icon:

Repeat One

Continuously repeats the current track
Other tracks remain in the playlist
Icon:

Shuffle

Plays tracks in random order
Each track plays once before repeating
Icon:

Managing the Playlist

While playing all tracks, you can:

View Playlist: Click to see all tracks
Jump to Track: Click any song in the playlist panel to play it
Remove Tracks: Not available (use library page to manage)
Add More: Play additional tracks to extend the playlist

Integration with Global Music Player

The music library works seamlessly with the Global Music Player, providing a unified listening experience across the entire application.

How They Work Together

Starting Playback from Library

Library as Source: When you play music from the library, it becomes the source
Player Activation: The global player appears at the bottom
State Sync: Both library and player stay synchronized
Navigation Freedom: Browse other pages while music continues

Locate Current Track

The global player includes a locate feature () that:

Finds the Track: Locates the currently playing song in your library
Auto-Navigation: Jumps to the correct page if you have multiple pages
Visual Highlight: Highlights the current track for easy identification
Quick Access: Returns you to the library context

Continuous Playback

Page Navigation: Music continues when browsing other sections
Persistent Player: Player remains visible across page changes
State Preservation: Playlist and playback mode are maintained
Seamless Experience: No interruption when moving between pages

Player Features from Library

When playing from the music library, you get access to all player features:

Essential Controls

Playback Control (/): Play and pause
Track Navigation (/): Previous and next tracks
Progress Seeking: Click or drag the progress bar
Volume Control: Adjust playback volume

Advanced Features

Download (): Save tracks to your device
Playlist Panel (): View and manage the queue
Playback Modes: Loop, repeat, and shuffle options
Expanded Info (): View lyrics and prompts

Benefits of Integration

Unified Experience: Consistent interface across the app
Context Awareness: Player knows where music originated
Flexible Navigation: Listen while performing other tasks
Smart Features: Locate, download, and manage from anywhere

View Modes

The music library offers two distinct viewing options to suit your preference and use case.

Grid View

Grid view displays your music as a collection of cards with visual emphasis on album artwork.

Activation

Click the grid icon () in the view mode toggle
Default view for most users

Layout Features

Card Design: Each track is a rectangular card
Album Art Focus: Large, prominent artwork display
Hover Effects: Play button appears on hover
Responsive Grid: Adjusts to screen size
- Desktop: 4-6 cards per row
- Tablet: 2-3 cards per row
- Mobile: 1-2 cards per row

Information Display

Each card shows:

Cover Image: Album artwork or default icon
Song Title: Displayed below the image
Artist Name: Secondary text
Play Button: Overlay on hover ()
Duration: Track length in corner

Best For

Visual browsing
Quick identification by artwork
Discovering older tracks
Aesthetic presentation

List View

List view presents your music in a compact, information-dense table format.

Activation

Click the list icon () in the view mode toggle
Preferred for large collections

Layout Features

Table Format: Organized rows and columns
Compact Display: More tracks visible per page
Sortable Columns: Click headers to sort (if enabled)
Detailed Information: Multiple data points at a glance

Information Display

Each row shows:

Track Number: Sequential or play button
Thumbnail: Small album artwork
Song Name: Main column with title
Artist: Creator information
Duration: Track length
Date Added: Creation timestamp
Actions: Play, download, and more

Best For

Managing large collections
Finding specific tracks quickly
Sorting and filtering
Detailed track information
Efficient browsing

Switching Between Views

You can switch views at any time:

Locate Toggle: Find the view mode buttons at the top
Click Icon: Choose grid () or list ()
Instant Switch: View changes immediately
Preserved State: Your playback and selection are maintained

View Preferences

Persistent Choice: Your view preference is saved
Page Memory: Returns to your preferred view on next visit
Device Specific: Can differ between mobile and desktop

Pagination and Navigation

For large music collections, the library uses pagination to organize and display tracks efficiently.

Pagination Controls

Located at the bottom of the library:

Previous Button (): Go to previous page
Page Numbers: Click to jump to specific page
Current Page: Highlighted in green
Next Button (): Go to next page
Page Info: Shows "Page X of Y"

Tracks Per Page

The number of tracks displayed per page varies by view mode:

Grid View: 12-24 tracks per page (depending on screen size)
List View: 20-50 tracks per page (more compact)

First Page: Click page number "1"
Last Page: Click the highest page number
Next/Previous: Use arrow buttons for sequential browsing
Direct Jump: Click any page number to jump directly

Efficient Browsing

Remember Page: Note the page number of favorite tracks
URL Parameters: Page number is in the URL (can be bookmarked)
Locate Feature: Use the player's locate button () to find tracks
Search (if available): Use search to find tracks across all pages

Page Loading

Performance

Fast Loading: Pagination ensures quick page loads
Lazy Loading: Images load progressively
Smooth Transitions: Animated page changes
No Interruption: Music playback continues during navigation

Visual Feedback

Loading States: Spinner or skeleton while loading
Disabled Buttons: Previous/Next buttons disabled at boundaries
Active Page: Current page highlighted in the pagination bar

Large Collections

For libraries with hundreds of tracks:

Ellipsis Notation: Shows "1 ... 5 6 7 ... 20" for many pages
Jump to Page: Click visible page numbers
Smart Grouping: Shows pages near current position
Scroll to Top: Automatically scrolls to top when changing pages

Pagination and Playback

Play All Behavior

Current Page Only: "Play All" may play only the current page (implementation dependent)
All Tracks: Or loads all tracks across all pages
Check Implementation: Test to verify behavior

Locate Feature

When using the locate button from the global player:

Finds Page: Identifies which page contains the track
Auto-Navigate: Jumps to that page automatically
Highlights Track: Shows the currently playing track
Smooth Experience: No manual page searching required

FAQs

General Questions

How do I add music to my library?

Your library automatically includes all music you generate using the AI music creation tools. Each completed generation appears in your library within seconds.

Can I organize my music into playlists?

Currently, the library displays all your tracks together. You can use the "Play All" feature to create a temporary playlist, or play individual tracks. Custom playlist features may be added in future updates.

How many songs can my library hold?

There's no hard limit on library size. However, performance is optimized for libraries with up to 10,000 tracks. Larger collections may experience slower loading times.

Is my music library private?

Yes, your music library is completely private. Only you can access your generated music. Admin users have separate library views and cannot access user-generated content.

Sharing capabilities depend on your subscription:

Free users: Cannot download tracks, so sharing is only possible through online streaming links (if available)
Pro members: Can download MP3 files and share them according to commercial use terms
Ultimate members: Can download both MP3 and WAV files with unlimited downloads for sharing

Playback Questions

Why doesn't the "Play All" button appear?

The "Play All" button only appears when you have at least one track in your library. If you don't see it, try generating your first music track or refreshing the page.

Can I shuffle my entire library?

Yes! First click "Play All" to load all tracks into the global player, then click the shuffle icon () in the player controls to enable random playback.

What happens if I close the player while music is playing?

The music stops immediately. The player is designed to be minimized, not closed during playback. Use the expand/collapse button (/) to minimize the player interface without stopping playback.

How do I repeat a single track?

Play the track, then click the playback mode button in the global player until you see the Repeat One icon (). The current track will loop continuously.

Does music continue playing when I navigate to other pages?

Yes! The global player maintains playback across all pages in the application. You can browse documentation, settings, or other sections while your music continues playing.

Library Management

How do I delete tracks from my library?

Track deletion features depend on your account settings. Check for a delete or remove option in the track details or contact support for assistance with library management.

Can I change the order of tracks in my library?

The default order is based on creation date (newest first). Sorting options may be available in list view by clicking column headers. Custom ordering features may be added in future updates.

What's the difference between grid and list view?

Grid view emphasizes visual presentation with large album artwork, ideal for browsing. List view is more compact and information-dense, showing more tracks and details at once, ideal for managing large collections.

How do I find a specific track quickly?

Use the pagination controls to browse pages, or use the locate feature () in the global player if the track is currently playing. Search functionality may be available depending on your version.

Why don't all my tracks show artwork?

Tracks may have default music icons if custom artwork wasn't generated. This is normal for some AI music generation processes. The music quality is unaffected by missing artwork.

Technical Questions

What audio formats are supported?

The library plays music in MP3 format by default. Ultimate members may have access to higher-quality WAV format downloads.

Can I download all my music at once?

Bulk download features are not currently available. Downloads are done individually:

Free users: Cannot download any tracks
Pro members: Can download tracks one by one using the download button () in the player (2 credits per MP3 download)
Ultimate members: Can download unlimited tracks individually in both MP3 and WAV formats

Contact support if you need bulk export options for large collections.

Why is my library loading slowly?

Large libraries (500+ tracks) may take longer to load. Try switching to list view for better performance, or check your internet connection. The app uses pagination to optimize loading times.

Does the player work on mobile devices?

Yes! The music library and global player are fully responsive and work on all devices. The interface adapts to smaller screens with a mobile-optimized layout.

What browsers are supported?

The music library works on all modern browsers including Chrome, Firefox, Safari, and Edge. For best performance, use the latest browser version.

Subscription & Credits

Do I need a subscription to access my library?

No, all users including Free tier can access and stream their music library. However, Free users cannot download tracks - downloads are only available for Pro and Ultimate members.

How many credits does playing music cost?

Playing music from your library is completely free and doesn't consume any credits. Credits are only used for:

Generating new music: 5 credits per generation (produces 2 songs)
Generating lyrics: 2 credits per generation
Generating prompts: 1 credit per generation
Downloading tracks (Pro users only): 2 credits per download

Can I play music without an internet connection?

The music library requires an internet connection to stream audio. Offline playback through downloads is only available for Pro and Ultimate members:

Pro members: Can download MP3 format (2 credits per download)
Ultimate members: Can download both MP3 and WAV formats (unlimited)

Additional Resources

Global Music Player: Detailed guide to player features
AI Music Generator: Learn how to create music with AI
Download Guide: Instructions for saving tracks to your device
Subscription Tiers: Compare features across different plans

Support

Help Center: Browse common issues and solutions
Contact Support: Reach out for personalized assistance
Community Forum: Connect with other users and share tips
Feature Requests: Suggest improvements to the music library

Updates

The music library is continuously improved with new features and enhancements. Check the changelog or release notes for the latest updates and improvements.