Audio
Engine, master bus, and preview bus controls, with their defaults and the shared sample-rate rules.
Settings → Audio (“Engine output and buses.”) holds three cards. All three feed the audio engine, so a save on this page restarts it when it is running. For the procedure see Audio setup; for silence and dropouts, Troubleshooting sound.
Engine
Card subtitle: “Resampler and buffer size.”
| Control | Type | Values | Default | Effect |
|---|---|---|---|---|
| Resampler quality | select | Low, Medium, High | Medium | Quality preset for the resampler that converts tracks whose file rate differs from the engine rate. |
| Buffer size | slider | 64–2048 frames in steps of 64 | 512 frames | Frames per mixer chunk. Hint: “Must be a multiple of 64 frames (mixer graph chunk size).” |
Buffer size is the one audio control that stays global. It is the chunk the mixer graph renders, and the engine feeds every device stream from it. Mixar also requests it as the callback size, though the backend may substitute the period the device supports. Each device still calls back on its own period, which the per-device ring buffer absorbs, so the buffer is not a device setting.
Master bus
Card subtitle: “Primary output device and channel routing.”
| Control | Type | Values | Default | Effect |
|---|---|---|---|---|
| Device | select | System default first, then every detected output device | System default | Which device the master bus opens on. |
| Low latency | checkbox | on / off | off | Asks for the device’s smallest supported period when the driver reports a buffer-size range. |
| Sample rate | select | Device default, then every rate the device reports; the current value stays listed | Device default | Output rate for this device stream. See Sample rate and low latency. |
| Channel mode | select | Stereo pair / Mono (fold L+R) | Stereo pair | One channel on both sides, or a distinct left and right. |
| Left channel | stepper | 1 up to the device’s channel count | 1 | First channel of the route. 1-based. |
| Right channel | stepper | 1 up to the device’s channel count | 2 | Second channel. Disabled in Mono (fold L+R). |
Low latency is a hint. It applies when the driver reports a buffer-size range, floored at 16 frames unless the whole range is smaller. A driver that reports no range keeps the configured size, and a device with a single fixed period ignores the hint. A device shared with another bus uses it when either bus asks.
If Left channel and Right channel end up equal, Mixar moves the other one by a channel. On a device that reports a single channel it switches the route to Mono instead. Both steppers clamp to the selected device’s channel count. While the device list is still loading, the Sample rate select is disabled and shows “Loading rates for this device…”.
Preview bus
Card subtitle: “Headphones / cue output when preview is enabled.” With Enable preview bus off, the route fields are not shown at all.
| Control | Type | Values | Default | Effect |
|---|---|---|---|---|
| Enable preview bus | switch | on / off | off | Opens a second output for cueing. Without it, headphone cue is silent. |
| Device | select | System default first, then every detected output device | System default | Device for the headphone bus. |
| Low latency | checkbox | on / off | off | Same hint as the master bus, for this bus’s device. |
| Sample rate | select | Device default, then every rate the device reports; the current value stays listed | Device default | Output rate for the preview device stream. Differs from the master rate whenever the devices do; the engine resamples. |
| Channel mode | select | Stereo pair / Mono (fold L+R) | Stereo pair | Same rules as the master bus. |
| Left channel | stepper | 1 up to the device’s channel count | 3 | First channel of the preview route. |
| Right channel | stepper | 1 up to the device’s channel count | 4 | Second channel of the preview route. |
What reaches this bus is decided in the mixer. See Cueing.
Sample rate and low latency
Each bus carries its own Sample rate and Low latency, because the two buses can sit on different devices. Those devices can mix at different rates or need different paths. The engine graph runs at the master bus’s rate. A preview bus on a device with another rate is resampled in the producer, so it stays time-aligned instead of drifting.
Device default follows the rate the device itself mixes at, which the system already uses for that output. It is the default on fresh installs, so Mixar asks for the rate the device can actually open. Picking an explicit rate makes Mixar open the stream at exactly that rate. If the device refuses it, the engine does not start, and the toast names the rate and the rates the device offers.
Not every backend can report a device’s mix rate. When the selected device does not, the entry reads plain Device default, and Mixar will not start on it until you pick an explicit rate. The error names the device. The same applies to any device whose driver reports no usable rates at all.
Buses that share one device share one stream, so they must share one rate. An explicit rate wins over Device default on that device. Two different explicit rates for buses on the same device are rejected with one stream runs at one rate. Low latency never conflicts: it is a hint, so the shared stream uses it when either bus asks.
What a save rejects
The settings are validated before they are written. A save fails, with the messages in the error toast, when:
- A route’s Sample rate is zero.
- Buffer size is not a positive multiple of 64.
- A route has an empty device.
- A mono route uses channel 0, or a stereo route uses channel 0 or the same channel on both sides.
Channel values the UI clamps on the way in never reach that check. The values above only appear when a settings file is edited outside the app.