aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorGravatar BanceDev 2026-02-23 20:19:30 -0500
committerGravatar BanceDev 2026-02-23 20:19:30 -0500
commit771e600b4fcc6a3fbfe8870e73b7c2082b5413d2 (patch)
tree4cc6bab9fa759e2d9e5138386d6cb88fb78706f8 /README.md
parentadded license (diff)
add instructions to readme
Diffstat (limited to 'README.md')
-rw-r--r--README.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/README.md b/README.md
index 5743b48..539e6f3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,17 @@
# lockrs
A minimal X11 lockscreen make with xcb and rust.
+
+## Installation
+
+Clone the repo and then run:
+
+```
+cargo install --path .
+```
+
+ensure that `~/.cargo/bin` is on your PATH to be able to launch the application.
+
+## Usage
+
+You can run it from the command line or a launcher with `lockrs` or you could setup an auto lockscreen functionality like this `xautolock -time 5 -locker lockrs`. Note: xautolock is external software that you would need to download.