1SIDPLAYFP(1) User Programs SIDPLAYFP(1)
2
6 sidplayfp - a C64 and SID chip emulator for playing Commodore 64 music.
7
9 sidplayfp [OPTIONS] datafile
10
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
20 -h, --help
21 Display help.
22 -h, --help-debug
24 Display additional options helpful for debugging.
25 -f<num>
27 Set audio output frequency in Hz (default: 48000).
28 -nf No filter emulation. This will reduce CPU overhead at the cost of
30 reduced emulation quality.
31 -o<num>
33 Select track number (default: preset).
34 -s Stereo playback. If the tune is identified as stereo then sid 1
36 and 2 become the left and right channels respectively. For three
37 sid tunes the chips are mixed as left, center and right.
38 -m Mono playback.
40 -v|q[level]
42 Verbose or quiet (no time display) console output while playing.
43 Can include an optional level, defaults to 1.
44 -b<num>
46 Set start time in [mins:]secs[.milli] format (compatible with
47 sid2wav).
48 -ds<addr>
50 Force dual sid environment by adding a second chip at specified
51 address. This forces emulation of 2 sid-chips for stereo playback
52 even if datafile is identified as only being mono. This occurs in
53 the case of the stereo prg format as currently there is no way to
54 identify them. Stereo MUS and SID files are however automatically
55 detected. The second sid may be installed in the 0xD420-0xD7FF or
56 0xDE00-0xDFFF address range. Address may be specified in
57 exadecimal (e.g -ds0xd420) or decimal (e.g. -ds54304) format.
58 -ts<addr>
60 Add a third chip at specified address. The sid may be installed in
61 the 0xD420-0xD7FF or 0xDE00-0xDFFF address range. Address may be
62 specified in exadecimal (e.g -ts0xd440) or decimal (e.g. -ts54336)
63 format.
64 -u<num>
66 Mute a channel. May be used more than one time. Channel 1 to 3
67 are for the first SID chip while channels from 4 to 6 are for the
68 second one and 7 to 9 for the third.
69 -p<num>
71 Set bit precision for file saving. The default is 16 to create 16
72 bit signed samples, but can be set to 32 (32 bit float). Other
73 values will cause invalid output.
74 -o<l|s>
76 Option 'l' will select continuous track looping while 's' will
77 select the current track instead of all. This option can be
78 combined with the track selection to form -ols<num>.
79 -t<num>
81 Set play length in [mins:]secs[.milli] format (0 is endless).
82 -v<n|p>[f]
84 Set VIC clock speed. 'n' is NTSC (America, 60Hz) and 'p' is PAL
85 (Europe, 50Hz). Providing an 'f' will prevent speed fixing that
86 tries to compensate automatically for the speed difference.
87 Removing speed fixing simulates what happens on a real C64.
88 Options can be written as: -vnf or -vn -vf.
89 -m<o|n>[f]
91 Set SID chip model. 'o' is the old 6581 and 'n' is the new 8580.
92 Providing an 'f' will force the selected model overriding the one
93 specified by the tune.
94 --digiboost
96 Enable digiboost hack for 8580 model so the digi samples become
97 audible.
98 -r<i|r>[f]
100 Set resampling mode. 'i' is interpolation (less expensive) and 'r'
101 resampling (accurate). Providing an 'f' will provide faster
102 resampling sacrificing quality. Fast resampling is available only
103 for reSID emulation. Options can be written as: -rif or -ri -rf.
104 -w, --wav[name]
106 Create WAV-file. The default output filename is <datafile>[n].wav
107 where [n] is the tune number should there be more than one in the
108 sid. This allows batch conversion of sid tunes without them
109 overwriting each other. By providing a name it is possible to
110 override this default behavior. The output file will be <name>
111 with no tune number added and the extension .wav appended if no
112 extension is given.
113 --au[name]
115 Create AU-file. The default output filename is <datafile>[n].au.
116 Same notes as the wav file applies.
117 --resid
119 Use VICE's original reSID emulation engine.
120 --residfp
122 Use reSIDfp emulation engine.
123 --hardsid
125 Use HardSID device.
126 --exsid
128 Use exSID device.
129 --cpu-debug
131 Display cpu register and assembly dumps, available only for debug
132 builds.
133 --delay=[num]
135 Simulate c64 power on delay as number of cpu cycles. If greater
136 than 8191 the delay will be random. This is the default.
137 --noaudio
139 Run without an audio output device.
140 --nosid
142 Run without sid emulation.
143 --none
145 Run with no audio output device and no sid emulation.
146
148 1-9 Mute/unmute voice.
149 f Toggle filter.
151 p Pause/unpause playback.
153 Esc Quit player.
155 Up/Down Arrows
157 Increase/reset playback speed.
158 Left/Right Arrows
160 Move to previous/next subtune.
161 Home/End Arrows
163 Go to first/last subtune.
164
166 HVSC_BASE
167 The path to the HVSC base directory. If specified the songlength DB
168 will be loaded from here and relative SID tune paths are accepted.
169
171 sidplayfp.ini
172 The configuration file. See sidplayfp.ini(5) for further details.
173 kernal
175 The c64 kernal rom dump file.
176 basic
178 The c64 basic rom dump file.
179 chargen
181 The c64 character generator rom dump file.
182
184 The upstream bug tracker can be found at
185 <https://github.com/libsidplayfp/sidplayfp/issues/>.
186
188 sidplayfp.ini(5)
189
191 ROM dumps are not embedded due to copyright issues and must be supplied
192 by the user. Check the sidplayfp.ini(5) documentation for
193 configuration details and default search paths.
194
196 Leandro Nini
197 Current maintainer.
198 Simon White
200 Wrote the original Sidplay2.
201 Dag Lem
203 Wrote the reSID emulation engine.
204 Antti S. Lankila
206 Wrote the reSIDfp emulation engine as a fork of reSID 0.16.
207 The Vice team
209 Large part of the emulation is based on the VICE's code.
210 Andre Fachat
212 Wrote the original reloc65 utility.
213 Michael Schwendt
215 Wrote the original SidTune library and MD5 class (based on work by
216 L. Peter Deutsch).
217 Mikko Kilponen
219 Wrote the original man page.
220
222 Home page: <https://github.com/libsidplayfp/>
223 Sidplay2 homepage: <http://sidplay2.sourceforge.net/>
224 High Voltage Sid Collection (HVSC): <http://hvsc.c64.org/>
225
227 Copyright (C) 2000-2004 Simon White
228 Copyright (C) 2007-2010 Antti Lankila
229 Copyright (C) 2009-2015 VICE Project
230 Copyright (C) 2010-2022 Leandro Nini
231 This program is free software; you can redistribute it and/or modify it
233 under the terms of the GNU General Public License as published by the
234 Free Software Foundation; either version 2 of the License, or (at your
235 option) any later version.
236 This program is distributed in the hope that it will be useful, but
238 WITHOUT ANY WARRANTY; without even the implied warranty of
239 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
240 General Public License for more details.
241 You should have received a copy of the GNU General Public License along
243 with this program; if not, write to the Free Software Foundation, Inc.,
244 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
245perl v5.30.0 2022-11-06 SIDPLAYFP(1)