2 files changed, 30 insertions, 4 deletions

diff --git a/README.md b/README.md
index 03613f15..c1b9aa7d 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Lagrange — A Beautiful Gemini Client
+# Lagrange
 
 Lagrange is a desktop GUI client for browsing Geminispace. It offers modern conveniences familiar from web browsers, such as smooth scrolling, inline image viewing, multiple tabs, visual themes, Unicode fonts, bookmarks, history, and page outlines.
 
@@ -8,11 +8,37 @@ Like Gemini, Lagrange has been designed with minimalism in mind. It depends on a
 
 ## Features
 
-
+* Beautiful typography using Unicode fonts
+* Autogenerated page style and Unicode icon for each Gemini domain
+* Smart suggestions when typing the URL — search bookmarks, history, identities
+* Sidebar for page outline, managing bookmarks and identities, and viewing history
+* Multiple tabs
+* Identity management — create and use TLS client certificates
+* And more! Open `about:help` in the app, or see [help.gmi](https://git.skyjake.fi/skyjake/lagrange/raw/branch/release/res/about/help.gmi)
 
 ## Downloads
 
-Binaries for Windows and macOS and a source tarball can be found in [Releases](https://git.skyjake.fi/skyjake/lagrange/releases).
+Prebuilt binaries for Windows and macOS can be found in [Releases][rel].
+
+## How to compile
+
+This is how to build Lagrange in a Unix-like environment. The required tools are a C11 compiler (e.g., Clang or GCC), CMake and `pkg-config`.
+
+1. Download and extract a source tarball from [Releases][rel]. (If you just clone this Git repository, [the_Foundation][tf] is expected to be already available on the system.)
+2. Check that you have the dependencies installed: SDL2, OpenSSL, libpcre, zlib, libunistring. For example, on Homebrew this would do the trick: ```brew install sdl2 openssl@1.1 pcre libunistring``` Or on Ubuntu: ```sudo apt install libsdl2-dev libssl-dev libpcre3-dev zlib1g-dev libunistring-dev```
+3. Create a build directory.
+4. In your empty build directory, run CMake: ```cmake {path_of_lagrange_sources}```
+5. Built it: ```cmake --build .```
+6. Now you can run `lagrange`, `lagrange.exe`, or `Lagrange.app`.
+
+## Installing to a directory
+
+To install to "/dest/path":
+
+1. `cmake {path_of_lagrange_sources} -DCMAKE_INSTALL_PREFIX=/dest/path`
+2. `cmake --build . --target install`
 
-## Build instructions
+This will also install an XDG .desktop file for launching the app.
 
+[rel]: https://git.skyjake.fi/skyjake/lagrange/releases
+[tf]:  https://git.skyjake.fi/skyjake/the_Foundation
diff --git a/lagrange_about.png b/lagrange_about.png
index 52ddd7e4..d342262b 100644
--- a/lagrange_about.png
+++ b/lagrange_about.png