SARA is a configurable tui application launcher with a customizable UI
ncurses libs are required to compile SARA
| Arch | # pacman -S ncurses |
| Debian | # apt install libncurses5 libncurses5-dev libncursesw5 libncursesw5-dev |
| Fedora | # dnf install ncurses ncurses-devel |
Summary & Features
Special Application Ranging Area
Application Launcher - Navigator - Terminal Decorator
Reduces repetitive terminal tasks to the fewest possible keystrokes, mapping navigation, command execution, and application launching to configurable keys
- Written in C
- Configured in C via config.h, compiled directly for speed
- 'make' and 'reload' keymaps configured by default for quick recompiling and hot-reloading of SARA from within SARA
- Three color and position-configurable foreground, background, and header ASCII art arrays
- commandkeys[] grants single-key press to immediate command execution
- builtinkeys[] assigns keystrokes to hardcoded builtin SARA functions
- menukeys[] maps key presses to custom menu popups, optionally pointing to endlessly nestable submenus
- Immediate selectable and filterable system bookmarks menu via builtin 'pshd'
- Interopability with ranger file explorer, following the last directory visited by ranger when launched by SARA
- Navigation options also available in custom menus
- Builtin path_run menu launches any selected binary in $PATH with ability to pass args by pressing [SPACE]
- Exports $PWD to file for parent shell to follow on exit
- .. and more to come
For basic usage, see getting started
Releases
Latest
v0.9.2 sig sum - path_run (dmenu_run tui clone) + args mode
SARA 0.9.2
PATCH NOTES
Bugs Fixed
- Menu was off center when menu_y < 3 (no menu border)
- Show color worky when resized
- Screen no longer clears when pshd_y is < 3 (no menu border)
- pshd no longer highlighted when pshd = 3
- hd[] no longer showing bold color in small mode when hd_c_bold is false
- Parent menu artifacts now disappear when entering submenus
- shutter_slide now uses fg_c
- hd_offset_y positions hd[] in the correct direction
New Quirks
- Makefile maps reload_cmd to $PWD/sara when generating config.h
Features
- New command line option -C detects rudimentary issues with config.h
- New builtin: path_run (default config, press ',') mimics dmenu_run, Press [space] to enter args for selected binary
New associated config options:
- run_c
- run_c_bold
- run_y
- run_x
- run_offset_y
- run_offset_x
Pressing [SPACE] in path_run mode will prompt for command args, appending your command with '&' is equivalent to prepending the command with 'nohup' and running with the NO_OUT extra_args option
Previous
v0.9.2 sig sum - path_run (dmenu_run tui clone) + args mode
SARA 0.9.2
PATCH NOTES
Bugs Fixed
- Menu was off center when menu_y < 3 (no menu border)
- Show color worky when resized
- Screen no longer clears when pshd_y is < 3 (no menu border)
- pshd no longer highlighted when pshd = 3
- hd[] no longer showing bold color in small mode when hd_c_bold is false
- Parent menu artifacts now disappear when entering submenus
- shutter_slide now uses fg_c
- hd_offset_y positions hd[] in the correct direction
New Quirks
- Makefile maps reload_cmd to $PWD/sara when generating config.h
Features
- New command line option -C detects rudimentary issues with config.h
- New builtin: path_run (default config, press ',') mimics dmenu_run, Press [space] to enter args for selected binary
New associated config options:
- run_c
- run_c_bold
- run_y
- run_x
- run_offset_y
- run_offset_x
Pressing [SPACE] in path_run mode will prompt for command args, appending your command with '&' is equivalent to prepending the command with 'nohup' and running with the NO_OUT extra_args option
v0.9.1 sig sum - first release
SARA 0.9.1
Initial release, check the 'getting started'
Contribute
Report issues, lob feature requests, or complain by emailing hackirot (at) proton (dot) me