From 7a813b2161441c353ba6e2966d1c88fbb5a1fc6e Mon Sep 17 00:00:00 2001
From: Michael Stapelberg <michael@stapelberg.de>
Date: Sun, 24 Sep 2017 15:56:40 +0200
Subject: [PATCH] Add README.md

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fe5591b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+## Emulator
+
+### Emulator installation
+
+On Debian and derivatives, install the `vice` package:
+
+```
+apt install vice
+```
+
+Install `/usr/lib/vice/C128/kernal*` and `/usr/lib/vice/C128/charg*` (ask contributors for a copy).
+
+### Emulator configuration
+
+Enable the following options in x128:
+* Settings → Drive settings → drive #8 options → enable IEC device
+* Settings → Printer settings → Printer #4 enable IEC device
+* Settings → Printer settings → Printer #4 emulation → File system access
+
+Alternatively, configure the following values in `~/.vice/vicerc` (which you
+can create by selecting the menu entry “Settings” → “Save settings”):
+```
+IECDevice4=1
+IECDevice8=1
+Printer4=1
+```
+
+### Running the emulator
+
+```
+x128 -autostart kasse.d64
+```
+
+## Reading files from the floppy (disk image)
+
+To view the contents of a file within a disk image (e.g. the logfile), use:
+
+```
+c1541 -attach kasse.d64 -read "log-2" >(petcat -nh) >&-
+```
-- 
2.39.5