Add a readme for the floppicator

README.md

@@ -1,2 +1,58 @@
-# TK2000_floppicator
+# The FLOPPICATOR
 
+## DISCLAIMER
+
+Any use of this project is **under your own responsibility**.
+By using this project You will agree that I cannot be held responsible if it will destroy any of your devices, damage your computer, burn down your house or whatever.
+
+## Introduction
+
+
+I recently built myself a Microdigital TK2000 clone [I recently built for myself](https://github.com/hkzlab/TK2000_Build_Notes).
+This clone is almost-but-not-really Apple II compatible, and most low level software (like floppy duplicators) fail to work correctly (or at all).
+
+The only original TK2000 software I have available to handle copying from one floppy to another, is meant for the original TK2000 disk interface, which
+supported only a single drive. This poses a problem when I want to copy something from my FloppyEMU to a real floppy.
+
+I could setup a greaseweazle, but... sometimes I'm lazy.
+
+So I developed a simple copier that takes all the sector data from the disk in the primary drive and copies it to the secondary.
+
+Note that this supports DOS 3.3 sector structure only, and **the destination disk must be formatted beforehand**.
+
+### Support
+
+If you wish to support me in building new hardware and software for old machines, [throw a few euros in my direction via Ko-Fi](https://ko-fi.com/hkzlab) ☕!
+
+### Current state
+
+It works. It will copy the content of a DOS 3.3 based disk from the primary drive to the secondary, 7 tracks at a time, and then verify what was written via CRC8.
+
+It's a bit slow (takes roughly 6 minutes including data verification), but You're not going to run a disk mastering business with this, right?
+
+## How to play
+
+Start with a floppy containing the FLOPPICATOR. Once you get to the initial screen, remove the FLOPPICATOR disk, put in what you want to copy, then insert the destination in the secondary drive.
+
+Then push a button.
+
+Then wait.
+
+Once it finishes, you can repeat the procedure as many times as you want.
+
+### Floppy version
+
+Just put your floppy in the first drive and power on the TK2000. It will autoboot.
+
+## How to build
+
+You need the following:
+
+- GNU Make (I used the one provides by [MSYS2](https://www.msys2.org/))
+- [Calypsi 6502 toolchain](https://www.calypsi.cc/) (tested with 5.10)
+- [AppleCommander](https://github.com/AppleCommander/AppleCommander), "ac" command line version (tested with 1.9.0)
+- [dsk2woz](https://github.com/TomHarte/dsk2woz)
+
+## The future
+
+What future?