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

# Scheduling

> Automate audio playback with flexible one-time and recurring schedules

## Overview

Schedules allow you to automate when and where your audio content plays across your locations. Create one-time announcements for special events or recurring schedules for daily operations.

## Schedule Types

<CardGroup cols={2}>
  <Card title="One-Time Schedules" icon="calendar-day">
    Play audio at a specific date and time - perfect for special announcements, events, or promotions.
  </Card>

  <Card title="Recurring Schedules" icon="repeat">
    Automate regular playback with daily, weekly, monthly, or custom interval patterns.
  </Card>
</CardGroup>

## Creating a Schedule

<Steps>
  <Step title="Select Your Audio">
    Choose the audio file you want to schedule from your library or Quick Messages.
  </Step>

  <Step title="Choose Schedule Type">
    Decide between a one-time or recurring schedule based on your needs.
  </Step>

  <Step title="Set Timing">
    Configure when your audio should play with precise date, time, and timezone settings.
  </Step>

  <Step title="Target Locations">
    Use advanced filters to select which locations should receive the scheduled audio.
  </Step>

  <Step title="Review & Activate">
    Preview the next trigger dates and activate your schedule when ready.
  </Step>
</Steps>

## Recurring Schedule Patterns

### Daily Pattern

Play audio every day at specified times.

* Example: Morning announcements at 9:00 AM daily
* Example: Closing messages at 6:00 PM every day

### Weekly Pattern

Schedule playback on specific days of the week.

* Example: Weekly promotions every Friday at 12:00 PM
* Example: Weekend specials on Saturday and Sunday

### Monthly Pattern

Play audio on specific days of each month.

* Example: Monthly reminders on the 1st and 15th
* Example: End-of-month announcements on the 30th

### Custom Intervals

Create flexible schedules with custom time intervals.

* Repeat every X hours or minutes
* Run at exact times throughout the day
* Set start and end times for schedule activation

## Advanced Filtering

Target specific locations with precision using multiple filter criteria.

<AccordionGroup>
  <Accordion title="Geographic Filters">
    * **State/Region** - Filter by state or region
    * **City** - Narrow down to specific cities
    * **Combine Filters** - Use multiple geographic criteria together
  </Accordion>

  <Accordion title="Location Selection">
    * **Individual Selection** - Choose specific stores or locations
    * **Bulk Selection** - Select multiple locations at once
    * **Employee Targeting** - Target specific employees or stores
  </Accordion>

  <Accordion title="Filter Logic">
    * **AND Conditions** - All criteria must match
    * **OR Conditions** - Any criteria can match
    * **Multi-Criteria** - Combine multiple filters for precise targeting
  </Accordion>
</AccordionGroup>

## Managing Schedules

### Schedule Dashboard

View and manage all your schedules in one place:

* **Active Schedules** - Currently running schedules
* **Inactive Schedules** - Paused or draft schedules
* **Schedule Status** - Monitor execution status
* **Next Triggers** - See upcoming playback times

### Schedule Actions

<CardGroup cols={2}>
  <Card title="Edit" icon="pen-to-square">
    Modify schedule settings, timing, or target locations anytime.
  </Card>

  <Card title="Activate/Deactivate" icon="toggle-on">
    Toggle schedules on or off without deleting them.
  </Card>

  <Card title="Delete" icon="trash">
    Permanently remove schedules you no longer need.
  </Card>

  <Card title="Duplicate" icon="copy">
    Create similar schedules quickly by duplicating existing ones.
  </Card>
</CardGroup>

## Schedule Information

### Next Trigger Dates

See the next 10 scheduled playback times displayed in your configured timezone. This helps you verify your schedule is working as expected.

<Warning>
  If you see a "Never-Invoked" warning, your schedule configuration may prevent it from triggering. Review your settings.
</Warning>

### Draft Schedules

Save incomplete schedules for later completion without activating them immediately.

## Calendar View

Visualize your schedules in an intuitive calendar interface.

### Calendar Features

* **Multiple Views** - Switch between day, week, and month views
* **Color Coding** - Different colors for different event types
* **Event Details** - Click events to view full schedule information
* **Quick Navigation** - Jump to specific dates easily

### Benefits

<CardGroup cols={2}>
  <Card title="Visual Planning" icon="calendar-days">
    See all scheduled events at a glance in a calendar format.
  </Card>

  <Card title="Conflict Detection" icon="triangle-exclamation">
    Identify potential scheduling overlaps before they occur.
  </Card>

  <Card title="Timeline View" icon="timeline">
    Understand scheduling patterns chronologically.
  </Card>

  <Card title="Quick Overview" icon="eye">
    Get an instant understanding of your audio strategy.
  </Card>
</CardGroup>

## Export Schedules

Generate reports and export your schedule data for analysis.

* **Date Range Export** - Export schedules for specific time periods
* **CSV Format** - Download data in CSV format for spreadsheet analysis
* **Bulk Export** - Export all schedules or filtered selections
* **Report Generation** - Create comprehensive schedule reports

## Best Practices

<Tip>
  Use recurring schedules for regular operations and one-time schedules for special events to maintain an organized schedule library.
</Tip>

<CardGroup cols={2}>
  <Card title="Timezone Awareness" icon="earth-americas">
    Always set the correct timezone for accurate scheduling across different regions.
  </Card>

  <Card title="Test Before Launch" icon="flask">
    Create a test schedule with a single location before rolling out to all locations.
  </Card>

  <Card title="Preview Audio" icon="play">
    Listen to your audio before scheduling to ensure quality and accuracy.
  </Card>

  <Card title="Monitor Performance" icon="chart-line">
    Regularly check schedule execution in analytics to ensure successful playback.
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="View Calendar" icon="calendar" href="/learn/scheduling">
    Explore your schedules in the calendar view to visualize your audio strategy.
  </Card>

  <Card title="Analytics" icon="chart-bar" href="/learn/analytics">
    Track schedule performance and user engagement with detailed analytics.
  </Card>
</CardGroup>