Update README

README.md

@@ -1,13 +1,43 @@
 # Mastodon PESOS
 
-Fetch a Mastodon account's posts and save them as Markdown files. For the time being this generates the files formatted as [Hugo](https://gohugo.io) markdown files.
+Fetch a Mastodon account's posts and save them as Markdown files. Posts are transformed to Markdown, images are inlined, and replies are threaded.
 
-Use this to syndicate Mastodon posts to your own site. See IndieWeb's guide on [PESOS](https://indieweb.org/PESOS) for more information.
+For the time being this formats the files with [Hugo](https://gohugo.io) front-matter.
 
-## To do
+I use this small tool to create an archive of my Mastodon posts, which I then [syndicate to my own site](https://indieweb.org/PESOS).
-- [x] Fetch Mastodon account id
+
-- [x] Fetch Mastodon posts
+## Flags
-- [x] Save posts to files
+```
-- [x] Transform HTML to Markdown
+Usage of ./mastodon-pesos:
-- [x] Show embedded images
+  -dist string
-- [x] Support filtering posts using Mastodon's [query parameters](https://docs.joinmastodon.org/methods/accounts/#query-parameters)
+        Path to directory where files will be written
+  -exclude-reblogs
+        Whether or not to exclude reblogs
+  -exclude-replies
+        Whether or not exclude replies to other users
+  -limit int
+        Maximum number of posts to fetch (default 40)
+  -persist
+        Persist most recent post id to /tmp/mastodon-pesos-fid
+  -since-id string
+        Fetch only posts made since passed post id
+  -user string
+        URL of User's Mastodon account whose toots will be fetched
+```
+
+## Usage
+
+Here is how I use this to fetch the 15 most recent posts in my Mastodon account. It excludes replies to others, and reblogs. 
+
+Lastly, I use `--persist` to save the most recent id to a file and use `--since-id` so that subsequent runs fetch posts only after the most recently fetched post.
+
+```sh
+./mastodon-pesos \
+--user https://social.coop/@ggpsv \
+--dist ./posts \
+--exclude-replies \
+--exclude-reblogs \
+--limit=15 \
+--persist \
+--since-id=$(test -f /tmp/mastodon-pesos-fid && cat /tmp/mastodon-pesos-fid || echo "")
+```