2.3 KiB

Raw Blame History

clauncher

clauncher is a simple Bash script designed to provide a convenient way to launch applications on Unix-like systems. It utilizes the fzf (fuzzy finder) tool to offer an interactive and efficient application launching experience.

Prerequisites

Before using clauncher, ensure that you have the following dependencies installed:

fzf: A command-line fuzzy finder.

Installation

Clone the repository to your local machine:

git clone https://git.slc.ar/slococo/clauncher.git

Change into the project directory:
```
cd clauncher
```
Install the script globally using:
```
sudo make install
```
This will move the clauncher script to /usr/local/bin, making it accessible system-wide.
To uninstall, use:
```
sudo make uninstall
```
This will remove the clauncher script from /usr/local/bin.

Usage

Basic Usage

Run the clauncher script in your terminal:

./clauncher

or if /usr/local/bin is in your PATH (it should be):

clauncher

This will present you with a list of applications to choose from using the fzf interface.

Keyboard Shortcuts

Arrow Up/Down: Navigate through the list.
Enter: Launch the selected application.
Ctrl-C: Exit the launcher without launching any application.

Configuration

clauncher enhances its performance and retains your application launch history by generating a cache file ($XDG_CACHE_HOME/launcher_opts) and a history file ($XDG_CACHE_HOME/launcher_opts_history). These files adhere to the XDG standard directories, with fallback locations if the XDG variables are not set.

For customization, if you want to ignore or add applications, you should manually create the directory ~/.config/clauncher if it doesn't exist, and then create two files inside it:

.open_ignore: List the applications or commands to ignore, each on a new line.
.open_add: List the additional applications or commands to include, each on a new line.

Edit these files directly to specify the applications or commands you want to exclude or include.

License

This project is licensed under the MIT License.

Contributions

Feel free to contribute, report issues, or suggest improvements!

2.3 KiB Raw Blame History