https://github.com/kyoheiu/feu

A minimal application launcher for tiling window managers.
https://github.com/kyoheiu/feu

iced launcher linux rust

Last synced: 2 months ago
JSON representation

A minimal application launcher for tiling window managers.

• Host: GitHub
• URL: https://github.com/kyoheiu/feu
• Owner: kyoheiu
• License: mit
• Created: 2021-12-05T21:09:50.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-02-16T20:30:59.000Z (almost 2 years ago)
• Last Synced: 2024-10-04T22:12:53.357Z (4 months ago)
• Topics: iced, launcher, linux, rust
• Language: Rust
• Homepage:
• Size: 239 KB
• Stars: 8
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# :candle:feu

A minimal application launcher written in Rust.  

Currently works on Linux.

![sample](https://github.com/kyoheiu/feu/blob/develop/screenshot/sample.png)

## Installation

```

cargo install feu

```

or, 

```

git clone https://github.com/kyoheiu/feu.git

cd feu

cargo install --path .

```

This app is designed to be used with a tiling window manager such as i3, so after the installation, configure as follows, for example:

```

# ~/.config/i3/config

bindsym $mod+d exec ~/.cargo/bin/feu

```

Then you can run feu with `$mod+d`.

## Usage

| key     | action                    |

| ------- | ------------------------- |

| Up/Down | Move cursor.              |

| Enter   | Launch the selected app and exit.  |

| Esc     | Exit.                     |

| \_      | Filter the list.          |

For example, with a list like the one in the image above, you can start `firefox` simply by pressing the Enter key. You can also start `code` by typing 'c' and pressing the Enter key.

## Binary list

feu reads $PATH and `~/.config/feu/config.json`, and lists all binaries there. If the config file looks like this:

```

{

  "paths": ["/home/kyohei/.cargo/bin/", "home/kyohei/.test/bin/"]

}

```

Then feu lists binaries in $PATH, `/home/kyohei/.cargo/bin` and `/home/kyohei/.test/bin`. If the config file doesn't exist, only $PATH will be read (and I think that's enough).

_Currently, `~` is not allowed in the config file, so you have to write like `/home/user/...`._

At the launch, feu sorts the binary list by the number of execution, so the top of the list should be the app you've called the most.  

The execution history will be automatically saved in `~/.config/feu/.history` (which is also JSON format).

```

# ~/.config/feu/.history

{"history_map":{"code":2,"firefox":3}}

```

If you want to reset it, just delete the `.history` file and everything will be new.