1SIDPLAYFP(1)                     User Programs                    SIDPLAYFP(1)
2
3
4

NAME

6       sidplayfp - a C64 and SID chip emulator for playing Commodore 64 music.
7

SYNOPSIS

9       sidplayfp [OPTIONS] datafile
10

DESCRIPTION

12       Sidplayfp is a music player that emulates various components from a
13       Commodore 64 (C64) computer.  The result is a program which can load
14       and execute C64 machine code programs which produce music and sound.
15       Sidplayfp has been designed for accuracy which results in a quite high
16       cpu usage.  Additional playback modes have however been provided to
17       allow playback on low specification machines at the cost of accuracy.
18

OPTIONS

20       -h, --help
21           Display help.
22
23       -f<num>
24           Set audio output frequency in Hz (default: 48000).
25
26       -nf No filter emulation.  This will reduce CPU overhead at the cost of
27           reduced emulation quality.
28
29       -o<num>
30           Select track number (default: preset).
31
32       -s  Stereo playback.  If the tune is identified as stereo then sid 1
33           and 2 become the left and right channels respectively.
34
35       -v[num]
36           Verbose output while playing.
37
38       -b<num>
39           Set start time in [mins:]secs format (compatible with sid2wav).
40
41       -ds<addr>
42           Force dual sid environment by adding a second chip at specified
43           address.  This forces emulation of 2 sid-chips for stereo playback
44           even if datafile is identified as only being mono.  This occurs in
45           the case of the stereo prg format as currently there is no way to
46           identify them.  Stereo MUS and SID files are however automatically
47           detected.  The second sid may be installed in the 0xD420-0xD7FF or
48           0xDE00-0xDFFF address range.  Address may  be specified in
49           exadecimal (e.g -ds0xd420) or decimal (e.g.  -ds54304) format.
50
51       -ts<addr>
52           Add a third chip at specified address.  The sid may be installed in
53           the 0xD420-0xD7FF or 0xDE00-0xDFFF address range.  Address may  be
54           specified in exadecimal (e.g -ts0xd440) or decimal (e.g.  -ts54336)
55           format.
56
57       -u<num>
58           Mute a channel.  May be used more than one time.  Channel 1 to 3
59           are for the first SID chip while channels from 4 to 6 are for the
60           second one and 7 to 9 for the third.
61
62       -p<num>
63           Set bit precision for wav saving. The default is 32 (32 bit float),
64           but can be set to 16 to create 16 bit little endian wavs. Other
65           values will cause invalid output.
66
67       -o<l|s>
68           Option 'l' will select continuous track looping while 's' will
69           select the current track instead of all.  This option can be
70           combined with the track selection to form -ols<num>.
71
72       -q  Quiet output while playing (opposite of verbose).
73
74       -t<num>
75           Set play length in [mins:]secs format (0 is endless).
76
77       -v<n|p>[f]
78           Set VIC clock speed.  'n' is NTSC (America, 60Hz) and 'p' is PAL
79           (Europe, 50Hz).  Providing an 'f' will prevent speed fixing that
80           tries to compensate automatically for the speed difference.
81           Removing speed fixing simulates what happens on a real C64.
82           Options can be written as: -vnf or -vn -vf.
83
84       -m<o|n>[f]
85           Set SID chip model.  'o' is the old 6581 and 'n' is the new 8580.
86           Providing an 'f' will force the selected model overriding the one
87           specified by the tune.
88
89       -r<i|r>[f]
90           Set resampling mode.  'i' is interpolation (less expensive) and 'r'
91           resampling (accurate).  Providing an 'f' will provide faster
92           resampling sacrificing quality.  Fast resampling is available only
93           for reSID emulation.  Options can be written as: -rif or -ri -rf.
94
95       -w, --wav[name]
96           Create WAV-file.  The default output filename is <datafile>[n].wav
97           where [n] is the tune number should there be more than one in the
98           sid.  This allows batch conversion of sid tunes without them
99           overwriting each other.  By providing a name it is possible to
100           override this default behavior.  The output file will be <name>
101           with no tune number added and <name> IS NOT checked for or appended
102           with a legal wav file extension.
103
104       --resid
105           Use VICE's original reSID emulation engine.
106
107       --residfp
108           Use reSIDfp emulation engine.
109
110       --hardsid
111           Use HardSID device.
112

Key bindings

114       1-9 Mute/unmute voice.
115
116       f   Toggle filter.
117
118       p   Pause/unpause playback.
119
120       Esc Quit player.
121
122       Up/Down Arrows
123           Increase/reset playback speed.
124
125       Left/Right Arrows
126           Move to previous/next subtune.
127
128       Home/End Arrows
129           Go to first/last subtune.
130

ENVIRONMENT VARIABLES

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

FILES

137       sidplayfp.ini
138           The configuration file. See sidplayfp.ini(5) for further details.
139
140       kernal
141           The c64 kernal rom dump file.
142
143       basic
144           The c64 basic rom dump file.
145
146       chargen
147           The c64 character generator rom dump file.
148

BUGS

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

SEE ALSO

154       sidplayfp.ini(5)
155

NOTES

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

AUTHORS

162       Leandro Nini
163           Current maintainer.
164
165       Simon White
166           Wrote the original Sidplay2.
167
168       Dag Lem
169           Wrote the reSID emulation engine.
170
171       Antti S. Lankila
172           Wrote the reSIDfp emulation engine as a fork of reSID 0.16.
173
174       The Vice team
175           Large part of the emulation is based on the VICE's code.
176
177       Andre Fachat
178           Wrote the original reloc65 utility.
179
180       Michael Schwendt
181           Wrote the original SidTune library and MD5 class (based on work by
182           L. Peter Deutsch).
183
184       Mikko Kilponen
185           Wrote the original man page.
186

RESOURCES

188       SourceForge project: <http://sourceforge.net/projects/sidplay-residfp/>
189       Sidplay2 homepage: <http://sidplay2.sourceforge.net/>
190       High Voltage Sid Collection (HVSC): <http://hvsc.c64.org/>
191

COPYING

193       Copyright (C) 2000-2004 Simon White
194       Copyright (C) 2007-2010 Antti Lankila
195       Copyright (C) 2009-2015 VICE Project
196       Copyright (C) 2010-2016 Leandro Nini
197
198       This program is free software; you can redistribute it and/or modify it
199       under the terms of the GNU General Public License as published by the
200       Free Software Foundation; either version 2 of the License, or (at your
201       option) any later version.
202
203       This program is distributed in the hope that it will be useful, but
204       WITHOUT ANY WARRANTY; without even the implied warranty of
205       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
206       General Public License for more details.
207
208       You should have received a copy of the GNU General Public License along
209       with this program; if not, write to the Free Software Foundation, Inc.,
210       51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
211
212
213
214perl v5.24.4                      2018-06-17                      SIDPLAYFP(1)
Impressum