Add README and Makefile

1 files changed, 52 insertions, 0 deletions

@@ -0,0 +1,52 @@
+# autoshart
+## auto-start .desktop files on login
+
+*dedicated to my friend m455*
+
+Autostart programs are a modern ... thingy.  I'm not sure how I feel about em,
+but many programs ship with an autostart `*.desktop` file in
+`~/.config/autostart` or wherever.
+
+If you don't have a full-on DE, starting these programs can be a chore.  [Other
+programs](https://github.com/jceb/dex) have been written to address this, but
+those are (A) in Python and (B) not by me.  So here's my solution, in (I'm
+pretty sure it's) POSIX sh.
+
+## usage
+
+```
+AUTOSHART: autostart without the shit
+USAGE: autoshart -h
+autoshart [-k] [-n] [-q]
+
+FLAGS:
+ -h Show this help and exit.
+ -k Kill all processes started by autoshart and exit.
+ -n Only print what would happen; don't execute anything.
+ -q Don't print any output.
+```
+
+Drop something like the following in your `~/.xinitrc`:
+
+```
+autostart -q
+```
+
+And if you have some kind of logout script, put this in it:
+
+```
+autostart -k
+```
+
+## installation
+
+This is just a shell script, so you can copy or link it to your `$PATH`.  That's
+what the provided `Makefile` does.
+
+## contributing
+
+Send me an [email](mailto:git+autoshart@acdw.net)!
+
+## license
+
+[Good Choices License](https://acdw.casa/gcl/).  See COPYING for details.