diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c1ecfc4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+This repo contains code and specs for my personal infrastructure.
+
+There is a centralized action runner tool 'ydeployer', which is accessible
+from `nix develop` or using `direnv` (or using `nix run`).
+
+# Computers
+Configuration for all x86/arm systems is stored in [./nixos](). Specs are available in [./nixos/README.md]()
+
+# bin
+Assorted scripts in various states of deprecation.
+
+# deployer
+Deployment tool, written in typescript.
+
+# emacs
+.org files making up my daily editor configuration.
+
+# esphome
+Contains yaml configuration for esphome esp32 nodes.
+
+# home-manager
+nix configuration for my user profile on my desktop and laptops. Contains list of installed user-space programs.
+
+# pkgs
+Collection of nix files for packages that are not in nixpkgs, or patches for them.
+
+# secrets
+Secrets encrypted using agenix.
+
diff --git a/nixos/README.md b/nixos/README.md
index c7e76ef..8352e81 100644
--- a/nixos/README.md
+++ b/nixos/README.md
@@ -1,25 +1,42 @@
-My nixos configurations.
-
+This directory contains Nix code to deploy all of my machines. The main way to use this is via `ydeployer`.
 
 Systems
 =======
 
+[blackadder](https://en.wikipedia.org/wiki/Edmund_Blackadder#Edmund_Blackadder_Esq._(Regency_Britain))
+--------
+
+Desktop [workstation](./roles/workstation.nix).
+ryzen 9 3950x (RAM: 64GB, storage: 1TB ssd, 16 cores + hyperthreading)
+
+There is a [list of components](https://tweakers.net/gallery/468325/inventaris/?inv_id=2583112) on tweakers.
+
+
+- Main desktop with two 2560x1440 27" screens.
+- It has a camera (sony alpha 6000) mounted on top of the left screen using a [smallrig super clamp](https://www.amazon.nl/-/en/gp/product/B08B63WXWN/).
+- It has a Tobii Eye Tracker 4c attached to the left screen.
+
+
 [frumar](https://en.wikipedia.org/wiki/Frumar)
 --------
 
-Physical [server](./roles/server.nix). Mostly used for files. (storage: 30 TB hdd + 256GB ssd, RAM: 16GB, 2 cores ht)
+Physical NAS [server](./roles/homeserver.nix). Mostly used for files. (storage: 30 TB hdd + 256GB ssd, RAM: 64GB, 4 cpu cores). As of 2022-04-09, there is 12TB usable storage remaining.
+
+There is a [list of components](https://tweakers.net/gallery/468325/inventaris/?inv_id=459811) on tweakers.
 
 - prometheus
 - grafana
 - rabbitmq
-- torrents
+- torrent client
 - plex
+- home-assistant
+- unifi controller
 
 [pennyworth](https://en.wikipedia.org/wiki/Alfred_Pennyworth)
 ----------
 
 [Server](./roles/server.nix).
-Hetzner cloud VPS (Storage: 20GB, RAM: 2GB, 1 core)
+Hetzner [CX11](https://www.hetzner.com/cloud) cloud VPS (Storage: 20GB, RAM: 2GB, 1 core)
 
 - [website](./services/website.nix)
 - [email](./services/mail.nix)
@@ -31,25 +48,15 @@ Hetzner cloud VPS (Storage: 20GB, RAM: 2GB, 1 core)
 --------
 
 [workstation](./roles/workstation.nix).
-dell xps 13 (RAM: 16GB, storage: 512GB ssd, 2 cores ht)
+dell xps 13 (RAM: 16GB, storage: 512GB ssd, 2 cores + hyperthreading)
 
-
-[blackadder](https://en.wikipedia.org/wiki/Edmund_Blackadder#Edmund_Blackadder_Esq._(Regency_Britain))
+smithers
 --------
-
 [workstation](./roles/workstation.nix).
-https://tweakers.net/productcollectie/wijzig/2583112/
-ryzen 9 (RAM: 64GB, storage: 1TB ssd, 16 cores ht)
 
-Maintenance
-===========
+Main laptop.
 
-Generating tor keys:
+thinkpad x1 carbon (gen 9) (RAM: 24GB, storage: 256GB ssd, 4 cores + hyperthreading)
 
-```
-$(nix-build packages/shallot.nix --no-out-link)/bin/shallot -f tmp ^PATTERN
-head -n3 tmp
-tail -n +4 tmp > keys/ssh.HOSTNAME.key
-shred tmp && rm tmp
+Property of Tweag.
 
-```