diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9b046ae
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# mute sync
+
+syncs mutes, blocks and domain blocks between two or more fediverse accounts (on mastodon api-compatible instances)
+
+to use:
+
+log into an account by running `python get_token.py <instance> | tee <username or something>.env`
+
+this will attempt to open a browser window to authenticate, and prompt for a code that you will get after authenticating
+
+then run `python mute_sync.py *.env` and "enjoy"