Settings and Files

Documentation / Contents - Audio Panel

• Overview of the Audio Panel
  • What It Controls, and What It Does Not
  • Two Faces
  • If There Is No Sound Card
• Anatomy of the Window
  • The Device Area
  • A Strip, Top to Bottom
  • The Control Rows
  • The Message Line
  • Selecting a Strip
• Setting Levels
  • The Faders
  • Group Sliders
  • Mute
  • Monitor
  • Meter
  • Sample Rate
  • What Is Not Persisted
• Meters, Peaks, and Clipping
  • Turning Them On
  • The dB Ladder
  • How They Move
  • When There Is No Signal
• Devices and Backends
  • Backends
  • The Default Input and Output
  • Choosing What Is Shown
  • Pinning a Device
  • Input Source and Output Destination
• The Menus
  • File
  • Selected
  • View
  • Options
  • Default
  • Help
  • The Button 3 Menu
• Dialogs
  • Open and Save As
  • Device Preferences
  • About
• Keys and the Command Line
  • Keys
  • The Headless Command Line
  • Diagnostics
    • Finding the Right Mixer Stage
• Settings and Files
  • The Configuration File
  • What Is Deliberately Not Saved
  • Environment Variables
• The Canonical Face
  • What Is Different
  • What Works
  • What Is Inert
  • Honest About Its Own Evidence
• The Audio Panel and Desktop Sounds
  • The Difference
  • Which One Do I Want

Other cards

• Copyright Information

Settings and Files

The Configuration File

~/.cyanotype/cymix.conf

Set CYMIX_CONF to use a different path. The format is the house key and value form. The file may be absent; every key is optional.

input_device        pin the input strip to this device, by id or name
output_device       pin the output strip to this device
window_x            the window position, rewritten at quit
window_y
show_device_list    View > Show Device List; off by default
show_quick_help     Options > Show Quick Help; ON by default
professional_mode   Options > Professional Mode; off by default
decibel_scale       Options > Decibel Scale; off by default
show_scrollbar      Options > Show Scrollbar; off by default

Saving is a read, modify and write: your comments, your key order and any key the panel does not own all survive.

What Is Deliberately Not Saved

Gain, mute and sample rate. The hardware holds them, and persisting them would make the panel fight the mixer it is supposed to report. This is a design decision, not an omission.

Environment Variables

CYMIX_CONF          use this configuration file
CYMIX_AUDIOPROBE    path to the audio probe script
CYMIX_PEAK_DEVICE   open a different capture device for the meters
CYMIX_PEAK_DEBUG    trace the capture process to stderr
AUDIODEV            which audio device, on the audioio backends
CY_CTL_CAPTURE_STAGE  which mixer stage the input fader drives
CY_CTL_MONITOR_STAGE  which mixer stage the Monitor checkbox drives
CY_LOG              logging; CY_LOG=debug names every mixer control touched

The last two are what Keys and the Command Line produces.

Other Files

<share>/cymix/audioprobe.sh   the shared audio probe script

The probe is read by the canonical face for the values it displays. The advanced face does not need it; it talks to the control backend directly.

Next

• The Canonical Face
• The Audio Panel and Desktop Sounds