NAME

       SIDPLAYFP - Sidplayfp is a SID-chip emulator for playing Commodore 64 music.

SYNOPSIS

       sidplayfp [ OPTIONS... ] <datafile>

DESCRIPTION

       Sidplayfp  is  a  music  player that emulates various components from a Commodore 64 (C64)
       computer.  The result is a program which can load and execute C64  machine  code  programs
       which  produce music and sound.  Sidplayfp has been designed for accuracy which results in
       a much higher cpu usage.  Additional playback modes have however been  provided  to  allow
       playback  on low specification machines at the cost of accuracy, but it still has a higher
       cpu demand than Sidplay.

SIDPLAYFP OPTIONS

       --help|-h
              Display help.

       -f<num>
              Set frequency in Hz (default: 44100).

       -nf    No filter emulation.  This will reduce CPU overhead at the cost  of  reduced  sound
              quality.

       -o<num>
              Select track number (default: preset).

       -s     Stereo  playback.   If the tune is identified as stereo then sid 1 and 2 become the
              left and right channels respectively.

       -v[num]
              Verbose output while playing.

       -b<num>
              Set start time in [mins:]secs format (compatible with sid2wav).

       -ds<addr>
              Force dual sid environment by adding a second  chip  at  specified  address.   This
              forces emulation of  2 sid-chips for stereo playback even if datafile is identified
              as only being mono.  This occurs in the case of the stereo prg format as  currently
              there  is  no  way  to  identify  them.   Stereo  MUS  and  SID  files  are however
              automatically detected.  The second sid may be installed in  the  0xD420-0xD7FF  or
              0xDE00-0xDFFF   address  range.   Address  may  be  specified  in  exadecimal  (e.g
              -ds0xd420) or decimal (e.g. -ds54304) format.

       -u<num>
              Mute a channel.  May be used more than one time.  Channel 1 to 3 are for the  first
              SID chip while channels from 4 to 6 are for the second one on stereo tunes.

       -p<num>
              Set  bit precision for wav saving. The default is 32 (32 bit float), but can be set
              to 16 to create 16 bit little endian wavs.

       -o<l|s>
              Option 'l' will select continuous track looping while 's' will select  the  current
              track instead of all.  This option can be combined with the track selection to form
              -ols<num>.

       -q     Quiet output while playing (opposite of verbose).

       -s<l|r>
              Playback the left or right stereo channel only.

       -t<num>
              Set play length in [mins:]secs format (0 is endless).

       -v<n|p>[f]
              Set VIC clock speed.  'n' is NTSC (America, 60Hz) and 'p' is  PAL  (Europe,  50Hz).
              Providing  an  'f' will prevent speed fixing that tries to compensate automatically
              for the speed difference.  Removing speed fixing simulates what happens on  a  real
              C64.  Options can be written as: -vnf or -vn -vf.

       -m<o|n>[f]
              Set SID chip model.  'o' is the old 6581 and 'n' is the new 8580.  Providing an 'f'
              will force the selected model overriding the one specified from the tune.

       -r<i|r>[f]
              Set resampling mode.  'i' is interpolation  (less  expensive)  and  'r'  resampling
              (accurate).   Providing  an 'f' will provide faster resampling sacrificing quality.
              Fast resampling is available only for reSID emulation.  Options can be written  as:
              -rif or -ri -rf.

       -w[name]|--wav[name]
              Create WAV-file.  The default output filename is <datafile>[n].wav where [n] is the
              tune number should there be more than one in the sid.  This allows batch conversion
              of sid tunes without them overwriting each other.  By providing a name you override
              this default behavior.  The output file will be <name> with no tune number is added
              and <name> IS NOT checked for or appended with a legal wav file extension.

       --resid
              Use Dag Lem's reSID emulation engine.

       --residfp
              Use Antti Lankila's reSIDfp emulation engine.

       --hardsid
              Use HardSID device.

SEE ALSO

       sidplayfp.ini(5)

NOTES

       ROM  dumps  are  no longer embedded but must be supplied by the user. The ROM are optional
       and most tune should work fine  without.  Check  the  sidplayfp.ini(5)  documentation  for
       configuration details and default search paths.

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>