VICE 3.7 Dec 2022
_______________
| || ||
| || ||____________________________
| || || || || ||
| || || || | || ______||
| || || || |----|| ||
| || || || | || ------||
| ||____||_________||__________||
\ // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
\ //
\________// Versatile Commodore 8-bit Emulator
----------------------------------------------------------------------------
We are still looking for dedicated maintainers for the Windows port, if you
want to help improving these and/or want to provide binaries,
please get in touch.
----------------------------------------------------------------------------
This is version 3.7 of VICE, the multi-platform C64, C128, VIC20,
PET, PLUS4 and CBM-II emulator. This version can be compiled for
Win32, macOS, Haiku and for most Unix systems provided with the X Window
System version 11, R5 or later.
The following programs are included:
- x64sc, a C64 emulator focused on accuracy;
- xscpu64, a C64 emulator with a SuperCPU cart;
- x64dtv, a C64 Direct-to-TV (DTV) emulator;
- x128, a C128 emulator;
- xvic, a VIC20 emulator;
- xpet, a PET emulator;
- xplus4, a PLUS4 emulator;
- xcbm2, a CBM-6x0/7x0 emulator;
- xcbm5x0, a CBM-5x0 emulator;
- vsid, a SID player;
- c1541, a stand-alone disk image maintenance utility;
- petcat, a CBM BASIC de-tokenizer;
- cartconv, a C64/C128 cartridge conversion program.
- x64, the old and less accurate C64 emulator, is no more built by default
and only included if explicitly enabled at configure time;
Moreover, the following documents are provided in both source and
binary distributions:
- README, this file;
- NEWS, list of user-visible changes between this and older versions of VICE;
- COPYING, the GNU General Public License under which VICE is
distributed -- *please read it before using the program*;
The following documents are provided in the source distribution:
- in the doc directory:
- vice.texi, the complete documentation; documentation in various different
formats may be generated from it (vice.txt, vice.pdf)
- iec-bus.txt, overview of the VICE IEC bus emulation;
- CIA-README.txt, overview of the VICE CIA emulation;
- coding-guidelines.txt, description of VICE coding style
- Documentation-Howto.txt, information on how to edit the documentation
- Doxygen-Howto.txt, how to generate doxygen documentation
- Release-Howto.txt, some hints and reminders on how to create a release
tarball (for maintainers) are supported on the various platforms.
- in the doc/readmes directory:
- Readme-GTK3.txt, GTK3 specific documentation;
- Readme-SDL.txt, SDL specific documentation;
- Readme-SDL2.txt, SDL2 specific documentation;
- in the doc/building directory:
- Android-Howto, how to compile the Android SDL port
- FreeBSD-GTK3-Howto.txt, hints on compiling the GTK3 port on FreeBSD
- GTK3-cross-build-setup.md, (incomplete) instructions on how to set up
a windows crosscompiler on linux
- GTK3-debian-frankenvice.md, instructions on how to set up a windows
crosscompiler on debian using precompiled fedora mingw packages
- GTK3-Fedora-cross-build-setup.md, (incomplete) instructions on how to
set up a windows crosscompiler on Fedora linux
- Linux-GTK3-Howto.txt, how to compile the GTK3 port on Linux
- macOS-Distribution-Howto.txt, how to build the macOS binary distribution
- macOS-Howto.txt, how to build on macOS (might be deprecated)
- macOS-Xcode-Howto.txt, how to build the macOS port(s) using Xcode
- NetBSD-Gtk3-Wowto.txt, hints on compiling for NetBSD with Gtk3
- NetBSD-howto.txt, hints on compiling for NetBSD
- SDL-Howto.txt, how to compile the SDL port on various platforms
- Windows-MinGW-GTK3-Howto.txt, how to compile the Windows port using
MingGW/MSYS2
For the latest news, have a look at the VICE home page:
http://vice-emu.sourceforge.net/
Also some information that was previously included in the distribution has been
moved into our wiki at sourceforge:
- The TODO list,
http://vice-emu.sourceforge.net/wiki/index.php/Todo#New_Features
- The list of known BUGS,
http://vice-emu.sourceforge.net/wiki/index.php/Todo#Known_Issues
New versions are made available usually once per year, so please stay tuned.
You may also check out the automatic nightly builds, which are kindly provided
by the pokefinder crew: https://vice.pokefinder.org/
Have fun!
Feedback
--------
It's always nice to receive feedback and/or bugreports about VICE, but please
read these few notes before sending mail to anybody in the team.
- Please don't send any HTML mail (we really hate that!). Please make sure
you turn off the "rich text" (HTML) feature.
- Please don't send any binaries without asking first.
- Please read the following documents carefully before reporting a bug or a
problem you cannot solve:
- the VICE documentation (you should have received it with the main
distribution--if not, tell us);
Online version - http://vice-emu.sourceforge.net/vice_toc.html
- the VICE wiki at http://vice-emu.pokefinder.org/
- Before reporting a bug, please try a recent nightly build and check if your
issue is already fixed. You can fine nightly builds for windows here:
<SF-uploads via Travis-CI?>
- When you report a bug, please try to be as accurate as possible and describe
how it can be reproduced to the very detail. You should also tell us what
machine you are running on, what operating system you are using as well as
the version of Vice.
- Please don't ask us how to transfer original C64 disk or tapes to your PC. To
transfer disks, you can use the Star Commander (http://sta.c64.org/sc.html).
- Please don't ask us where to find games for the emulator on the Internet.
- Please don't ask us when the next version will be out, because we really
don't know. We are trying to make at least one release per year, around
christmas.
- Please write in English.
In any case, we would be really glad to receive your comments about VICE.
The central place for bug reports is the bug tracker at sourceforge:
https://sourceforge.net/p/vice-emu/bugs/
At sourceforge you can also submit feature requests:
https://sourceforge.net/p/vice-emu/feature-requests/
The email address for feedback is: vice-emu-mail@lists.sourceforge.net
Thanks!
Copyright notice
----------------
VICE, the Versatile Commodore Emulator
Core Team Members:
1999-2022 Martin Pottendorfer
2005-2022 Marco van den Heuvel
2007-2022 Fabrizio Gennari
2009-2022 Groepaz
2009-2022 Errol Smith
2009-2022 Ingo Korb
2010-2022 Olaf Seibert
2011-2022 Marcus Sutton
2011-2022 Kajtar Zsolt
2016-2022 AreaScout
2016-2022 Bas Wassink
2017-2022 Michael C. Martin
2018-2022 Christopher Phillips
2019-2022 David Hogan
2020-2022 Empathic Qubit
2020-2022 Roberto Muscedere
2021-2022 June Tate-Gans
2021-2022 Pablo Roldan
Inactive/Ex Team Members:
2011-2016 Stefan Haubenthal
2015-2016 BSzili
1999-2016 Andreas Matthies
2007-2015 Daniel Kahlin
2012-2014 Benjamin 'BeRo' Rosseaux
2011-2014 Ulrich Schulz
2011-2014 Thomas Giesel
2008-2014 Antti S. Lankila
2006-2014 Christian Vogelgsang
1998-2014 Dag Lem
2000-2011 Spiro Trikaliotis
2007-2011 Hannu Nuotio
1998-2010 Andreas Boose
1998-2010 Tibor Biczo
2007-2010 M. Kiesel
1999-2007 Andreas Dehmel
2003-2005 David Hansel
2000-2004 Markus Brenner
1999-2004 Thomas Bretz
1997-2001 Daniel Sladic
1996-2001 André Fachat
1996-1999 Ettore Perazzoli
1993-1994, 1997-1999 Teemu Rantanen
1993-1996 Jouko Valta
1993-1994 Jarkko Sonninen
Translation Team Members:
2009-2017 Mikkel Holm Olsen
2000-2017 Martin Pottendorfer
2011-2017 Manuel Antonio Rodriguez Bas
2004-2017 Paul Dubé
2006-2017 Czirkos Zoltan
2006-2017 Karai Csaba
2001-2017 Andrea Musuruane
2011-2016 Jesse Lee
2005-2017 Marco van den Heuvel
2011-2017 Jarek Sobolewski
2010-2017 Michael Litvinov
2000-2017 Peter Krefting
2008-2017 Emir Akaydin
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA
The ROM files in the `C128', `C64', `CBM-II', `DRIVES', `PET', `PLUS4'
`PRINTER' and `VIC20' directories are Copyright C by Commodore
Business Machines.
The ROM files in the `C64DTV` directory are Copyright C by Commodore
Business Machines, as well as Mammoth Toys, a division of nsi ltd.,
Digital Concepts DC studios inc., Ironstone Partners ltd., and
Toy:Lobster company ltd.