fsh

fsh is a set of interactive terminal scripts built on f.sh, a pure-bash fuzzy menu library.

dependencies:

• bash 4+ (or any other bash-based terminal like zsh)
• a controlling terminal (/dev/tty)
• awk for fast search filtering
• extra tools each script wraps (ex. grim, slurp, bluetoothctl)

---

quick start

git clone https://github.com/arozoid/fsh.git
cd fsh
./run.sh

run any script directly:

./wifi.sh
./p.sh
./s.sh

---

install

./manage_f.sh                    # interactive menu
./manage_f.sh install local      # ~/fsh + ~/bin/fsh + fsh alias
./manage_f.sh install global     # /fsh + /bin/fsh
./manage_f.sh uninstall both       # remove local and global

after local install:

fsh                              # alias in .bashrc / .zshrc
export PATH="$HOME/bin:$PATH"      # if needed

after global install:

fsh                              # from anywhere

reinstall to sync an existing copy:

./manage_f.sh install global

---

launcher

run.sh (or fsh) lists every top-level *.sh script from these paths — first match wins, no duplicates:

1. ~/Downloads/fsh
2. ~/Documents/fsh
3. ~/Documents/@project/fsh
4. ~/fsh
5. /fsh
6. the directory containing run.sh

---

scripts

• run.sh: launcher menu
• manage_f.sh: install, uninstall, update scripts from working directory, or upgrade from GitHub
• wifi.sh: wifi manager (nmcli or wpa_cli)
• p.sh: search processes, kill, inspect, copy pid
• app.sh: launch desktop apps from .desktop files
• s.sh: pick ssh hosts from config
• bt.sh: bluetooth picker (bluetoothctl)
• calc.sh: interactive calculator with session history (bc -l / qalc)
• cd.sh: interactive directory navigator — outputs cd /path so you can eval "$(cd.sh)"
• clip.sh: clipboard history — saves and browses clipboard entries
• ss.sh: screenshots (grim + slurp)
• power.sh: lock, suspend, logout, reboot, shutdown
• hist.sh: fuzzy-pick shell history
• pkg.sh: package helper — search & install, remove, list installed, upgrade (apk, apt, dnf, pacman)
• symbols.sh: copy 40,000+ emojis and unicode symbols

---

f.sh api

source the library:

source lib/common.sh
fsh_menu_defaults
f_prompt='pick: '
f_height=12
f_border=1
choice=$(f_select "${items[@]}") || exit 1

main entry point — f_select item [item...] prints the selection to stdout, returns 1 on cancel.

config vars (set before f_select):

variable	default	description
f_prompt	'> '	prompt string shown at the bottom
f_height	10	number of visible list rows
f_border	0	1 to draw a box around the list
f_fuzzy	1	1 hybrid fuzzy+substring, 0 substring-only (exact match filter)
f_smart_priority	0	1 to guarantee normal (substring) hits always rank above fuzzy-only hits
f_hints	1	0 hides the key-hint line
f_marker	1	0 hides the ▸ cursor marker
f_status	1	0 hides the match count / scroll info
f_min_query_length	0	minimum characters before filtering starts (see below)
f_search_delay	250	milliseconds to wait after last keystroke before searching — debounces fast typing
f_preview_count	300	items shown when query is empty or below f_min_query_length (file/dynamic modes cap at this; array mode shows all)
f_no_search	0	1 to show all items without filtering — query is still captured for scripts to use
f_color_*, f_reset	ansi escapes	colors for each ui element

f_color_* and f_reset

every visible element of the menu has its own color variable. set them to any ANSI escape sequence:

variable	default	element
f_color_prompt	\033[1;35m (bold magenta)	prompt string
f_color_query	\033[1;37m (bold white)	typed query
f_color_normal	\033[0m (reset)	normal list items
f_color_selected	\033[46;30;1m (cyan bg, black, bold)	highlighted / selected item
f_color_border	\033[90m (bright black)	box border (when f_border=1)
f_color_match	\033[1;33m (bold yellow)	matched characters within items
f_color_dim	\033[2m (dim)	dimmed / secondary text
f_reset	\033[0m	reset after each colored segment

you only need to set the variables you want to override, and the rest keep their defaults:

f_color_prompt=$'\033[1;32m'   # green prompt
f_color_match=$'\033[1;31m'    # red highlights

fsh_menu_defaults resets all of them to the base defaults on every call.

alternate data sources

entry points for large lists that stay off the shell heap or stream results from a provider:

• f_select_file FILE: read candidates directly from FILE during filtering (never mapfile the whole file). usage:

fsh_menu_defaults
f_prompt='unicode: '
f_fuzzy=0
choice=$(f_select_file symbols.txt) || exit 1

• f_select_dynamic CALLBACK: call CALLBACK with the current query; the callback should print matching lines to stdout. this is useful for paged or external providers that can limit results themselves. usage:

my_provider() {
	local query=$1

	awk -v q="${query,,}" '
		BEGIN { q=tolower(q) }
		index(tolower($0), q) { print; if (++n == 500) exit }
	' symbols.txt
}

choice=$(f_select_dynamic my_provider) || exit 1

these add-ons keep the renderer independent of where items originate and avoid copying large files into bash arrays.

demo:

bash lib/f.sh