aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorJordan <me@jordan.im>2023-02-04 23:54:03 -0700
committerJordan <me@jordan.im>2023-02-04 23:54:03 -0700
commitc4159d895ac399ca55326f7b4ff8bfbf8402e654 (patch)
tree45340ca429c16f683b375695d01e03d65ebf22b0 /README
downloadpigeon-c4159d895ac399ca55326f7b4ff8bfbf8402e654.tar.gz
pigeon-c4159d895ac399ca55326f7b4ff8bfbf8402e654.zip
initial commit
Diffstat (limited to 'README')
-rw-r--r--README22
1 files changed, 22 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..9d77e5a
--- /dev/null
+++ b/README
@@ -0,0 +1,22 @@
+pigeon is a simple RFC-compliant email autoresponder; it monitors IMAP for
+mailbox updates and replies to unseen messages with content rendered from the
+configured template. pigeon supports per-address cooldown timers to prevent mail
+loops, and can ignore messages sent to alias addresses.
+
+pigeon is opinionated and is intended to be configured with accounts used by
+automated systems or unattended (and presently empty) inboxes; it's designed to
+accommodate a particularly narrow use case.
+
+pigeon's idling logic is borrowed from aerc[1] and makes use of emersion's
+well-designed go-imap[2] and go-smtp[3] libraries.
+
+Usage of ./pigeon:
+ -conf string
+ path to JSON configuration (default "./pigeon.json")
+ -eml string
+ path to EML message (default "./message.eml")
+
+[1] https://sr.ht/~rjarry/aerc/
+[2] https://github.com/emersion/go-imap
+[3] https://github.com/emersion/go-smtp
+