slococo
/
clauncher
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Simple script to launch applications on Unix-like systems.
9 Commits 1 Branch 0 Tags 44 KiB
Shell 82.8%
Makefile 17.2%
Go to file
Santiago Lo Coco 2afac0813d Update clauncher 2024-03-17 11:29:54 +01:00
.open_add Add initial files 2023-11-22 18:50:55 -03:00
.open_ignore Add initial files 2023-11-22 18:50:55 -03:00
Makefile Update Makefile 2024-03-17 11:07:05 +01:00
README.md Add README.md 2023-11-22 19:08:20 -03:00
capture.zsh Update zcompdump directory 2024-02-22 23:30:05 +01:00
clauncher Update clauncher 2024-03-17 11:29:54 +01:00

README.md

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

  1. Clone the repository to your local machine:

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

  2. Change into the project directory:

    cd clauncher

  3. Install the script globally using:

    sudo make install

    This will move the clauncher script to /usr/local/bin, making it accessible system-wide.

  4. 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 creates a cache file ($XDG_CACHE_HOME/launcher_opts) and a history file ($XDG_CACHE_HOME/launcher_opts_history) to improve performance and remember your application launch history. The cache and history files are generated in the respective XDG standard directories, falling back to default locations if the XDG variables are not set.

The configuration directory is $XDG_CONFIG_HOME/clauncher (or $HOME/.config/clauncher if XDG_CONFIG_HOME is not set), where you can find:

  • capture.zsh: A script to capture the available applications on your system.
  • .open_ignore: A list of applications to ignore.
  • .open_add: A list of additional applications to include.

License

This project is licensed under the MIT License.

Contributions

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