1
2 VICE 3.5 Dec 2020
3
4
5 _______________
6 | || ||
7 | || ||____________________________
8 | || || || || ||
9 | || || || | || ______||
10 | || || || |----|| ||
11 | || || || | || ------||
12 | ||____||_________||__________||
13 \ // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
14 \ //
15 \________// Versatile Commodore 8-bit Emulator
16
17
18
19 ----------------------------------------------------------------------------
20
21 We are still looking for dedicated maintainers for the Windows port, if you
22 want to help improving these and/or want to provide binaries,
23 please get in touch.
24
25 ----------------------------------------------------------------------------
26
27 This is version 3.5 of VICE, the multi-platform C64, C128, VIC20,
28 PET, PLUS4 and CBM-II emulator. This version can be compiled for
29 Win32, macOS, Haiku and for most Unix systems provided with the X Window
30 System version 11, R5 or later.
31
32 The following programs are included:
33
34 - x64sc, a C64 emulator focused on accuracy;
35
36 - xscpu64, a C64 emulator with a SuperCPU cart;
37
38 - x64dtv, a C64 Direct-to-TV (DTV) emulator;
39
40 - x128, a C128 emulator;
41
42 - xvic, a VIC20 emulator;
43
44 - xpet, a PET emulator;
45
46 - xplus4, a PLUS4 emulator;
47
48 - xcbm2, a CBM-6x0/7x0 emulator;
49
50 - xcbm5x0, a CBM-5x0 emulator;
51
52 - vsid, a SID player;
53
54 - c1541, a stand-alone disk image maintenance utility;
55
56 - petcat, a CBM BASIC de-tokenizer;
57
58 - cartconv, a C64/C128 cartridge conversion program.
59
60 - x64, the old and less accurate C64 emulator, is no more built by default
61 and only included if explicitly enabled at configure time;
62
63 Moreover, the following documents are provided in both source and
64 binary distributions:
65
66 - README, this file;
67
68 - NEWS, list of user-visible changes between this and older versions of VICE;
69
70 - COPYING, the GNU General Public License under which VICE is
71 distributed -- *please read it before using the program*;
72
73 The following documents are provided in the source distribution:
74
75 - in the doc directory:
76
77 - vice.texi, the complete documentation; documentation in various different
78 formats may be generated from it (vice.txt, vice.pdf)
79 - iec-bus.txt, overview of the VICE IEC bus emulation;
80 - CIA-README.txt, overview of the VICE CIA emulation;
81 - coding-guidelines.txt, description of VICE coding style
82 - Documentation-Howto.txt, information on how to edit the documentation
83 - Doxygen-Howto.txt, how to generate doxygen documentation
84 - Release-Howto.txt, some hints and reminders on how to create a release
85 tarball (for maintainers) are supported on the various platforms.
86
87 - in the doc/readmes directory:
88
89 - Readme-GTK3.txt, GTK3 specific documentation;
90 - Readme-SDL.txt, SDL specific documentation;
91 - Readme-SDL2.txt, SDL2 specific documentation;
92
93 - in the doc/building directory:
94
95 - Android-Howto, how to compile the Android SDL port
96 - FreeBSD-GTK3-Howto.txt, hints on compiling the GTK3 port on FreeBSD
97 - GTK3-cross-build-setup.md, (incomplete) instructions on how to set up
98 a windows crosscompiler on linux
99 - GTK3-debian-frankenvice.md, instructions on how to set up a windows
100 crosscompiler on debian using precompiled fedora mingw packages
101 - GTK3-Fedora-cross-build-setup.md, (incomplete) instructions on how to
102 set up a windows crosscompiler on Fedora linux
103 - Linux-GTK3-Howto.txt, how to compile the GTK3 port on Linux
104 - macOS-Distribution-Howto.txt, how to build the macOS binary distribution
105 - macOS-Howto.txt, how to build on macOS (might be deprecated)
106 - macOS-Xcode-Howto.txt, how to build the macOS port(s) using Xcode
107 - NetBSD-Gtk3-Wowto.txt, hints on compiling for NetBSD with Gtk3
108 - NetBSD-howto.txt, hints on compiling for NetBSD
109 - SDL-Howto.txt, how to compile the SDL port on various platforms
110 - Windows-MinGW-GTK3-Howto.txt, how to compile the Windows port using
111 MingGW/MSYS2
112
113 For the latest news, have a look at the VICE home page:
114
115 http://vice-emu.sourceforge.net/
116
117 Also some information that was previously included in the distribution has been
118 moved into our wiki at sourceforge:
119
120 - The TODO list,
121 http://vice-emu.sourceforge.net/wiki/index.php/Todo#New_Features
122
123 - The list of known BUGS,
124 http://vice-emu.sourceforge.net/wiki/index.php/Todo#Known_Issues
125
126 New versions are made available usually once per year, so please stay tuned.
127
128 You may also check out the automatic nightly builds, which are kindly provided
129 by the pokefinder crew: https://vice.pokefinder.org/
130
131
132 Have fun!
133
134
135 Feedback
136 --------
137
138 It's always nice to receive feedback and/or bugreports about VICE, but please
139 read these few notes before sending mail to anybody in the team.
140
141 - Please don't send any HTML mail (we really hate that!). Please make sure
142 you turn off the "rich text" (HTML) feature.
143
144 - Please don't send any binaries without asking first.
145
146 - Please read the following documents carefully before reporting a bug or a
147 problem you cannot solve:
148
149 - the VICE documentation (you should have received it with the main
150 distribution--if not, tell us);
151 Online version - http://vice-emu.sourceforge.net/vice_toc.html
152
153 - the VICE wiki at http://vice-emu.pokefinder.org/
154
155 - Before reporting a bug, please try a recent nightly build and check if your
156 issue is already fixed. You can fine nightly builds for windows here:
157 <SF-uploads via Travis-CI?>
158
159 - When you report a bug, please try to be as accurate as possible and describe
160 how it can be reproduced to the very detail. You should also tell us what
161 machine you are running on, what operating system you are using as well as
162 the version of Vice.
163
164 - Please don't ask us how to transfer original C64 disk or tapes to your PC. To
165 transfer disks, you can use the Star Commander (http://sta.c64.org/sc.html).
166
167 - Please don't ask us where to find games for the emulator on the Internet.
168
169 - Please don't ask us when the next version will be out, because we really
170 don't know. We are trying to make at least one release per year, around
171 christmas.
172
173 - Please write in English.
174
175 In any case, we would be really glad to receive your comments about VICE.
176
177 The central place for bug reports is the bug tracker at sourceforge:
178 https://sourceforge.net/p/vice-emu/bugs/
179
180 At sourceforge you can also submit feature requests:
181 https://sourceforge.net/p/vice-emu/feature-requests/
182
183 The email address for feedback is: vice-emu-mail@lists.sourceforge.net
184
185 Thanks!
186
187
188 Copyright notice
189 ----------------
190
191 VICE, the Versatile Commodore Emulator
192
193 Core Team Members:
194 1999-2020 Martin Pottendorfer
195 2005-2020 Marco van den Heuvel
196 2007-2020 Fabrizio Gennari
197 2009-2020 Groepaz
198 2009-2020 Errol Smith
199 2009-2020 Ingo Korb
200 2010-2020 Olaf Seibert
201 2011-2020 Marcus Sutton
202 2011-2020 Kajtar Zsolt
203 2016-2020 AreaScout
204 2016-2020 Bas Wassink
205 2017-2020 Michael C. Martin
206 2018-2020 Christopher Phillips
207 2019-2020 David Hogan
208
209 Inactive/Ex Team Members:
210 2011-2016 Stefan Haubenthal
211 2015-2016 BSzili
212 1999-2016 Andreas Matthies
213 2007-2015 Daniel Kahlin
214 2012-2014 Benjamin 'BeRo' Rosseaux
215 2011-2014 Ulrich Schulz
216 2011-2014 Thomas Giesel
217 2008-2014 Antti S. Lankila
218 2006-2014 Christian Vogelgsang
219 1998-2014 Dag Lem
220 2000-2011 Spiro Trikaliotis
221 2007-2011 Hannu Nuotio
222 1998-2010 Andreas Boose
223 1998-2010 Tibor Biczo
224 2007-2010 M. Kiesel
225 1999-2007 Andreas Dehmel
226 2003-2005 David Hansel
227 2000-2004 Markus Brenner
228 1999-2004 Thomas Bretz
229 1997-2001 Daniel Sladic
230 1996-2001 Andr� Fachat
231 1996-1999 Ettore Perazzoli
232 1993-1994, 1997-1999 Teemu Rantanen
233 1993-1996 Jouko Valta
234 1993-1994 Jarkko Sonninen
235
236 Translation Team Members:
237 2009-2017 Mikkel Holm Olsen
238 2000-2017 Martin Pottendorfer
239 2011-2017 Manuel Antonio Rodriguez Bas
240 2004-2017 Paul Dub�
241 2006-2017 Czirkos Zoltan
242 2006-2017 Karai Csaba
243 2001-2017 Andrea Musuruane
244 2011-2016 Jesse Lee
245 2005-2017 Marco van den Heuvel
246 2011-2017 Jarek Sobolewski
247 2010-2017 Michael Litvinov
248 2000-2017 Peter Krefting
249 2008-2017 Emir Akaydin
250
251 This program is free software; you can redistribute it and/or
252 modify it under the terms of the GNU General Public License as
253 published by the Free Software Foundation; either version 2 of the
254 License, or (at your option) any later version.
255
256 This program is distributed in the hope that it will be useful,
257 but WITHOUT ANY WARRANTY; without even the implied warranty of
258 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
259 GNU General Public License for more details.
260
261 You should have received a copy of the GNU General Public License
262 along with this program; if not, write to the Free Software
263 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
264 02111-1307 USA
265
266 The ROM files in the `C128', `C64', `CBM-II', `DRIVES', `PET', `PLUS4'
267 `PRINTER' and `VIC20' directories are Copyright C by Commodore
268 Business Machines.
269
270 The ROM files in the `C64DTV` directory are Copyright C by Commodore
271 Business Machines, as well as Mammoth Toys, a division of nsi ltd.,
272 Digital Concepts DC studios inc., Ironstone Partners ltd., and
273 Toy:Lobster company ltd.
274