Add utility scripts, and document tnem at README

README.md

@@ -1,3 +1,50 @@
 Bloomscroller is a [Mastodon](https://joinmastodon.org) bot that is run as a cron job in order to drip-toot a [Piwigo](https://piwigo.org) gallery one image at a time.
 
-_to be cotinued_
+Specifically, I wrote it in order to publish photos from a [gallery](https://photos.nandn.org.il/piwigo/index.php?/category/21) of flowers that grow in [our](https://nandn.org.il/) garden (hence the name).
+
+At [config.py](config.py) there are `TOOT_TEMPLATE` and `ALT_TEXT_TEMPLATE` that can contain fields from an album image's [json info](example.json). In my specific test case I don't use `{title}` and `{comment}`, but they're there if they're useful for you.
+
+### Installing
+
+* Run `./install.sh`
+* Edit [config.py](config.py) to suit your needs
+* Run `./register.sh` to register the bot with you mastodon server (make sure the instance's policy allows you to run the bot).
+
+
+### Running
+
+Run `[/path/to/here]/run.sh`. This can be done as a cron job.
+
+```
+      , .-.-,_,
+      )`-.>'` (
+     /     `\  |
+     |       | |
+      \     / /
+      `=(\ /.=`
+       `-;`.-' 
+         `)|     ,
+          ||  .-'|
+        ,_||  \_,/
+  ,      \|| .'
+  |\|\  , ||/
+ ,_\` |/| |Y_,
+  '-.'-._\||/
+     >_.-`Y|
+     ` .-"||"-.
+       \'----'/
+        |:.  |
+        |::. |
+       /::::  \
+     .:::'     '.
+    /:::         \
+   ;:::'          ;
+   |:::           |
+   |:::           |
+   |:::           |
+   ;:::           ;
+   \:::.          /
+jgs ':::..      .'
+     `""-----""`
+```
+ASCII art by [Joan G. Stark](https://en.wikipedia.org/wiki/Joan_Stark).

install.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+cd "$(basename "$0")"
+virtualenv venv
+source venv/bin/activate
+pip install -r requirements.txt

register.py

@@ -16,4 +16,9 @@ def register_app():
     print("Registration complete")
 
 if __name__=='__main__':
+    print("""
+This utility should only be run *once* (if you see the file "secrets.txt", you probably shouldn't run this).
+You should also make sure that you've edited "config.py" with the relevant APP_INSTANCE_URL etc.,
+and that you don't violate the instance's code of conduct by running your bot (ask an admin if unsure).""")
+    input("Hit enter if you're ready to register your app with your mastodon server, otherwise — hit Ctrl-C ")
     register_app()

register.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+cd "$(dirname "$0")"
+source venv/bin/activate
+python register.py

run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+cd "$(dirname "$0")"
+source venv/bin/activate
+python bloomscroller.py