> ## Documentation Index
> Fetch the complete documentation index at: https://docs.musique.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Questions

> Find answers to common questions about Musique integration, devices, and usage.

## General Questions

<AccordionGroup>
  <Accordion title="What is Musique App?">
    Musique App is a comprehensive platform for managing customized background music, sound branding, and ads scheduling for businesses. It helps you create and manage tailored audio experiences across your physical locations using licensed and AI-generated music.
  </Accordion>

  <Accordion title="What features does Musique offer?">
    Musique provides:

    * **Background Music** - Licensed music library streaming
    * **AI Audio Generation** - Text-to-speech for custom messages
    * **Scheduling** - Automated audio playback schedules
    * **Ads Platform** - Schedule promotional content
    * **Analytics** - Track user activity and network performance
    * **Multi-Location Management** - Control audio across all your locations
  </Accordion>

  <Accordion title="What devices are supported?">
    Musique works on:

    * Raspberry Pi devices (recommended for in-store playback)
    * Desktop browsers (Chrome, Firefox, Safari, Edge)
    * Mobile devices (iOS and Android)
    * Tablets and touch-enabled displays
  </Accordion>
</AccordionGroup>

## Playback Issues

<AccordionGroup>
  <Accordion title="The music stopped playing. What should I do?">
    If music stops unexpectedly, try these steps:

    1. **Check Internet Connection**
       * Verify your device is connected to the internet
       * Run a speed test in the Network Quality section
       * Ensure download speed is adequate (at least 1-2 Mbps recommended)

    2. **Check Active Schedules**
       * Go to Schedules section
       * Verify you have active schedules
       * Check if schedules are set for the correct timezone
       * Ensure your location is included in schedule filters

    3. **Restart the Device**
       * Restart your Raspberry Pi or playback device
       * Wait 2-3 minutes for the system to reconnect
       * Check if playback resumes automatically

    4. **Check System Status**
       * View the Music Player to see if there's an active stream
       * Check Analytics > Health Status for system issues
       * Contact support if the issue persists
  </Accordion>

  <Accordion title="Music is playing but quality is poor or keeps buffering">
    Poor audio quality or buffering is usually caused by network issues:

    **Immediate Solutions:**

    * Use the Network Quality tool to test your connection
    * Close other applications using bandwidth
    * Switch from WiFi to wired Ethernet connection if possible

    **Long-term Solutions:**

    * Upgrade your internet plan if speed is consistently below 2 Mbps
    * Optimize your network by reducing concurrent users
    * Position your router closer to the playback device
    * Check Analytics > Network Quality to monitor performance trends

    **Target Metrics:**

    * Download speed: 2+ Mbps (Great), 1-2 Mbps (Moderate)
    * Ping: Below 100ms is ideal
  </Accordion>

  <Accordion title="Music plays on some locations but not others">
    This is typically a scheduling or filtering issue:

    1. **Review Schedule Filters**
       * Open the schedule that should be playing
       * Check the location filters (State, City, Employee/Store)
       * Verify affected locations are included

    2. **Check Location Status**
       * Go to Analytics to see which users are online
       * Verify devices are connected and active
       * Check if devices are experiencing network issues

    3. **Verify Permissions**
       * Ensure locations have proper company access
       * Check user permissions for affected locations
       * Contact your admin if permission issues are suspected
  </Accordion>

  <Accordion title="Can I preview what's currently playing?">
    Yes! Use the **Music Player** feature:

    * Navigate to the Music Player section
    * Select your company from the dropdown (if you have multiple)
    * See the current track with album artwork
    * View recently played tracks in the playlist history
    * The vinyl-style interface shows real-time playback
  </Accordion>
</AccordionGroup>

## Login & Access Issues

<AccordionGroup>
  <Accordion title="I can't log in. What should I do?">
    If you're having trouble logging in:

    1. **Check Your Credentials**
       * Verify you're using the correct username
       * Ensure your password is entered correctly (check Caps Lock)
       * Remember passwords are case-sensitive

    2. **Reset Your Password**
       * Click "Forgot Password" on the login page
       * Enter your username
       * Check your email for reset instructions
       * Follow the link to create a new password (minimum 8 characters)

    3. **Browser Issues**
       * Clear your browser cache and cookies
       * Try a different browser
       * Disable browser extensions that might interfere
       * Ensure JavaScript is enabled

    4. **Still Can't Access?**
       * Contact your company administrator
       * Verify your account is active and not suspended
       * Reach out to Musique support for assistance
  </Accordion>

  <Accordion title="I forgot my username. How do I recover it?">
    If you've forgotten your username:

    * Contact your company administrator who can look up your username
    * Check any previous email communications from Musique
    * Reach out to Musique support with your registered email address
  </Accordion>

  <Accordion title="Why can't I access certain features?">
    Feature access is controlled by user permissions:

    **User Roles:**

    * **Admin** - Full access to all features
    * **Manager** - Access to panel, reports, and schedule management
    * **Regular User** - Basic player access and limited reporting

    **Specific Permissions:**

    * **Panel Access** - View analytics and reports
    * **Speech/Quick Messages** - Create AI audio and upload files
    * **User Creation** - Ability to register new users
    * **Report Viewing** - Access to various reports

    If you need additional permissions, contact your company administrator.
  </Accordion>

  <Accordion title="My session keeps logging out automatically">
    Automatic logout can happen due to:

    * **Extended Inactivity** - Sessions timeout after prolonged inactivity for security
    * **Multiple Tabs** - Using multiple tabs might cause session conflicts
    * **Browser Settings** - Check if your browser is clearing cookies

    **Solutions:**

    * Keep the tab active if you need continuous access
    * Check your browser's privacy settings
    * Ensure cookies are enabled for Musique
    * Try using a single tab or window
  </Accordion>
</AccordionGroup>

## Scheduling Issues

<AccordionGroup>
  <Accordion title="My schedule isn't triggering. Why?">
    If your schedule isn't activating:

    1. **Check Schedule Status**
       * Ensure the schedule is **Active** (not inactive or draft)
       * Look for "Never-Invoked" warnings

    2. **Verify Next Trigger Dates**
       * Click on the schedule to see next 10 trigger dates
       * If no dates appear, your configuration might prevent triggering
       * Check that current time is within schedule's time range

    3. **Review Timezone Settings**
       * Verify the correct timezone is set
       * Ensure trigger times are converted correctly

    4. **Check Filters**
       * Confirm target locations are correctly selected
       * Verify filter logic (AND/OR conditions)
       * Make sure filters aren't too restrictive

    5. **Validate Schedule Pattern**
       * For recurring schedules, check the pattern is set correctly
       * For one-time schedules, ensure the date/time hasn't passed
  </Accordion>

  <Accordion title="How do I know if my schedule is working?">
    You can verify schedule execution in several ways:

    1. **Next Trigger Dates** - View upcoming playback times in schedule details
    2. **Calendar View** - See all scheduled events visually
    3. **Music Player** - Check if scheduled audio is playing at trigger time
    4. **Analytics Reports** - Review ads performance and execution logs
    5. **Export Schedules** - Generate reports for specific date ranges
  </Accordion>

  <Accordion title="Can I schedule different audio for different locations?">
    Yes! Use **Advanced Filtering** when creating schedules:

    * Filter by State/Region
    * Filter by City
    * Select specific stores or employees
    * Use multiple filter criteria with AND/OR logic
    * Create separate schedules for different location groups
  </Accordion>

  <Accordion title="What's the difference between one-time and recurring schedules?">
    **One-Time Schedules:**

    * Play audio once at a specific date and time
    * Perfect for special announcements or events
    * Automatically complete after execution

    **Recurring Schedules:**

    * Repeat automatically based on pattern (daily, weekly, monthly, custom)
    * Ideal for regular operations (opening/closing messages, daily promotions)
    * Continue until manually deactivated
    * More efficient than creating multiple one-time schedules
  </Accordion>
</AccordionGroup>

## Quick Messages & Audio

<AccordionGroup>
  <Accordion title="How does AI audio generation work?">
    AI audio generation converts your text into natural-sounding speech:

    **Process:**

    1. Select an AI voice vendor
    2. Choose a voice style that matches your brand
    3. Enter your text (track character count for monthly limits)
    4. Optionally add background music
    5. Preview the audio before saving
    6. Save to your library for scheduling

    **Tips:**

    * Keep messages clear and concise
    * Preview before using in schedules
    * Test different voices to find your brand's voice
    * Monitor your monthly character usage
  </Accordion>

  <Accordion title="What audio file formats are supported for upload?">
    Musique supports common audio formats for uploads:

    * MP3 (recommended)
    * WAV
    * M4A
    * OGG

    **Upload Features:**

    * Drag-and-drop multiple files
    * Automatic format validation
    * Real-time progress tracking
    * Instant availability after upload
  </Accordion>

  <Accordion title="How do I manage my audio library?">
    The Quick Messages section provides comprehensive audio management:

    **Organization:**

    * Search and filter audio files
    * Sort by name, date, or duration
    * View metadata (creation date, source)

    **Actions:**

    * Play/preview any audio file
    * Rename files for better organization
    * Download files for backup
    * Delete unwanted files

    **Best Practice:** Use descriptive file names to easily find audio later when creating schedules.
  </Accordion>

  <Accordion title="Is there a limit on audio generation or uploads?">
    Limits depend on your Musique plan:

    * **AI Generation** - Character count limits apply (monitored monthly)
    * **File Uploads** - Storage limits based on your plan
    * **File Size** - Individual file size limits may apply

    Check your account settings or contact support for specific limits on your plan.
  </Accordion>
</AccordionGroup>

## Analytics & Reports

<AccordionGroup>
  <Accordion title="How do I track which locations are active?">
    Use the **Analytics Dashboard**:

    1. **Real-Time Status** - See current online/offline count
    2. **Active Users by Hour** - Identify when locations are active
    3. **Inactive Users** - Find locations not active for 3+ days
    4. **Network Map** - Geographic view of all locations
    5. **Per-User Tracking** - Individual location activity metrics

    Export data to Excel/CSV for deeper analysis or record-keeping.
  </Accordion>

  <Accordion title="What does network quality mean?">
    Network quality indicates connection performance:

    **Quality Levels:**

    * **Great** - Excellent connection (fast download, low ping)
    * **Moderate** - Acceptable with minor issues
    * **Poor** - Connection problems requiring attention
    * **Unknown** - No recent test data

    **Metrics:**

    * **Download Speed** - Measured in Mbps
    * **Ping/Latency** - Round-trip time in milliseconds

    Use the Speed Test tool to check your connection quality and the Network Map to see quality distribution across locations.
  </Accordion>

  <Accordion title="How do I export analytics data?">
    Export data for reporting and analysis:

    **Export Options:**

    1. **Excel (XLSX)** - Full featured spreadsheet format
    2. **CSV** - Compatible with most analytics tools

    **What You Can Export:**

    * User activity metrics
    * Network quality reports
    * Schedule execution data
    * Custom date range reports
    * Filtered data selections
    * Complete user lists

    Look for export buttons in the Analytics section or use the date range selector to export specific periods.
  </Accordion>

  <Accordion title="Why are some users showing as inactive?">
    Users appear as inactive when they haven't logged in for 3+ days:

    **Common Reasons:**

    * Location temporarily closed
    * Device or network issues
    * Employee no longer with company
    * Device needs attention or restart

    **Actions:**

    * Review inactive user list in Analytics
    * Check if it's an expected pattern (weekends, holidays)
    * Contact locations with persistent inactivity
    * Use data to identify support needs
  </Accordion>
</AccordionGroup>

## Network & Technical

<AccordionGroup>
  <Accordion title="How do I test my internet connection speed?">
    Use the built-in **Speed Test** tool:

    **To Run a Test:**

    1. Navigate to Network Quality section
    2. Click "Run Speed Test"
    3. Wait for the 25-request test to complete
    4. View results: Download speed and Ping
    5. See your quality rating (Poor/Moderate/Great)

    **When to Test:**

    * Before setting up a new location
    * When experiencing playback issues
    * Regularly to monitor network health
    * After making network changes

    Test history is saved for comparison over time.
  </Accordion>

  <Accordion title="What internet speed do I need for Musique?">
    Recommended minimum specifications:

    **Minimum:**

    * Download: 1-2 Mbps per device
    * Ping: Below 150ms

    **Recommended:**

    * Download: 2+ Mbps per device
    * Ping: Below 100ms
    * Stable connection (wired preferred over WiFi)

    For locations with multiple devices or high traffic, consider higher speeds. Run the Speed Test to verify your connection meets requirements.
  </Accordion>

  <Accordion title="Can I use Musique on mobile devices?">
    Yes! Musique is fully responsive and works on:

    * iOS devices (iPhone, iPad)
    * Android phones and tablets
    * Desktop browsers
    * Touch-enabled displays

    **Mobile Features:**

    * Full access to Music Player
    * View analytics and reports
    * Manage schedules (for users with permissions)
    * Create quick messages
    * Monitor network quality

    For best experience, use the latest version of Chrome, Safari, or Firefox mobile browsers.
  </Accordion>

  <Accordion title="What should I do if the system is offline?">
    If you see offline status:

    1. **Check Your Connection**
       * Verify internet connectivity
       * Run speed test to check connection
       * Try accessing other websites

    2. **Check Device Status**
       * Ensure playback device is powered on
       * Verify device has network access
       * Restart device if necessary

    3. **Check System Status**
       * View Analytics > Health Status
       * Look for system-wide issues
       * Check if issue is local or widespread

    4. **Contact Support**
       * If issue persists after troubleshooting
       * Provide details about when issue started
       * Include error messages if any
  </Accordion>
</AccordionGroup>

## Multi-Language & Settings

<AccordionGroup>
  <Accordion title="What languages does Musique support?">
    Musique is available in three languages:

    * **English** - Full support
    * **Portuguese** - Complete translation
    * **Spanish** - Full Spanish support

    Change language anytime in Settings > Appearance. Your preference is saved across sessions.
  </Accordion>

  <Accordion title="Can I switch between light and dark mode?">
    Yes! Navigate to Settings > Appearance to choose:

    * **Light Mode** - Bright interface for daytime use
    * **Dark Mode** - Reduced eye strain for low-light environments

    Switch instantly without reloading the page. Your theme preference is saved automatically.
  </Accordion>

  <Accordion title="What is user impersonation and who can use it?">
    **User Impersonation** is an admin-only feature that allows administrators to:

    * View the app as another user
    * Test user experience and permissions
    * Troubleshoot user-specific issues
    * Verify access controls

    When impersonating, a clear banner indicates you're viewing as another user. You can easily return to your own account anytime.
  </Accordion>
</AccordionGroup>

## Still Need Help?

<Card title="Contact Support" icon="headset" href="mailto:support@musique.app">
  Can't find the answer you're looking for? Our support team is here to help!

  **Before contacting support, please have ready:**

  * Your account username
  * Description of the issue
  * Steps you've already tried
  * Screenshots if applicable
  * Error messages (if any)
</Card>

## Additional Resources

<CardGroup cols={2}>
  <Card title="Quick Messages Guide" icon="microphone" href="/learn/quick-messages">
    Learn how to create AI audio and manage your audio library.
  </Card>

  <Card title="Scheduling Guide" icon="calendar" href="/learn/scheduling">
    Master schedule creation and automation for your locations.
  </Card>

  <Card title="Music Player" icon="music" href="/learn/music-player">
    Understand how to use the live streaming player.
  </Card>

  <Card title="Analytics" icon="chart-line" href="/learn/analytics">
    Get insights from your data with comprehensive analytics.
  </Card>
</CardGroup>