diff --git a/imgs/add.png b/imgs/add.png
new file mode 100644
index 0000000..8ba909f
Binary files /dev/null and b/imgs/add.png differ
diff --git a/imgs/cards.png b/imgs/cards.png
new file mode 100644
index 0000000..f92cfbe
Binary files /dev/null and b/imgs/cards.png differ
diff --git a/imgs/set.png b/imgs/set.png
new file mode 100644
index 0000000..2efbeae
Binary files /dev/null and b/imgs/set.png differ
diff --git a/imgs/sets.png b/imgs/sets.png
new file mode 100644
index 0000000..4cc84cc
Binary files /dev/null and b/imgs/sets.png differ
diff --git a/imgs/stats.png b/imgs/stats.png
new file mode 100644
index 0000000..9f1ce3f
Binary files /dev/null and b/imgs/stats.png differ
diff --git a/imgs/tops.png b/imgs/tops.png
new file mode 100644
index 0000000..34fa31f
Binary files /dev/null and b/imgs/tops.png differ
diff --git a/readme.md b/readme.md
index a3cd59a..8c265f0 100644
--- a/readme.md
+++ b/readme.md
@@ -1,5 +1,87 @@
 # serra
 
+Serra is my personal Magic: The Gathering collection tool.
+It uses a MongoDB and [Scryfall](https://scryfall.com).
+
+## What Serra does
+
+* tracks prices
+* calculates statistics
+* shows what cards/sets do best in value development.
+
+## What Serra does not
+
+* Does not give a shit about conditions (NM, M, GD...)
+* Does not track if card is foil or not (may come in the future)
+* Its not configurable to have Dollar/US Prices
+
+# Quickstart
+
+Spin up a MongoDB (you can use docker-compose)
+
+    docker-compose up -d
+
+Add a card
+
+    ./serra add usg/17
+
+Start exploring :) (the more cards you add, the more fun it is)
+
+# Usage
+
+```
+./serra
+Usage:
+  serra add <cardid>... [--count=<number>]
+  serra remove <cardid>...
+  serra cards [--rarity=<rarity>] [--set=<setcode>] [--sort=<sort>]
+  serra card <cardid>...
+  serra tops [--limit=<limit>]
+  serra flops [--limit=<limit>]
+  serra missing <setcode>
+  serra set <setcode>
+  serra sets
+  serra update
+  serra stats
+```
+
+## Add
+
+To add a card to your collection
+
+![](https://github.com/noqqe/noqqe.de/blob/main/imgs/add.png
+
+## Cards
+
+Query all of your cards with filters
+![](https://github.com/noqqe/noqqe.de/blob/main/imgs/cards.png
+
+## Sets
+List all your sets
+
+![](https://github.com/noqqe/noqqe.de/blob/main/imgs/sets.png
+
+## Set
+
+Show details of a single set
+![](https://github.com/noqqe/noqqe.de/blob/main/imgs/set.png
+
+## Stats
+
+Calculate some stats for all of your cards
+![](https://github.com/noqqe/noqqe.de/blob/main/imgs/stats.png
+
+## Tops
+
+Show what cards/se gained most value
+![](https://github.com/noqqe/noqqe.de/blob/main/imgs/tops.png
+
+## Update
+
+The update mechanism iterates over each card in your collection and fetches
+its price. After all cards you own in a set are updated, the set value will
+update. After all Sets are updated, the whole collection value is updated.
+
 # Install
 
     go build .
@@ -11,14 +93,10 @@
 * calculate biggest gaining cards (Up XX %!)
 * display (+/-) % in sets overview
 * display (+/-) % in history views
+* Reserved List
+* Mythic
 
-
-# What its not
-
-* Gives a shit about conditions (NM, M, GD...)
-* If the card is foil
-
-# Cheatsheet
+# Cheatsheet Queries
 
 Find cards that increased prices
 
@@ -49,6 +127,9 @@ Calculate what cards gained most value in percent
 
 # MongoDB Operations
 
+A few commands that do backups and exports of your data inside of the docker
+container.
+
 Do a database dump
 
     mongodump  -u root -p root --authenticationDatabase admin -d serra -o /backup/