The VICE Emulator

## (19 Dec 2008) Version 2.1

#### Current VICE team members: Andreas Boose, Tibor Biczo, Dag Lem, Andreas Dehmel, Andreas Matthies, Martin Pottendorfer, Spiro Trikaliotis, David Hansel, Markus Brenner, Marco van den Heuvel, Christian Vogelgsang, Fabrizio Gennari, M. Kiesel, Hannu Nuotio, Daniel Kahlin.

# Quickfinder

- What is VICE?

- What is NEW with the 2.1 release? (This is definitely worth reading `:-)`

- The VICE Manuals online
- ...and the rest of the Docs.
- Please send a bug report via email to one of the addresses listed in the contact section. The list of already known BUGS is also available.
- What we are about TODO with it...
- Developers
- Download VICE
- Here you can find related resources.
- You might want to have a look at some screenshots of VICE on various supported platforms.
- Copyright - GNU Copyleft
- Contacts

Unfortunately we no longer have the time to maintain a FAQ or other extra documents. The old version of the FAQ is already quite outdated.
Anyway, we started setting up a new FAQ which can be found at the VICE knowledge base.

Anyway, we probably need more help to keep all things going, so here is the usual call for volunteers... `;-)` If you like to join our group, and help us in any way , please send a mail to vice-devel@firenze.linux.it.

# What is VICE?

VICE is a program that runs on a Unix, MS-DOS, Win32, OS/2, Acorn RISC OS, BeOS, QNX 4.x, QNX 6.x, Amiga, GP2X, SkyOS or Mac OS X machine and executes programs intended for the old 8-bit computers. The current version emulates the C64, the C64DTV, the C128, the VIC20, almost all PET models, the PLUS4 and the CBM-II (aka C610).

If you have any comments or bug reports, please contact us at one of the addresses given below.

VICE is under constant change. Anyone interested in helping development of VICE is welcome. Please contact us to avoid doing something that someone else has done already. `(-:`

Of course our warm thanks go to everyone who has helped us in developing VICE during these past few years.

## Documents

Here are some documents that come with VICE:

- 64doc.txt contains the CPU instruction set and more on the C64
- PETdoc.txt contains PET information
- cbm_basic_tokens.txt is a listing of BASIC token values.
- drive_info.txt has CBM disk drive stuff
- serial.txt is an explanation of the serial IEC bus
- Walkthrough-Howto.txt is a guide explaining VICE's event history feature

# Copyright

    The VICE is copyrighted to Andreas Boose, Tibor Biczo, Dag Lem,
    Andreas Dehmel, Andreas Matthies, Martin Pottendorfer, Spiro Trikaliotis,
    Marco van den Heuvel, Christian Vogelgsang, Fabrizio Gennari,
    Markus Brenner, David Hansel, Thomas Bretz, Daniel Sladic, Ettore Perazzoli,
    André Fachat, Teemu Rantanen, Jouko Valta, Jarkko Sonninen.

    VICE 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.

    VICE 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.

## Download VICE

You can download the latest VICE distributions here. Some ports may not be available at the release date.

- Source distributions:

- Tarball: vice-2.1.tar.gz

- New binary distributions:

- Binary for MS-DOS (Pentium-optimized): vice21.zip
Please use the '-d' option if you are using pkzip, to unpack the archive with the full directory tree.
- Binary for MS-Windows 32bit (Pentium-optimized): WinVICE-2.1.zip
- Binary for Acorn RISC OS systems: vice-riscos2_1.zip
- Binary for BeOS systems: Please visit the BeOS download page.
- Binary for QNX systems: Please visit the QNX download page.
- Binary for OS/2 systems: vice2-2.1.zip.
- Binary for Solaris systems: Please visit the Solaris download page.
- Binary for SCO based systems: Please visit the SCO download page.
- Binary for Amiga based or derived systems: Please visit the Amiga download page.
- Binary for Mac OS X systems: Please visit the Mac OS X download page.
- Binary for GP2X systems: vice-gp2x-2.1.zip
- Binary for SkyOS systems: VICE-2.1.pkg
- Binary for Minix 3.x systems: vice-minix-2.1.tar.bz2
- Binary for Atari Mint systems: vice-2.1-1.m68kmint.rpm

- Old binary distributions:

- Binary for MS-DOS (Pentium-optimized): vice20.zip
Please use the '-d' option if you are using pkzip, to unpack the archive with the full directory tree.
- Binary for MS-Windows 32bit (Pentium-optimized): WinVICE-2.0.zip
- Binary for Acorn RISC OS systems: vice-riscos2_0.zip
- Binary for BeOS systems: Please visit the BeOS download page.
- Binary for QNX systems: Please visit the QNX download page.
- Binary for OS/2 systems: vice2-2.0.zip.
- Binary for Solaris systems: Please visit the Solaris download page.
- Binary for SCO based systems: Please visit the SCO download page.
- Binary for HPUX based systems: Please visit the HPUX download page.
- Binary for Amiga based or derived systems: Please visit the Amiga download page.
- Binary for Mac OS X systems: Please visit the Mac OS X download page.
- Binary for GP2X systems: vice-gp2x-2.0.zip
- Binary for SkyOS systems: VICE-2.0.pkg
- Binary for Minix 3.x systems: vice-minix-2.0.tar.bz2
- Binary for Atari Mint systems: vice-2.0-1.m68kmint.rpm

The files are taken from http://www.zimmers.net/anonftp/pub/cbm/crossplatform/emulators/VICE.

# Related resources

- General

- Walkthrough for Fort Apocalypse: Download

- VICE Printer Output to Postscript (VICEtoPS): Homepage

- Patch for VICE 2.0 to make the new PAL emulation work on gtk+: Download

- Patch for VICE 2.0 to fix the gtk+ UI for big endian platforms: Download

- Patch for VICE 2.0 to make the Mac OS X ports compile for Mac OS X 10.4 (and up) on Mac OS X 10.5: Download

- Patch for VICE 1.14 to fix crash on 64bit architectures: Download

- MS-Windows

- CBM4Win driver and OpenCBM library: Homepage

- Parallel port joystick driver for MS-Windows 2000/XP/98/Me: Homepage

- Precompiled FFMPEG video/audio codec library for MS-Windows: Download

- Linux

- CBM4Linux kernel driver and OpenCBM library: Homepage

- FFMPEG video/audio codec library: Homepage

- Experimental Gnome2/Gtk2 patch for VICE 1.19: Download

- BeOS

- Patch to compile VICE 1.20: Download

# Contacts

VICE has moved its source repository to public services provided by SourceForge. You can find it at http://sf.net/projects/vice-emu. We like to thank the SourceForge staff for that help.

Before contacting us, have a look at the VICE knowledge base if your question is answered there. Keep in mind that we work on VICE in our spare-time, so the more time we don't need to answer the same questions over and over again, the more time we have to improve the emulation itself. On the other hand, that does not mean that you should not contact us, especially if you find bugs or have suggestions which might improve the emulation.

- Bug reports, suggestions, support requests should be directed to the SourceForge trackers at http://sourceforge.net/tracker/?group_id=223021. This way, you, the users, and we, the developers, can track what has been reported and what has been already fixed. Ideally, also sent the report to the mailing address of the Vice team at (vice-devel@firenze.linux.it).

Please put the word `VICE` in all capitals in your subject line (e.g. `VICE fails to run game XXX`). This helps mail splitting and reduces chances that your message is unintentionally deleted, forgotten or lost.