Reference

Configuration file

GNUsound stores its configuration information in a text file in the location ~/.gnome/gnusound (for GNOME 1 installations) or ~/.gnome2/gnusound (for GNOME 2 installations). Although some of the most important properties that are stored in this file can be edited from within GNUsound itself, this file also contains other options that might be of interest. For example, it contains the colors that GNUsound uses to draw various parts of the interface. You can change these here if your aesthetic sensibilities differ from those of the author.

It should be understood that editing the configuration file in this fashion may yield unexpected results. Also there is always a chance that the format of the file will change in the future, as well as the meaning of the properties and their values.

alsa.input_channels

The number of input channels to allocate on the capture device.

alsa.output_channels

The number of output channels to allocate on the playback device.

alsa.overrun_recovery

Whether to stop playback/recording on overruns.

alsa.playback_device

The playback device.

alsa.record_device

The capture device.

alsa.underrun_recovery

Whether to stop playback/recording on underruns.

audio_chunk_duration

This value determines the maximum audio buffer size for recording and playback, in seconds.

audio_driver

Which audio driver to use.

default_bpm

The default beats per minute when none has been specified.

default_sample_rate

The default sample rate when creating a new document

default_sample_type

The default sample type when creating a new document.

file.drivers.probe_order

Comma-separated list describing the probing order for file format drivers.

follow_playback

Whether the view should track the playback position.

ladspa.path

Path to GLADSPA plugins.

ladspa.segment_time

Specifies the granularity with which envelopes are applied to GLADSPA plugin processing, in seconds.

lame.bitrate

The bitrate to use.

lame.encoder

Undocumented.

lame.mono

Whether to use mono encoding.

lame.quality

The quality level to achieve when the encoder should target quality.

lame.target

Whether the encoder should target a certain quality (giving a variable bitrate), or whether to encoder should target a certain bitrate.

lame.use_cbr

Whether to keep the bitrate constant.

lame.vbr_mode

Whether to use the old style VBR encoder or the new one.

max_tracks

The maximum number of tracks that can be edited.

max_undo_depth

The maximum number of Undo's.

oss.fragments

Undocumented

oss.input_channels

The number of input channels to allocate on the capture device.

oss.output_channels

The number of output channels to allocate on the playback device.

oss.playback_device

The playback device.

oss.playback_signed_int8_to_unsigned_int8

Whether to convert signed 8 bit samples to unsigned 8 bit samples on playback. For soundcards where AFMT_S8 doesn't work.

oss.record_device

The capture device.

playback_display_interval

How often to update the display during playback (in milliseconds).

record_replace

Whether record should overwrite data underneath the recording cursor or insert the recorded data before the recording cursor.

restore_scrollbar_positions

Whether to restore the last saved scrollbar positions when opening a document.

restore_window_positions

Whether to restore the last saved window positions when opening a document.

scrub_fast_multiplier

By what amount to multiply scrub movement when Fast scrubbing.

scrub_playback_amount

By how many samples the scrub command moves the playback cursor left or right during playback.

scrub_silent_amount

By how many samples the scrub command moves the viewport left or right when not playing back.

show_envelope

Whether to show envelopes.

show_grid

Whether to show the grid.

show_zero

Whether to show the amplitude 0 line.

snap_to_cuepoints

Determines whether to automatically snap the selection at cuepoint positions.

snap_to_grid

Determines whether to automatically snap the selection at grid positions.

view.wave.draw.connect_samples

Whether to draw samples as if they were contiguous or not.

view.wave.draw.rms.enable

Whether to draw the waveform RMS. Disabling gives faster display.

view.wave.draw.rms.minimum_zoom

From what zoom factor the waveform RMS should be drawn.

.USX document settings file

GNUsound stores all it's document settings, such as envelopes in cuepoints, in a file separate from the audio data. This file is fairly self-explanatory and it doesn't hurt to edit it by hand.