1SIDPLAYFP(1) User Programs SIDPLAYFP(1)
2
3
4
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
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 file saving. The default is 32 (32 bit
64 float), but can be set to 16 to create 16 bit signed samples. 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 --digiboost
90 Enable digiboost for 8580 model.
91
92 -r<i|r>[f]
93 Set resampling mode. 'i' is interpolation (less expensive) and 'r'
94 resampling (accurate). Providing an 'f' will provide faster
95 resampling sacrificing quality. Fast resampling is available only
96 for reSID emulation. Options can be written as: -rif or -ri -rf.
97
98 -w, --wav[name]
99 Create WAV-file. The default output filename is <datafile>[n].wav
100 where [n] is the tune number should there be more than one in the
101 sid. This allows batch conversion of sid tunes without them
102 overwriting each other. By providing a name it is possible to
103 override this default behavior. The output file will be <name>
104 with no tune number added and <name> IS NOT checked for or appended
105 with a legal wav file extension.
106
107 --au[name]
108 Create AU-file. The default output filename is <datafile>[n].au.
109
110 --resid
111 Use VICE's original reSID emulation engine.
112
113 --residfp
114 Use reSIDfp emulation engine.
115
116 --hardsid
117 Use HardSID device.
118
119 --exsid
120 Use exSID device.
121
123 1-9 Mute/unmute voice.
124
125 f Toggle filter.
126
127 p Pause/unpause playback.
128
129 Esc Quit player.
130
131 Up/Down Arrows
132 Increase/reset playback speed.
133
134 Left/Right Arrows
135 Move to previous/next subtune.
136
137 Home/End Arrows
138 Go to first/last subtune.
139
141 HVSC_BASE
142 The path to the HVSC base directory. If specified the songlength DB
143 will be loaded from here and relative SID tune paths are accepted.
144
146 sidplayfp.ini
147 The configuration file. See sidplayfp.ini(5) for further details.
148
149 kernal
150 The c64 kernal rom dump file.
151
152 basic
153 The c64 basic rom dump file.
154
155 chargen
156 The c64 character generator rom dump file.
157
159 The upstream bug tracker can be found at
160 <http://sourceforge.net/p/sidplay-residfp/bugs/>.
161
163 sidplayfp.ini(5)
164
166 ROM dumps are not embedded due to copyright issues and must be supplied
167 by the user. Check the sidplayfp.ini(5) documentation for
168 configuration details and default search paths.
169
171 Leandro Nini
172 Current maintainer.
173
174 Simon White
175 Wrote the original Sidplay2.
176
177 Dag Lem
178 Wrote the reSID emulation engine.
179
180 Antti S. Lankila
181 Wrote the reSIDfp emulation engine as a fork of reSID 0.16.
182
183 The Vice team
184 Large part of the emulation is based on the VICE's code.
185
186 Andre Fachat
187 Wrote the original reloc65 utility.
188
189 Michael Schwendt
190 Wrote the original SidTune library and MD5 class (based on work by
191 L. Peter Deutsch).
192
193 Mikko Kilponen
194 Wrote the original man page.
195
197 SourceForge project: <http://sourceforge.net/projects/sidplay-residfp/>
198 Sidplay2 homepage: <http://sidplay2.sourceforge.net/>
199 High Voltage Sid Collection (HVSC): <http://hvsc.c64.org/>
200
202 Copyright (C) 2000-2004 Simon White
203 Copyright (C) 2007-2010 Antti Lankila
204 Copyright (C) 2009-2015 VICE Project
205 Copyright (C) 2010-2020 Leandro Nini
206
207 This program is free software; you can redistribute it and/or modify it
208 under the terms of the GNU General Public License as published by the
209 Free Software Foundation; either version 2 of the License, or (at your
210 option) any later version.
211
212 This program is distributed in the hope that it will be useful, but
213 WITHOUT ANY WARRANTY; without even the implied warranty of
214 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
215 General Public License for more details.
216
217 You should have received a copy of the GNU General Public License along
218 with this program; if not, write to the Free Software Foundation, Inc.,
219 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
220
221
222
223perl v5.26.3 2020-04-22 SIDPLAYFP(1)