Awesome

fav

Archived

This projecthas been archived. Please, take a look at FM which integratesx the same functionalities, plush much more.

Overview

zsh/fzf plugin: easily add and recall named favorites of your important directories and files. You can create, delete and autocomplete persistent aliases on the fly, or quickly search them with fzf and paste them in the prompt line.

Usage

Add favorite

Add any dir or file as a favorite:

~/repos/dd/oss/ruby/pagy $ fav add
[ADDED]  D  pagy  /home/dd/repos/dd/oss/ruby/pagy

~/repos/dd/oss/ruby/pagy $ fav add -f CHANGELOG.md
[ADDED]  F  CHANGELOG.md  /home/dd/repos/dd/oss/ruby/pagy/CHANGELOG.md

Add arbitrary named favorites:

~/repos/dd/oss/docker/files $ fav add docf
[ADDED]  D  docf /home/dd/repos/dd/oss/docker/files

/opt/vivaldi/resources/vivaldi/hooks $ fav add vivh
[ADDED]  D  vivh  /opt/vivaldi/resources/vivaldi/hooks

~/repos/dd/oss/ruby/pagy $ fav add -f README.md pagy-readme
[ADDED]  F  pagy-readme  /home/dd/repos/dd/oss/ruby/pagy/README.md

Use the favorite shortcuts

Use the saved favorite names in place of the actual dirs or files:

~ $ cd ~pagy           # normal cd
~ $ ~pagy              # cd with AUTO_CD zsh option
~ $ ~pa<tab><enter>    # completes ~pagy and cd to it
~ $ pagy               # cd with AUTO_CD + CDABLE_VARS zsh options
~ $ pagy/lib/extras    # cd with AUTO_CD + CDABLE_VARS zsh options in sub-path
~ $ nano ~pagy-readme  # use the file using its fav name

Use the fzf widget

Use the fzf widget to search the favs and insert in the ZLE buffer:

~ $ ls <alt-v>
<pick one or more favorites with fzf>
~ $ ls ~docf ~pagy
...
~ $ cat <alt-v>
<pick one or more favorites with fzf>
~ $ cat ~pagy-readme CHANGELOG.md
...

List favorites

List the favorites (ordered by -name):

~ $ fav list -name
F  CHANGELOG.md  /home/dd/repos/dd/oss/ruby/pagy/CHANGELOG.md
D  docf          /home/dd/repos/dd/oss/docker/files
?  old           /path/old
?  older         /path/older
D  pagy          /home/dd/repos/dd/oss/ruby/pagy
F  pagy-readme   /home/dd/repos/dd/oss/ruby/pagy/README.md
D  vivh          /opt/vivaldi/resources/vivaldi/hooks

Notice: you can also enable the icons from the Nerd Fonts instead of just F D ? in the first column

Remove favorites

Remove named favorite(s):

~ $ fav remove doc     # autocompletes (if only one matches) or opens the fzf panel
[REMOVED]  D  docf  /home/dd/repos/dd/oss/docker/files

Remove selected favorites with fzf panel:

~ $ fav remove
<pick one or more favs with fzf>
[REMOVED]  D  vivh  /opt/vivaldi/resources/vivaldi/hooks

Clean unknown paths

Removes all the favorites pointing to a unknown path:

~ $ fav clean
[REMOVED]  ?  old    /path/old
[REMOVED]  ?  older  /path/older

Install

Make sure you have fzf installed.

with zplug

zplug "ddnexus/fav"

with zgen

zgen load ddnexus/fav

with antigen

antigen bundle ddnexus/fav

Manually

Add source "/your/path/to/fav.plugin.zsh" in your ~/.zshrc.

Commands

Command	Action
`add [-f FILE] [NAME]`	Add the current dir or the `FILE` in it as `NAME`. If missing, `NAME` is generated based on `basename $PWD` or `FILE`
`~NAME`	Generated alias that expands to the full favorite path, internally declared with `hash -d NAME=/favorite/path` (see `man zshbuiltins` /hash)
`fav remove [QUERY]`	Remove selected favorites: `fav` matches the optional `QUERY` to `NAME` and removes it if it gets a single match. No `QUERY` or multiple matches open the `fzf` panel
`fav list [ORDER]`	Print the list of all the favorites. ORDER order can be `-type`, `-name`, `-path` or `-time` or reversed with `-rtype`, `-rname`, `-rpath` or `-rtime` (default `-time`)
`fav clean`	Remove all the favorites pointing to an unknown path
`fav env`	Show the value of variables and options
`fav help`	Show an usage screen
`alt-v`	Default `FAV_WIDGET_KEY` binding to the `fav::widget`. It opens the `fzf` panel listing all favs. It pastes the selected favorites into the `ZLE` buffer

Options

Variable	Description	Default
`FAV_WIDGET_KEY`	Key binding	`^[v` (alt-v)
`FAV_FILE`	Path to the data file	`$HOME/.fav`
`FAV_FZF_OPTS`	Extra `fzf` string of options to override the `FZF_DEFAULT_OPTS` (see `man fzf /options`)	`--height=50% --inline-info --exact --preview-window=noborder --reverse`
`FAV_DIR_PREVIEW_CMD`	Command used to populate the `fzf` preview panel for dirs	`exa
`FAV_FILE_PREVIEW_CMD`	Command used to populate the `fzf` preview panel for files	`bat
`FAV_ENABLE_ICONS`	Enable icons from fonts like Nerd Fonts (true\|false)	`false`
`FAV_DIR_ICON`	Icon string for dirs	`D`
`FAV_FILE_ICON`	Icon string for files	`F`
`FAV_UNKNOWN_ICON`	Icon string for unknown paths	`?`
`FAV_ORDER`	Keep the favorite list ordered by `-type`, `-name`, `-path` or `-time` or reversed with `-rtype`, `-rname`, `-rpath` or `-rtime`.	`-time`

Suggestions

exa and bat provide a better user experience. You may want to install them and maybe customize the FAV_DIR_PREVIEW_CMD and FAV_FILE_PREVIEW_CMD.
The Nerd Fonts provide icons for your terminal. You may want to install your preferred font-family and use it in your terminal. Then enable its icons with FAV_ENABLE_ICONS.
Edit the FAV_FZF_OPTS - or even empty it - if it overrides some of your own favorite fzf options.
If you prefer to have the newest favorites on top of the list, set FAV_ORDER=-rtime

License

This software is available as open source under the terms of the MIT License.