Add README

README.md

@@ -0,0 +1,59 @@
+# Rupert
+
+*Rupert the Ripper* is a command-line tool for ripping audio CDs.
+
+
+## Prerequisites
+
+
+You must have direct read/write access to your CD-ROM block device.  On Fedora,
+this can be achieved by adding your user to the *disk* group:
+
+```
+sudo gpasswd -a ${USER} disk
+```
+
+You will need to log out and back in for this change to take effect.
+
+
+## Installation
+
+### System Dependencies
+
+#### Fedora
+
+```
+sudo dnf install \
+    cdparanoia \
+    flac \
+    libdiscid-devel \
+    poetry \
+    python3-devel \
+    --
+```
+
+### Install *Rupert*
+
+
+There are no published releases of *Rupert* yet, so you will need to install it
+from a `git` checkout:
+
+```
+git clone https://git.pyrocufflink.blue/dustin/rupert.git
+cd rupert
+poetry install -E udev
+```
+
+The *udev* extra enables support for identifying CD drives using udev.  This
+allows Rupert to find your drive and select the correct offset automatically.
+
+
+## Usage
+
+The `ripper` command is the main entry point for *Rupert*.  If you installed
+using `poetry`, you can run it with `poetry run ripper`.
+
+
+```
+poetry run ripper --help
+```