diff --git a/README.md b/README.md
index cbf1ae2..009bf40 100644
--- a/README.md
+++ b/README.md
@@ -1,13 +1,38 @@
 # bwzy - bitwarden ... fuzzy
 
-Why? I live in the terminal and wanted a way to get to passwords there. The `bw` cli is great, but not very user-friendly.
+bwzy is a fuzzy finder for Bitwarden using the official bitwarden cli.
 
-# features
+The `bw` cli is great, but not very user-friendly.
+
+`bwzy` tries to make this quicker by caching the information and presenting it via the magnificient [fzf](https://junegunn.github.io/fzf/).
+
+# current features
+- search based on name and folder
 - copy user/pass/totp
-- cache the items to make it fast
-- cache is not persisted to disk
+- cache the items in shared memory (`/dev/shm/`) to make it fast
+- cache does not persisted through reboots
+- refresh cache
+- preview items in `YAML` form
+
+# requirements
+
+The following software is needed by `bwzy`:
+
+- [fzf](https://junegunn.github.io/fzf/) for fuzzy finding
+- [bitwarden cli client](https://contributing.bitwarden.com/getting-started/clients/cli) to access bitwarden
+- [jq](https://jqlang.github.io/jq/) to work with the JSON
+- [OATH Toolkit](https://www.nongnu.org/oath-toolkit/) allows generating TOTP tokens
+- [charmbracelet - gum](https://github.com/charmbracelet/gum) for the loading spinner and color
+
+it also expects `sed` and `awk` to be available
+
+## arch install
+```bash
+pacman -S fzf bitwarden-cli jq haskell-yaml oath-toolkit gum
+```
 
 # feature ideas
+- auto-fill
 - "archive" feature to filter things
-- add ability to edit an entry
-- add ability to add a new entry
+- ability to edit an entry
+- ability to add a new e.ntry