diff --git a/usage.md b/readme.md
similarity index 86%
rename from usage.md
rename to readme.md
index fd3f9f9..8f1012c 100644
--- a/usage.md
+++ b/readme.md
@@ -1,3 +1,15 @@
+# bbn
+
+A bare-bones note-taking app written in php.
+No javascript.
+
+## Install
+
+* Upload the files on a php server.
+* Edit settings.php.sample.php and rename it to settings.php.
+
+## Usage
+
 | Home page              | action with param        | action with empty param       | hotkey |
 |------------------------|--------------------------|-------------------------------|--------|
 | search (default action)| full text search         | reload home                   | alt-s  |