xtra.audio

Week Planner ​

The Week Planner is a visual scheduling interface where you assign sequences to time blocks across a 7-day week. The schedule defines the default weekly template for generating hourly rotations.

Interface Layout ​

The planner has two areas:

  • Sidebar (left): Searchable list of available sequences with usage badges showing how often each sequence is used in the current schedule
  • Grid (right): 7-day calendar with hour rows (Monday through Sunday, 00:00 to 24:00)

Colored blocks on the grid represent assigned sequences. Colors are generated automatically based on the sequence name.

Creating Time Blocks ​

Arm and Place ​

  1. Click a sequence in the sidebar to arm it (pre-select it)
  2. Click and drag on an empty area in the grid to create a block
  3. The block is created with the armed sequence

The armed sequence is indicated by a highlight in the sidebar. Press Escape to deselect.

Drag from Sidebar ​

Drag a sequence directly from the sidebar onto a day column. The system automatically fills the available gap at the drop position.

Minimum and Maximum Duration ​

  • Minimum: 1 hour
  • Maximum: 24 hours (full day)

Time blocks snap to hour boundaries.

Editing Time Blocks ​

Resizing ​

Hover over the top or bottom edge of a block. Drag to adjust the duration.

Deleting ​

Right-click a block to delete it immediately.

Cloning to Other Days ​

Hold Ctrl (or Cmd on Mac) and click a block to clone it to all other days of the week. Blocks are only cloned where no overlap would occur.

Moving Between Days ​

Drag a block from one day to another. The system supports both replacing an existing sequence and moving into an empty gap.

Day Operations ​

Each day column header provides buttons for:

  • Clone Day: Copy all blocks from this day to all other days
  • Clear Day: Remove all blocks from this day

Block Merging ​

Adjacent time blocks with the same sequence are merged automatically into a single block.

Overlapping Blocks ​

The planner prevents overlapping time blocks on the same day. Creating or resizing a block that would overlap is blocked.

Planner Settings ​

Click the gear icon to open planner settings:

SettingDescription
Default SequenceFallback sequence for unscheduled hours
Plan Hours in AdvanceHow many hours ahead rotations are generated

Auto-Planning ​

Auto-planning generates rotation playlists automatically based on the configured lookahead window. When enabled, rotations are generated continuously without manual intervention.

Configuration ​

  1. Open the planner settings (gear icon in the planner toolbar).
  2. Enable the Auto-Planning toggle.
  3. Set the Hours in Advance value (1–168 hours, default: 6).

The station generates rotations for the specified number of hours ahead of the current time. As time progresses, new rotations are generated automatically to maintain coverage.

When to Use Auto-Planning ​

Auto-planning works best for stations with a consistent schedule. The planner uses the default week template and any week-specific overrides to determine which sequence runs at each hour.

Disable auto-planning when making significant changes to sequences or the week template. Re-enable it after the changes are finalized to generate rotations with the updated configuration.

Bulk Generation ​

Bulk generation creates rotations for a specific date and time range in a single operation. This is useful for pre-generating schedules or regenerating rotations after changes.

Generating Rotations ​

  1. Click Generate in the planner toolbar.
  2. Set the From date and hour.
  3. Set the To date and hour.
  4. Optionally enable Force Regenerate to overwrite existing rotations.
  5. Click Generate.

Quick selection buttons are available for common ranges:

ButtonRange
Current HourCurrent hour only
TodayRemaining hours today
TomorrowFull day tomorrow
Next MondayStart of next week

The maximum range is 720 hours (30 days). Generation runs as a background job — progress can be monitored in the interface.

Force Regenerate ​

By default, bulk generation skips hours that already have a rotation. Enable Force Regenerate to overwrite existing rotations with freshly generated ones. This is useful after modifying sequences or planner actions.

Gap Detection ​

The planner warns when hours in the week template have no sequence assigned and no default sequence is configured. These gaps would result in silence during playback.

A warning badge appears on the planner header when gaps are detected. Click the badge to open the settings and configure a default sequence as a fallback.

Default Sequence ​

The default sequence plays during any hour that has no explicitly assigned sequence. Configure it in the planner settings:

  1. Open the planner settings (gear icon).
  2. Select a sequence under Default Sequence.
  3. Save the settings.

This eliminates gaps without requiring every hour to be manually scheduled.

Saving Changes ​

Click Save to persist changes to the schedule. The planner warns when navigating away with unsaved changes.

When Changes Take Effect ​

Changes to the Week Planner affect future rotations:

  • Regenerate existing rotations to apply changes immediately
  • New rotations generate with the updated schedule automatically

Rotations that have already started playing are not affected.