aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar Tom Willemse2022-10-17 22:30:22 -0700
committerGravatar Tom Willemse2022-10-17 22:30:22 -0700
commit511167e9c118926a3d27d4189b7a31106371fc35 (patch)
tree61010ca9b1beb0a7cdf71e38ee631b0a0d1a0dc0
parentbe7a70a495d96c508ab6e3bc112dbcbf6d882dc6 (diff)
downloadcount-emails-master.tar.gz
count-emails-master.zip
Add a simple READMEHEADmaster
-rw-r--r--README.org15
1 files changed, 15 insertions, 0 deletions
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..14b03b7
--- /dev/null
+++ b/README.org
@@ -0,0 +1,15 @@
+#+title: Count Emails
+
+A simple script that counts the number of unread emails in my inbox for display in a status bar like [[https://polybar.github.io/][Polybar]].
+
+* Requirements
+
+This script needs [[https://scsh.net/][scsh]]. It also optionally needs [[https://notmuchmail.org/][notmuch]]. If notmuch isn't installed, it needs [[https://www.gnu.org/software/findutils/][findutils]] instead.
+
+* Installation
+
+Put the =count-emails= script anywhere in your =$PATH=.
+
+* Usage
+
+Run the =count-emails= script without arguments. If notmuch is installed it just asks it how many emails there are tagged =inbox= and =unread=, otherwise it needs one or more [[https://en.wikipedia.org/wiki/Maildir][Maildir]]-format directories to exist in =$HOME/documents/mail=.