Launchify
---------
Launchify is a tool that makes it super easy to schedule programs to run on
a regular schedule on macOS. As an example, to schedule a program `myprog` to
run ever 5 minutes:
```$ launchify 5m myprog```
Under the hood, launchify registers your program to run using `launchd`. It
writes a boilerplate config file to `~/Library/LaunchAgents` and sets it up to
write logs to `~/logs/myprog`.
Install
-------
Install requires the rust toolchain, which may be installed like:
```$ curl https://sh.rustup.rs -sSf | sh```
Then install using `cargo`:
```$ cargo install launchify```
Advanced Usage
==============
To see full CLI options, run `launchify -h`.
You can specify the period to run the program over as (d)ays, (h)ours, (m)inutes
or (s)econds. For example, to run `myprog` once an hour:
```$ launchify 1h myprog```
Extra program args may be specified via the `--args` option
```$ launchify 5m myprog --args="--foo bar"```
You may override the default name used to label the launchify job and log
directory via `--name`. By default the name is derived from the program filename.
```$ launchify 5m myprog --name=my_awesome_program```
Comparison to launchctl
-----------------------
`launchify` is not intended to replace `launchctl` but is a convenience tool
to complement it. `launchify` purposely does not support the full configuration
options which may be passed to `launchctl` but optimizes for a common use-case.
After scheduling a program using `launchify`, you will find the configuration
file written to `~/Library/LaunchAgents/com.<name>.plist`. To stop running
the program, run:
```$ launchctl unload ~/Library/LaunchAgents/com.<name>.plist```
For further information on launch agents and daemones on macOS, see
https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/CreatingLaunchdJobs.html\