Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
O

otter-launcher

> 编程语言
Open source

A hackable cli/tui launcher built for keyboard-centric wm users, featuring vi & emacs keybinds, ansi decoration, etc

318 stars0 likes4 views
WebsiteGitHub

About

A hackable cli/tui launcher built for keyboard-centric wm users, featuring vi & emacs keybinds, ansi decoration, etc

Table of Contents

  • Overview
  • Features
  • Demo
  • Installation
  • Configuration
  • Integration
  • Styling
  • Sponsorship

Overview

A very hackable app launcher, designed for keyboard-centric wm users. It is blazingly fast, supports vi and emacs keybinds, and can be decorated with ansi color codes, sixel or kitty image protocols.

The core concept is making these behaviours possible:

  • type "gg margaret thatcher" to google the lady in a web browser
  • "sh htop" to run htop in a terminal
  • "dc linux" to search the word linux with an online dictionary
  • "app" to launch application menu
  • etc.

It's recommended to setup a dedicated desktop app launcher as a module, like fsel or sway-launcher-desktop. Some helper scripts can be found in the contrib folder, modules in wiki.

Features

  • modularized to run different commands
  • vi and emacs keybinds
  • two suggestion modes: list & hint
  • tab completion; tab again to undo completion
  • edit prompt in an external editor (vim, emacs, etc.)
  • url encoding for web searching
  • supporting ansi codes, chafa, sixel or kitty image protocol, etc.
  • overlay layer to show chafa image
  • cheat sheet
  • callback functions
  • customizable shell by which programs are launched (sh -c, zsh -c, hyprctl dispatch exec, etc)
  • cli mode to launch modules directly (eg. "otter-launcher app" to enter app menu directly)
  • minimalist, blazingly fast, keyboard-centric

Demo

Workflow

External editor, list selection, and cheatsheet

Installation

With the AUR

bash
paru -S otter-launcher

Building from source

bash
git clone https://github.com/kuokuo123/otter-launcher /tmp/otter-launcher
cd /tmp/otter-launcher
cargo build --release
mkdir -p $HOME/.config/otter-launcher
cp /tmp/otter-launcher/config_example/config.toml $HOME/.config/otter-launcher/config.toml
sudo cp /tmp/otter-launcher/target/release/otter-launcher /usr/bin/

Configuration

Otter reads from $HOME/.config/otter-launcher/config.toml. If missing, it looks into /etc/otter-launcher/config.toml, which is included in the AUR installation. Use the '--config' or '-c' flag to specify your preferred path otherwise.

The default config comes only with a minimal setup. Check more examples for module setup, styling for image integration.

All the available options are listed below.

…

Integration

Otter-launcher works well with tui programs and bash pipelines. Some tricktips:

  1. Use your wm's window rules to control window size; make it large enough to prevent a skewed layout.

  2. [[modules]].cmd can be scripted to adjust window sizes. For example:

toml
[[modules]]
description = "pulsemixer for audio control"
prefix = "vol"
cmd = "swaymsg [app_id=otter-launcher] resize set width 600 px height 300 px; pulsemixer; swaymsg [app_id=otter-launcher] resize set width 600 px height 60 px"
  1. Some tui utilities that works really well:

    • Desktop app launcher: sway-launcher-desktop fsel
    • Audio control: pulsemixer wiremix
    • Bluetooth control: bluetui bluetuith
    • Wifi control: nmtui impala
    • Spotify: spotify_player
    • Mouse control: wl-kbptr
    • More on Awesome TUIs or Awesome Command Line(CLI/TUI) Programs.
  2. To change external editor's window size , call a wrapper script at general.external_editor. Examples of such a wrapper are in contrib.

Styling

Fastfetch

Using fastfetch in interface.header_cmd works without extra setting. However, add '--pipe false' to fastfetch in overlay.overlay_cmd to prevent its pipe mode from stripping colors.

toml
[interface]
header_cmd = """
fastfetch \
    --structure break:colors:break:title:os:shell:kernel:uptime \
    --logo-print-remaining false \
    --logo-height 8 \
    --logo-padding-left 3 \
    --sixel $HOME/.config/otter-launcher/images/images_squ/archlinux_chan.jpg
"""
header = "   \u001B[33;1m  otterly awesome \u001B[0m  \u001B[36;1m:\u001B[0;1m "
place_holder = "type & search"
suggestion_mode = "hint"
prefix_color = "\u001B[33m"
description_color = "\u001B[39m"
place_holder_color = "\u001B[30m"
hint_color = "\u001B[90m"

Image Protocol

Use chafa in header_cmd to render the image.

…

Image to the Left

Render chafa image at the left, moving the inteface to the right.

…

Image to the Right

This config renders a prinny using overlay_cmd, and then move the overlay right.

…

Otter Shocked

This custom script use ansi control codes to print texts to the right of a sixel shocked otter.

…

Sponsorship

If you find the project helpful, you can buy me a coffee through paypal.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Rust

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 18, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言