Skip to content

AUR package fzf finder to search, install, remove, and manage packages using yay

License

Notifications You must be signed in to change notification settings

ConnerWill/yayfzf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

449 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

yayfzf

AUR package fzf finder to search, install, remove, and manage packages using yay yay

Shellcheck GitHub last commit GitHub issues GitHub repo size GitHub top language GitHub language count License GitHub Release Version AUR Version GitLab

Description

AUR package fzf finder to search, install, remove, and manage packages using yay

Table of Contents

Screenshots

demo screenshot demo screenshot 2

Features

  • Interactive menu for Arch Linux package manager
  • Inline package information preview
  • Multi-select support via fzf
  • Toggleable preview window
  • Multiple built-in color themes
  • Configurable layout, borders, and keybindings
  • XDG-compliant configuration file support

Requirements

  • yay
  • fzf

Installation

AUR

yay -S yayfzf

Git

Clone the repository and make the script executable:

git clone https://github.com/connerwill/yayfzf.git
cd yayfzf
chmod +x bin/yayfzf

Optionally, move it to a directory in your PATH:

sudo install -Dm755 "bin/yayfzf" "/usr/local/bin/yayfzf"  # Main executable
sudo install -Dm644 "docs/README.md" "/usr/share/doc/yayfzf/README.md"  # Documentation
sudo install -Dm644 "docs/yayfzf.1" "/usr/share/man/man1/yayfzf.1"  # Man page
sudo install -Dm644 "LICENSE" "/usr/share/licenses/yayfzf/LICENSE"  # License
sudo install -Dm644 "completion/_yayfzf" "/usr/share/zsh/site-functions/_yayfzf"  # ZSH completion
sudo install -Dm644 "completion/yayfzf_completion.sh" "/usr/share/bash-completion/completions/yayfzf"  # Bash completion

Usage

Launch the interactive interface:

yayfzf

Command Line Options

Option Description
-k, --keybindings Show keybindings and exit
-i, --init-config Install example configuration file
-s, --show-config Show example configuration file content
-v, --verbose Show verbose output
-h Show short help
--help Show full help
--help-man Show manpage help
-V, --version Show version

Keybindings

Key Action
Move up
Move down
PGUP Move up one page
PGDN Move down one page
HOME Move to first
END Move to last
ENTER Perform action on selection
TAB Select item
Shift+TAB Unselect item
CTRL+a Select all items
CTRL+d Deselect all items
CTRL+i Install selected packages
CTRL+r Uninstall package
CTRL+u Update all packages
CTRL+l Clear search query
CTRL+Backspace Clear search query
CTRL+/ Change layout
CTRL+v Toggle preview window
? Show keybindings
CTRL+c Exit yayfzf
CTRL+w Exit yayfzf
ESC Exit yayfzf

Configuration

Configuration Files

yayfzf looks for configuration files in this order (uses the first file found):

  • $XDG_CONFIG_HOME/yayfzf/yayfzf.conf
  • $HOME/.config/yayfzf/yayfzf.conf
  • $HOME/.yayfzf.conf

Configuration Options

Option Description Default
THEME Color theme default (options: default, light, tokyo-night, neon)
SORT_BY Package sort order popularity (options: popularity, votes, last_updated)
PREVIEW_WINDOW fzf preview window layout and size right:60%:wrap
ENABLE_PREVIEW Show preview window true
LAYOUT fzf layout reverse (options: default, reverse)
BORDER fzf border style rounded (options: default, rounded)
PROMPT Prompt string for fzf "yayfzf> "
VERBOSE Enable verbose logging false
YAYFZF_PAGER Pager for help/config/keybindings ${PAGER:-less}
CTRL_C_CLOSE Close yayfzf with Ctrl-C true

See Also

Other

Contributing

Click to expand contributing section

Any contributions you make are greatly appreciated.

If you want to contribute, please fork this repo and create a pull request.

  1. Fork the Project
  2. Create your Feature Branch
git checkout -b AmazingNewFeature
  1. Commit your Changes
git commit -m 'Description of the amazing feature you added'
  1. Push to the Branch
git push origin AmazingNewFeature
  1. Then open a pull request :)

If you experience any bugs/issues or have and suggestions, you can simply open an issue :)

Donate

Monero (XMR) icon and wallet QR code XMR : 86tE67soBqFb5fxNGgC4HLdwZXebP42ewfBwfKyMDKvFbgA7T8p4g4T5BBNA9LNbwaVafup973w41PdvCS7bbj6gTNQpCh1

₿ BTC : bc1qpg5d69n2knsete7vw7f2vqpkg4a0faq9rc6se0

(back to top)

About

AUR package fzf finder to search, install, remove, and manage packages using yay

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •