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 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
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
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
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
150 The upstream bug tracker can be found at
151 <http://sourceforge.net/p/sidplay-residfp/bugs/>.
152
154 sidplayfp.ini(5)
155
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
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
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
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)