Theme changes, fix for unicode conversion errors, misc

[rox-musicbox.git] / Options.xml

<?xml version="1.0"?>
<options>
        <section title="Settings">
                <frame label='Library'>
                        <entry name='library' label='Path'>
                        The (optional) default location of your music.  This location will be scanned and loaded at startup when no command-line arguments are given.  It is a ':' separated list of directories, and/or .xml, .pls, .m3u, .mp3, .ogg files.
                        </entry>
                        <entry name='library_re' label='Pattern'>
                        A python regular expression to parse the full path of each file into 'artist', 'album', 'title' and 'track'.  Used when there is no tag info in the file.
                        </entry>
                </frame>

                <frame label='Playback' columns='2'>
                <hbox>
                        <toggle name='repeat' label='Repeat'>Keep playing forever.</toggle><spacer/>
                        <toggle name='shuffle' label='Shuffle'>Randomize play order.</toggle><spacer/>
                        <numentry name='shuffle_cache' label='Shuffle cache size' min='0' max='100'>
                        How many songs to remember in shuffle mode so we don't replay too often.
                        </numentry>
                </hbox>
                </frame>
                <frame label='Time'>
                        <hbox>
                                <radio-group name='time_display' columns='2'>
                                <radio label='elapse' value='0'>Show elapsed time</radio>
                                <radio label='remain' value='1'>Show remaining time</radio>
                                </radio-group>
                        </hbox>
                </frame>
        </section>
        <section title="Drivers">
                <frame label='Output'>
                        <hbox>
                        <label>Driver</label>
                        <radio-group name='driver_type' columns='2'>
                                <radio label='ao' value='ao'>Libao Audio Library</radio>
                                <radio label='alsa' value='alsa'>PyAlsaAudio Alsa driver</radio>
                                <radio label='oss' value='oss'>Python's built-in Open Sound System driver</radio>
                                <radio label='linux' value='linux'>Python's built-in (obsolete?) linuxaudiodevice driver</radio>
                        </radio-group>
                        </hbox>
                        <hbox>
                        <label>ao sub-driver</label>
                        <radio-group name='driver_id' columns='2'>
                                <radio label='esd' value='esd'>Gnome esound server</radio>
                                <radio label='oss' value='oss'>Open Sound System driver</radio>
                                <radio label='alsa' value='alsa09'>current Alsa driver</radio>
                                <radio label='alsa (old)' value='alsa'>older (obsolete?) Alsa driver</radio>
                        </radio-group>
                        </hbox>
                        <entry name='sound_device' label='Device Name'>
                        The device entry for sound output.  Typically '/dev/dsp' for oss and 'default' for alsa.
                        </entry>
                        <numentry name='audio_buffer' label='Buffer Size' min='512' max='65535' step='128'>
                        The size of the buffer used to read/write sound data.  A larger buffer may reduce skipping under heavy load.
                        </numentry>
                </frame>
                <frame label='Volume Control'>
                        <entry name='mixer_device' label='Mixer Device'>
                        The /dev entry for your mixer.  Typically '/dev/mixer' for oss and 'default' for alsa.
                        </entry>
                        <entry name='mixer_channel' label='Mixer Channel'>
                        The name of the mixer channel to control.  Typically 'PCM' for oss and alsa.
                        </entry>
                </frame>
        </section>
        <section title="Display">
                <frame label='Fonts'>
                        <font name='base_font' label='Base font:'>The font used for Other text</font>
                        <font name='song_font' label='Title font:'>The font used for the Song Title</font>
                </frame>
                <frame label='Colors'>
                        <colour name='fg_color' label='Text Color:'>Text color.</colour>
                        <colour name='bg_color' label='Background Color:'>The background color of the main display area.</colour>
                </frame>
                <frame label='Widgets'>
                        <hbox>
                                <label>Show/Hide:</label>
                                <toggle name='toolbar' label='Toolbar'>Show/Hide the Toolbar</toggle>
                                <toggle name='volume' label='Volume'>Show/Hide the Volume control</toggle>
                                <toggle name='seekbar' label='Seek'>Show/Hide the Seek control</toggle>
                                <toggle name='album_art' label='Album Art'>Show/Hide Album Cover display</toggle>
                        </hbox>
                        <toggle name='word_wrap' label='Word Wrap'>Word wrap display strings</toggle>
                        <toggle name='mini_toolbar' label='Mini Toolbar'>Use miniature size toolbar buttons</toggle>
                <label>Select the buttons you want on the toolbar:</label>
                <tool_options name='toolbar_disable'/>
                </frame>
        </section>

</options>