Describe this project

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..9fcc803
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# Tattlekey
+
+This is a one-key WiFi UDP 'keyboard'.
+
+The hardware is a Raspberry Pi Pico in a 3d-printed shell connected to
+a Cherry MX switch.
+
+The client software that runs on the device connects to a WiFi network
+and sends UDP packets to an address specified in `client/config.c`.
+It transmits each keypress several times for reliability, with relative
+timestamps so the server can determine the time of every press without
+the device needing to synchronize a clock.
+
+The server software collects and de-duplicates keypress reports.