focus-ami

A command line tool to kill processes.

Its purpose is to focus for a given period of time, blocking all distracting apps specified.

Configuration

The first time running the program, 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 an u8 that corresponds to a bit less than five minutes. A thirty seconds interval is normally fine.

Then you will be 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 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

killtime: 30 worktime: 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-ami -a

Then start your application. This can fail in three ways.

  1. Your user is not the one responsible for the process created.
  2. The process was already started.
  3. The process is an instance of something else running it, e.g., python3 applications.

The first way can be circumvented by not running the user check using

focus-ami --annotate-no-user

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 to 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
  2. start your application
  3. in the same directory as in the first instruction run $ ps -e > file2
  4. run $ diff file1 file2

Use

Command Line Arguments

The application accepts the following command line arguments

``` USAGE: focus-ami [OPTIONS]

OPTIONS: -a, --annotate Annotator mode, a guide to find processes names --annotate-no-user Annotator mode, a guide to find processes names, without filtering for user -c, --config Use the configuration from . is a path starting from your current working directory -h, --help Print help information -s, --silent Disallow interactions during the focus period -V, --version Print version information

```

Interactions

Possible interactions are:

Edit

You can edit parts or your configuration file, while running the program. Your available options are: