| @@ -5,12 +5,28 @@ that account gets a notification. This is useful for monitoring an admin account | |||
| may not be logged in all the time, or for checking in on an old account after you've | |||
| made a new one. | |||
| **You cannot monitor an account you can't log into. This is deliberate and will not be changed.** | |||
| ## Setup | |||
| **You cannot monitor an account you can't log into. This is deliberate and will not be changed.** | |||
| Pingbot requires the `ananas` package. You can install it with pip: | |||
| `pip3 install ananas` | |||
| Note that the version of ananas that's currently available on pip (as of 4/28/22) is | |||
| *not* compatible with Python 3.10. There's already a PR in to fix that so we just | |||
| have to wait for PyPI to catch up. | |||
| **On the account you want to monitor**, open Preferences, then Development, and click | |||
| the New Application button at the upper right. | |||
| You can either download `pingbot.py` and `sample-config.cfg` directly, or you can go to | |||
| the command line on the server you want to run Pingbot on and run | |||
| `git clone https://git.noelle.codes/noelle/Pingbot.git` | |||
| This will create a new directory called `Pingbot` that contains the repository's files. | |||
| You'll run `ananas` (see below) from there. | |||
| **In the Mastodon web interface on the account you want to monitor**, open Preferences, | |||
| then Development, and click the New Application button at the upper right. | |||
| You'll need to give your application a name; this can be pretty much anything you want. | |||
| Leave "Application website" blank, and leave "Redirect URI" alone. | |||
| @@ -52,4 +68,9 @@ bot running on a server without you havnig to be logged in. | |||
| If you want to change Pingbot's settings, you'll need to stop and restart the bot. | |||
| Make sure you stop the bot *before* you make changes; Pingbot saves its configuration | |||
| when it shuts down, and might overwrite your changes. | |||
| when it shuts down, and might overwrite your changes. | |||
| ## I need help! | |||
| You can contact me at [my Mastodon account](https://chat.noelle.codes/@noelle) and | |||
| I'll do my best to help you out. :) | |||