Skip to main content

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.

​
General Questions

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.
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
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

​
Playback Issues

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
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
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
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

​
Login & Access Issues

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
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
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.
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

​
Scheduling Issues

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
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
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
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

​
Quick Messages & Audio

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
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
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.
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.

​
Analytics & Reports

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.
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.
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.
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

​
Network & Technical

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.
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.
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.
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

​
Multi-Language & Settings

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.
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.
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.

​
Still Need Help?

Contact Support

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)

​
Additional Resources

Quick Messages Guide

Learn how to create AI audio and manage your audio library.

Scheduling Guide

Master schedule creation and automation for your locations.

Music Player

Understand how to use the live streaming player.

Analytics

Get insights from your data with comprehensive analytics.