NAME

       sindplayfp.ini - Configuration file for sidplayfp(1).

DESCRIPTION

       This  page describes the options available for the configuration file of Sidplayfp.  It is
       composed by a number of sections, each one composed by a section name, enclosed by  square
       brackets, folowed by a list of <parameter>=<value> lines.

       sidplayfp.ini supports the following sections:

       [SIDPlayfp] - Generic configuration

       [Console] - Console appearance configuration

       [Audio] - Audio output configuration

       [Emulation] - Emulation engine parameters

       All  options  and  values  (except for file names and paths) are case insensitive, and are
       described in detail below.

       For any of the following parameter, if it's specified more than one time  the  last  entry
       encountered will be used.

       NOTE: if any of these options is specified outside its section, it will be ignored.

SIDPlay2

       Version=<number>
              Configuration version

       Songlength Database=<path>
              Full path for the Songlength DB. Should point to the DOCUMENTS/Songlengths.txt file
              under the HVSC collection path.

              On   *NIX   systems   if   this   value   is   not   set,   sidplayfp   will    try
              $PREFIX/share/sidplayfp/Songlengths.txt .

       Default Play Length=mm:ss
              Default play time if Songlength Database is not found.

       Default Record Length=mm:ss
              Default recording time when writing wave files if Songlength Database is not found.

       Kernal Rom=<path>
              Full path for the Kernal Rom file. This is the most important rom and should always
              be provided, although many tunes will still work without.  By default  the  program
              will look for a kernal file under the following locations:

       •      $XDG_DATA_HOME/sidplayfp/ on *NIX systems where XDG_DATA_HOME is defined.

       •      $HOME/.local/share/sidplayfp/ on *NIX systems where XDG_DATA_HOME is not defined.

       •      $PREFIX/share/sidplayfp on *NIX systems when not found in the above directories.

       •      %CSIDL_APPDATA%\sidplayfp\ on Windows systems where CSIDL_APPDATA is defined.

       •      %USERPROFILE%\Application Data\sidplayfp\ on Windows systems where CSIDL_APPDATA is
              not defined.

       Basic Rom=<path>
              Full path for the Basic Rom file. This is moslty useful for  playing  BASIC  tunes.
              By  default  the  program  will  look  for a basic file under the same locations as
              above.

       Chargen Rom=<path>
              Full path for the Character generator Rom file.  Almost  useless  for  playback  of
              tunes,  but  included  for  completeness.   By  default the program will look for a
              chargen file under the same locations as above.

Console

       Ansi=true|false
              Use ANSI escape sequences to provide colored output if supported by the terminal.

       Char Top Left=<char>
              Character for the top left corner.

       Char Top Right=<char>
              Character for the top right corner.

       Char Bottom Left=<char>
              Character for the bottom left corner.

       Char Bottom Right=<char>
              Character for the bottom right corner.

       Char Vertical=<char>
              Character for vertical lines.

       Char Horizontal=<char>
              Character for horizontal lines.

       Char Junction Left=<char>
              Character for left junctions.

       Char Junction Right=<char>
              Character for right junctions.

Audio

       Frequency=<number>
              Playback frequency expressed in Hertz.

       Channels=<number>
              Number of channels, 1 for mono and 2 for stereo playback.

       BitsPerSample=<16|32>
              Number of bits ber sample, used only for wav output. Using values  other  than  the
              ones specified will produce invalid output.

Emulation

       C64Model=<PAL|NTSC|OLD_NTSC|DREAN>
              Default  c64 model, PAL for european PAL-B model, NTSC for american/japanese NTSC-M
              models, OLD_NTSC for NTSC-M models with old video chip and  DREAN  for  argentinian
              PAL-N model.

       ForceC64Model=true|false
              Force the selected c64 model wven if the tune states otherwise.

       SidModel=<MOS6581|MOS8580>
              Default SID chip model, old MOS 6581 or newer MOS 8580

       ForceSidModel=true|false
              Force the selected SID chip model wven if the tune states otherwise.

       UseFilter=true|false
              Enable/disable the emulation of the SID filter.

       FilterBias=<number>
              Controls  the filter bias in the ReSID emulation.  The bias is given in millivolts,
              and a maximum reasonable control range is approximately -500 to 500

       FilterCurve6581=<number>
              Controls the filter curve for the 6581 model in the ReSIDfp emulation.  Ranges from
              0.0 (light) to 1.0 (dark), the default value is 0.5

       FilterCurve8580=<number>
              Controls  the  filter  curve for the 8580 model in the ReSIDfp emulation.  Value is
              expressed in Hertz and the default is 12500

SEE ALSO

       sidplayfp(1)

OTHER INFORMATION

       Sidplayfp Homepage:
           http://sourceforge.net/projects/sidplay-residfp/
       Sidplay2 homepage:
           http://sidplay2.sourceforge.net/
       High Voltage Sid Collection (HVSC):
           http://hvsc.c64.org/

AUTHORS

       sidplay2     - Simon White <sidplay2@yahoo.com>
       sidplay      - Michael Schwendt <sidplay@geocities.com>
       reSID engine - Dag Lem <resid@nimrod.no>
       reSIDfp engine - Antti Lankila <alankila@bel.fi>
       man-page     - Mikko Kilponen <mikil@uni.kaapeli.net>