1SIDPLAYFP.INI(5) File formats SIDPLAYFP.INI(5)
2
3
4
6 sidplayfp.ini - Configuration file for sidplayfp(1).
7
9 This page describes the options available for the configuration file of
10 Sidplayfp. It is composed by a number of sections, each one composed
11 by a section name, enclosed by square brackets, followed by a list of
12 <parameter>=<value> lines.
13
14 sidplayfp.ini supports the following sections:
15
16 [SIDPlayfp] - Generic configuration
17
18 [Console] - Console appearance configuration
19
20 [Audio] - Audio output configuration
21
22 [Emulation] - Emulation engine parameters
23
24 All options and values are described in detail below.
25
26 For any of the following parameter, if it's specified more than one
27 time the last entry encountered will be used.
28
29 NOTE: if any of these options is specified outside its section, it will
30 be ignored.
31
32 SIDPlayfp
33 Version=<number>
34 Configuration version
35
36 Songlength Database=<path>
37 Full path for the Songlength DB. By default the program will look
38 for a file named DOCUMENTS/Songlengths.txt under the HVSC
39 collection path, if the HVSC_BASE environment variable is defined.
40 On *NIX systems, if this value is not set, sidplayfp(1) will try
41 $PREFIX/share/sidplayfp/Songlengths.txt.
42
43 Default Play Length=mm:ss
44 Default play time if Songlength Database is not found.
45
46 Default Record Length=mm:ss
47 Default recording time when writing wave files if Songlength
48 Database is not found.
49
50 Kernal Rom=<path>
51 Full path for the Kernal Rom file. This is the most important rom
52 and should always be provided, although many tunes will still work
53 without. By default the program will look for a file named kernal
54 under the following locations:
55
56 · $XDG_DATA_HOME/sidplayfp/
57
58 on *NIX systems where XDG_DATA_HOME is defined.
59
60 · $HOME/.local/share/sidplayfp/
61
62 on *NIX systems where XDG_DATA_HOME is not defined.
63
64 · $PREFIX/share/sidplayfp
65
66 on *NIX systems when not found in the above directories.
67
68 · %CSIDL_APPDATA%\\sidplayfp\\
69
70 on Windows systems where CSIDL_APPDATA is defined.
71
72 · %USERPROFILE%\\Application Data\\sidplayfp\\
73
74 on Windows systems where CSIDL_APPDATA is not defined.
75
76 Basic Rom=<path>
77 Full path for the Basic Rom file. This is mostly useful for playing
78 BASIC tunes. By default the program will look for a file named
79 basic under the same locations as above.
80
81 Chargen Rom=<path>
82 Full path for the Character generator Rom file. Almost useless for
83 playback of tunes, but included for completeness. By default the
84 program will look for a file named chargen under the same locations
85 as above.
86
87 Console
88 Ansi=true|false
89 Use ANSI escape sequences to provide colored output.
90
91 Char Top Left=<char>
92 Character for the top left corner.
93
94 Char Top Right=<char>
95 Character for the top right corner.
96
97 Char Bottom Left=<char>
98 Character for the bottom left corner.
99
100 Char Bottom Right=<char>
101 Character for the bottom right corner.
102
103 Char Vertical=<char>
104 Character for vertical lines.
105
106 Char Horizontal=<char>
107 Character for horizontal lines.
108
109 Char Junction Left=<char>
110 Character for left junctions.
111
112 Char Junction Right=<char>
113 Character for right junctions.
114
115 Audio
116 Frequency=<number>
117 Playback frequency expressed in Hertz. Default is 48000.
118
119 Channels=<number>
120 Number of channels, 1 for mono and 2 for stereo playback Default is
121 1.
122
123 BitsPerSample=<16|32>
124 Number of bits ber sample, used only for wav output. Using values
125 other than the ones specified will produce invalid output.
126
127 Emulation
128 Engine=<RESIDFP|RESID|HARDSID|EXSID|NONE>
129 Set the SID emulation engine. Default is RESIDFP.
130
131 C64Model=<PAL|NTSC|OLD_NTSC|DREAN>
132 Default c64 model to use if not specified by tune, PAL for european
133 PAL-B model, NTSC for american/japanese NTSC-M models, OLD_NTSC for
134 NTSC-M models with old video chip and DREAN for argentinian PAL-N
135 model. Default is PAL.
136
137 ForceC64Model=true|false
138 Force the configured c64 model even if the tune specifies one.
139
140 CiaModel=<MOS6526|MOS8521>
141 Select CIA chip model, old MOS 6526 or newer MOS 8521.
142
143 SidModel=<MOS6581|MOS8580>
144 Default SID chip model, old MOS 6581 or newer MOS 8580.
145
146 ForceSidModel=true|false
147 Force the configured SID chip model even if the tune specifies one.
148
149 DigiBoost=true|false
150 Enable digiboost for 8580 model.
151
152 UseFilter=true|false
153 Enable/disable the emulation of the SID filter.
154
155 FilterBias=<number>
156 Controls the filter bias in the ReSID emulation. Ranges from 0.0
157 (dark) to 1.0 (light), the default value is 0.5.
158
159 FilterCurve6581=<number>
160 Controls the filter curve for the 6581 model in the ReSIDfp
161 emulation. Ranges from 0.0 (light) to 1.0 (dark), the default
162 value is 0.5.
163
164 FilterCurve8580=<number>
165 Controls the filter curve for the 8580 model in the ReSIDfp
166 emulation. Ranges from 0.0 (light) to 1.0 (dark), the default
167 value is 0.5.
168
170 sidplayfp(1)
171
173 Leandro Nini
174 Current maintainer.
175
176 Simon White
177 Wrote the original Sidplay2.
178
179 Dag Lem
180 Wrote the reSID emulation engine.
181
182 Antti S. Lankila
183 Wrote the reSIDfp emulation engine as a fork of reSID 0.16.
184
185 The Vice team
186 Large part of the emulation is based on the VICE's code.
187
188 Andre Fachat
189 Wrote the original reloc65 utility.
190
191 Michael Schwendt
192 Wrote the original SidTune library and MD5 class (based on work by
193 L. Peter Deutsch).
194
195 Mikko Kilponen
196 Wrote the originla man page.
197
199 SourceForge project: <http://sourceforge.net/projects/sidplay-residfp/>
200 Sidplay2 homepage: <http://sidplay2.sourceforge.net/>
201 High Voltage Sid Collection (HVSC): <http://hvsc.c64.org/>
202
204 Copyright (C) 2000-2004 Simon White
205 Copyright (C) 2007-2010 Antti Lankila
206 Copyright (C) 2009-2015 VICE Project
207 Copyright (C) 2010-2020 Leandro Nini
208
209 This program is free software; you can redistribute it and/or modify it
210 under the terms of the GNU General Public License as published by the
211 Free Software Foundation; either version 2 of the License, or (at your
212 option) any later version.
213
214 This program is distributed in the hope that it will be useful, but
215 WITHOUT ANY WARRANTY; without even the implied warranty of
216 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
217 General Public License for more details.
218
219 You should have received a copy of the GNU General Public License along
220 with this program; if not, write to the Free Software Foundation, Inc.,
221 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
222
223
224
225perl v5.26.3 2020-04-22 SIDPLAYFP.INI(5)