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>