sidplayfp






sidplayfp − a C64 and SID chip emulator for playing
Commodore 64 music.

sidplayfp [OPTIONS] datafile

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 quite high cpu usage.
Additional playback modes have however been provided to
allow playback on low specification machines at the cost of
accuracy.



−h, −−help
    Display help.

−f<num>
    Set audio output frequency in Hz (default: 48000).

−nf No filter emulation.  This will reduce CPU overhead at
    the cost of reduced emulation 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.

−ts<addr>
    Add a third chip at specified address.  The sid may be
    installed in the 0xD420−0xD7FF or 0xDE00−0xDFFF address









                             ‐2‐


    range.  Address may  be specified in exadecimal (e.g
    −ts0xd440) or decimal (e.g.  −ts54336) 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 and 7 to 9 for the
    third.

−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. Other values will cause invalid output.

−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).

−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 by 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, −−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 it is possible to override
    this default behavior.  The output file will be <name>
    with no tune number added and <name> IS NOT checked for
    or appended with a legal wav file extension.









                             ‐3‐


−−resid
    Use VICE’s original reSID emulation engine.

−−residfp
    Use reSIDfp emulation engine.

−−hardsid
    Use HardSID device.



1−9 Mute/unmute voice.

f   Toggle filter.

p   Pause/unpause playback.

Esc Quit player.

Up/Down Arrows
    Increase/reset playback speed.

Left/Right Arrows
    Move to previous/next subtune.

Home/End Arrows
    Go to first/last subtune.



HVSC_BASE
    The path to the HVSC base directory. If specified the
    songlength DB will be loaded from here and relative SID
    tune paths are accepted.



sidplayfp.ini
    The configuration file. See sidplayfp.ini(5) for further
    details.

kernal
    The c64 kernal rom dump file.

basic
    The c64 basic rom dump file.

chargen
    The c64 character generator rom dump file.

The upstream bug tracker can be found at
<http://sourceforge.net/p/sidplay−residfp/bugs/>.











                             ‐4‐


sidplayfp.ini(5)

ROM dumps are not embedded due to copyright issues and must
be supplied by the user.  Check the sidplayfp.ini(5)
documentation for configuration details and default search
paths.



Leandro Nini
    Current maintainer.

Simon White
    Wrote the original Sidplay2.

Dag Lem
    Wrote the reSID emulation engine.

Antti S. Lankila
    Wrote the reSIDfp emulation engine as a fork of reSID
    0.16.

The Vice team
    Large part of the emulation is based on the VICE’s code.

Andre Fachat
    Wrote the original reloc65 utility.

Michael Schwendt
    Wrote the original SidTune library and MD5 class (based
    on work by L. Peter Deutsch).

Mikko Kilponen
    Wrote the original man page.



SourceForge project:
    <http://sourceforge.net/projects/sidplay−residfp/>

Sidplay2 homepage: <http://sidplay2.sourceforge.net/>

High Voltage Sid Collection (HVSC): <http://hvsc.c64.org/>



Copyright (C) 2000−2004 Simon White

Copyright (C) 2007−2010 Antti Lankila

Copyright (C) 2009−2015 VICE Project

Copyright (C) 2010−2016 Leandro Nini










                             ‐5‐


     This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later
version.

     This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.  See the GNU General Public License for more
details.

     You should have received a copy of the GNU General
Public License along with this program; if not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth
Floor, Boston, MA  02110−1301, USA.