diff --git a/README b/README
deleted file mode 100644
index 2587c41..0000000
--- a/README
+++ /dev/null
@@ -1,63 +0,0 @@
-Vinace - VINtage Apple Computer Emulator
-========================================
-
-Requirements
-------------
-
-Vinace needs gtkmm-2.4 and libpulse0 packages to be installed.
-
-Vinace needs ROM image which are copyrighted and which can not be distributed with Vinace.
-
-Current version uses file named APPLE2E.ROM contained in zip file located at :
-ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/apple_iie_rom.zip
-
-How to test Vinace ?
---------------------
-
-If you want to build it from source :
-
-1 - Download the source
-2 - Enter trunk directory
-3 - ./configure
-4 - make
-5 - Enter src/gui directory
-6 - Copy ROM file APPLE2E.ROM into this directory
-7 - ./vinace
-
-If you don't want to build it from source but still want to try it :
-
-1 - Download the binary
-2 - tar xvf vinace.gz
-3 - Enter the vinace directory
-4 - Copy ROM file APPLE2E.ROM into this directory
-5 - ./vinace
-
-If you don't want to try it, get back to the dull 64 bits world.
-
-Inside Vinace
--------------
-
-Now you should see a color screen and two disk drives.
-
-Use the keyboard to type text in. The special keys are :
-
-On your machine             On the emulated Apple
--------------------------------------------------------------
-Ctrl-Break or Ctrl-Pause    Ctrl-Reset
-Left Alt                    Open Apple (joystick button 0)
-Right Alt                   Closed Apple (joystick button 1)
-
-You can issue a first Ctrl-Break to try Applesoft basic. And of course, a 
-Alt-Ctrl-Break will restart the computer (the Apple, not your actual computer).
-
-If you want to use floppy disks, you can go to 
-ftp://ftp.apple.asimov.net/pub/apple_II/images
-
-Vinace accept any file but works only with .dsk and .do files (DOS ordered disk
-images). To insert a disk, just drag the file onto the disk drive 1. The lid 
-should automatically close. Then restart with a Alt-Ctrl-Break.
-
-Disk drives are emulated with the same original speed which is quite... slow.
-
-You can look if something is happening on the terminal output (look after 
-drive's head position changing, which means that the program is still alive).
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a67074e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,81 @@
+# Vinace - VINtage Apple Computer Emulator
+
+## Requirements
+
+Vinace needs gtkmm-2.4 and libpulse to be installed.
+
+On Ubuntu :
+```
+apt install libgtkmm-2.4-dev libpulse-dev
+```
+
+## How to build
+```
+git clone https://github.com/pyrollo/vinace
+cd vinace
+cmake .
+```
+
+## Fetch ROMs
+
+Vinace needs ROM images which are copyrighted and which can not be
+distributed with Vinace.
+
+To run vinace, ROM files have to be fetched from
+[https://ftp.apple.asimov.net/emulators/rom_images](https://ftp.apple.asimov.net/emulators/rom_images).
+Current version uses
+[APPLE2E.ROM](https://ftp.apple.asimov.net/emulators/rom_images/apple_iie_rom.zip)
+file.
+
+```
+cd roms
+wget ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/apple_iie_rom.zip
+unzip apple_iie_rom.zip
+cd ..
+```
+
+## Play
+
+From ``vinace`` directory, launch:
+
+```
+bin/vinace
+```
+
+## Inside Vinace
+
+Now you should see a color screen and two disk drives. If ROM file is
+present, screen should display "Apple //e" and floppy drive #1 should
+be on.
+
+Emulated Apple //e is waiting for you to insert a disk. To do it so,
+drag and drop a .DSK file onto drive 1. Such files could be found at
+[https://ftp.apple.asimov.net/images/](https://ftp.apple.asimov.net/images/).
+
+Issue a Ctrl-Break or Ctrl-Pause if you want to try Applesoft basic
+instead of inserting a disk.
+
+### Keyboard
+
+Use the keyboard to type text in. The special keys are :
+
+On your machine           | On the emulated Apple
+--------------------------|----------------------------------
+Ctrl-Break or Ctrl-Pause  | Ctrl-Reset
+Left Alt                  | Open Apple (joystick button 0)
+Right Alt (or AltGr)      | Closed Apple (joystick button 1)
+
+
+### Floppy disks
+
+Vinace accept any file but works only with .dsk and .do files (DOS
+ordered disk images). To insert a disk, just drag the file onto the disk
+drive 1. The lid should automatically close. Then restart with a
+Alt-Ctrl-Break.
+
+Disk drives are emulated with the same original speed which is quite...
+slow.
+
+You can look if something is happening on the terminal output (look
+after drive's head position changing, which means that the program
+is still alive).