aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authoraxtloss <axtlos@getcryst.al>2024-05-28 20:01:57 +0200
committeraxtloss <axtlos@getcryst.al>2024-05-28 20:01:57 +0200
commitff0328765c04614701bbfe793bb228cd63f1b2fc (patch)
treeeaec361a71a2cb4d09e178e9574c260f5da58417 /README.md
parent85e5469362db3c3fb89f7dc3fbe1eb1431fb2fcc (diff)
downloadautodarkmode-ff0328765c04614701bbfe793bb228cd63f1b2fc.tar.gz
autodarkmode-ff0328765c04614701bbfe793bb228cd63f1b2fc.tar.bz2
add readme and fix some warnings
Diffstat (limited to 'README.md')
-rw-r--r--README.md34
1 files changed, 33 insertions, 1 deletions
diff --git a/README.md b/README.md
index bc2ee88..a2a5395 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,35 @@
# autodarkmode
-A description of this project.
+A simple tool to switch between dark and light mode.
+
+It executes a command on switch and nothing else.
+Location is either specified by the user or
+
+# Building
+```
+meson setup _build
+cd build
+meson compile
+```
+the resulting binary `src/autodarkmode` can then be moved to any directory in PATH.
+
+# Configuration
+```ini
+[main]
+; can be 'manual' or 'gclue'
+locationtype = "manual"
+
+[manual]
+; set latitude and longitude in case that locationtype is set to manual
+latitude = -10.0
+longitude = -5.0
+
+[light]
+; command to execute for light mode
+cmd = "notify-send 'a'"
+
+[dark]
+; command to execute for dark mode
+cmd = "notify-send 'b'"
+```
+autodarkmode expects to find this configuration in `$XDG_CONFIG_HOME/autodarkmode/config.ini`, in the case that XDG_CONFIG_HOME is empty, it will use `~/.config/autodarkmode/config.ini`