# focus
A command line tool to kill processes.
It's purpose is to focus for a given period of time, blocking all distracting
apps specified.
## Configuration
The first time running you will be asked to create a configuration file,
First you'll be asked to provide an interval between process killing times in
seconds. It's bound in a u8 that corresponds to a bit less than five minutes. A
thirty second interval is normally fine.
Then you will be asked to asked for a period of time to focus in minutes. This
value is bound by 65280. This corresponds to 45 days and a bit, but I doubt you
need to focus for that long.
At this point you'll be asked for a "password" this password will be asked
before some of the actions. The idea being that if the password is long enough
you might think twice before pausing, editing or quitting.
Finally you will be asked for the list of processes to kill. Because this list
is a list of process names, it can be a little tricky. That's why there is a
helper included with this program, the annotator.
An example of the final configuration file is:
```yaml
---
kill_time: 30
work_time: 30
password: a
processes:
- firefox-bin
- vlc.bin
```
It is possible to have a work time that is smaller than the kill time, it makes
sense when you want to run once the killing part, and then quit.
## Annotator
Run the program like this
`focus -a`
then start your application. This can fail in three ways.
1. Your user is not the one responsible for the process created
1. The process was already started
1. The process is an instance of something else running it eg: python3
applications
The first way can be circumvented by not running the user check using
`focus -A`
If that doesn't work in KDE systems `control-esc` might help you with the system
activity tool. Probably other DEs have some similar tools, such as the task
manager in windows systems.
In *nix systems other option is to try and identify your process running `ps
-e` while it's running the application to identify.
A better way to do basically the same is to follow this instructions
1. run `$ ps -e > file1`
1. start your application
1. in the same directory as in the first instruction run `$ ps -e > file2`
1. run `$ diff file1 file2`
## Use
### Command Line Arguments
The application accepts the following command line arguments
* `-a, a, --annotator`: annotator mode, a guide to find processes names
* `-A, A`: annotator mode, a guide to find processes names,
without filtering for user,
* `-f, f, --file [FILE]`:use the config from FILE. FILE can be an
absolute or relative path
* `-s, s, --silent`: no interactions allowed during the focus period
* `-h, h, --help`: show this help
### Interactions
Possible interactions are:
* `e`: edit the config
* `p`: pause
* `q`: quit early
* `r`: see remaining time
* `a`: add some time to current run (but not to config)
#### Edit
You can edit parts or your config. Your available options are:
* `k`: edit the time that passes between process killings
* `w`: edit the work time
* `p`: edit the password
* `e`: edit the processes
* `c`: check the config
* `\q`: stop editing