about summary refs log tree commit diff stats
path: root/README.md
blob: e868c83f039296564e5379346b521878c29e9cec (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
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.