1The Free Unix Spectrum Emulator (Fuse) 1.1.1
2============================================
3
4Fuse (the Free Unix Spectrum Emulator) was originally, and somewhat
5unsurprisingly, an emulator of the ZX Spectrum (a popular 1980s home
6computer, especially in the UK) for Unix. However, it has now also
7been ported to Mac OS X, which may or may not count as a Unix variant
8depending on your advocacy position and Windows which definitely isn't
9a Unix variant. Fuse also emulates some of the better-known ZX Spectrum
10clones as well.
11
12What Fuse does have:
13
14* Accurate Spectrum 16K/48K/128K/+2/+2A/+3 emulation.
15* Working Spectrum +3e and SE, Timex TC2048, TC2068 and TS2068,
16 Pentagon 128, "512" (Pentagon 128 with extra memory) and 1024 and
17 Scorpion ZS 256 emulation.
18* Runs at true Speccy speed on any computer you're likely to try it on.
19* Support for loading from .tzx files, including accelerated loading.
20* Sound (on systems supporting the Open Sound System, SDL, or OpenBSD/
21 Solaris's /dev/audio).
22* Emulation of most of the common joysticks used on the Spectrum
23 (including Kempston, Sinclair and Cursor joysticks).
24* Emulation of some of the printers you could attach to a Spectrum.
25* Support for the RZX input recording file format, including
26 rollback and 'competition mode'.
27* Emulation of the DivIDE, Interface 1, Kempston mouse, Spectrum +3e,
28 ZXATASP, ZXCF, Beta 128, Opus Discovery, +D and DISCiPLE interfaces.
29
30Help! <xyz> doesn't work
31------------------------
32
33If you're having a problem using/running/building Fuse, the two places
34you're most likely to get help are the development mailing list
35<fuse-emulator-devel@lists.sf.net> or the official forums at
36<http://sourceforge.net/p/fuse-emulator/discussion/>.
37
38What you'll need to run Fuse
39----------------------------
40
41Unix, Linux, BSD, etc.
42
43Required:
44
45* X, SDL, svgalib or framebuffer support. If you have GTK+, you'll get
46 a (much) nicer user interface under X.
47* libspectrum: this is available from
48 http://fuse-emulator.sourceforge.net/libspectrum.php
49
50Optional:
51
52* Other libraries will give you some extended functionality:
53 * libgcrypt: the ability to digitally sign input recordings (note that
54 Fuse requires version 1.1.42 or later).
55 * libpng: the ability to save screenshots
56 * libxml2: the ability to load and save Fuse's current configuration
57 * zlib: support for compressed RZX files
58
59If you've used Fuse prior to version 0.5.0, note that the external
60utilities (tzxlist, etc) are now available separately from Fuse
61itself. See http://fuse-emulator.sourceforge.net/ for details.
62
63Mac OS X
64
65* Either the native port by Fredrick Meunier, or the original version
66 will compile on OS X 10.3 (Panther) or later.
67* On Mac OS X Lion you will need to use clang as gcc-llvm-4.2.1 fails to
68 correctly compile z80_ops.c.
69
70Windows
71
72* The Win32 and SDL UIs can be used under Windows.
73* pthreads-win32 library will give the ability to use posix threads, needed by
74 some peripherals.
75
76Building Fuse
77-------------
78
79See the file `INSTALL' for more detailed information.
80
81Closing comments
82----------------
83
84Fuse has its own home page, which you can find at:
85
86http://fuse-emulator.sourceforge.net/
87
88and contains much of the information listed here.
89
90News of new versions of Fuse (and other important Fuse-related
91announcements) are distributed via the fuse-emulator-announce mailing
92list on SourceForge; see
93http://lists.sourceforge.net/lists/listinfo/fuse-emulator-announce
94for details on how to subscribe and the like.
95
96If you've got any bug reports, suggestions or the like for Fuse, or
97just want to get involved in the development, this is coordinated via
98the fuse-emulator-devel mailing list,
99http://lists.sourceforge.net/lists/listinfo/fuse-emulator-devel
100and the Fuse project page on SourceForge,
101http://sourceforge.net/projects/fuse-emulator/
102
103For Spectrum discussions not directly related to Fuse, visit either the
104Usenet newsgroup `comp.sys.sinclair' or the World of Spectrum forums
105<http://www.worldofspectrum.org/forums/>.
106
107Philip Kendall <philip-fuse@shadowmagic.org.uk>
10824th May, 2013
109
110$Id: README 4995 2013-05-24 19:54:19Z zubzero $
111