Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/freed-wu/fzf-tab-source
:gear: a collection of fzf-tab completion sources.
https://github.com/freed-wu/fzf-tab-source
fzf fzf-tab zsh
Last synced: 6 days ago
JSON representation
:gear: a collection of fzf-tab completion sources.
- Host: GitHub
- URL: https://github.com/freed-wu/fzf-tab-source
- Owner: Freed-Wu
- License: gpl-3.0
- Created: 2022-10-15T08:42:03.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-14T13:18:26.000Z (4 months ago)
- Last Synced: 2024-09-15T22:34:36.777Z (4 months ago)
- Topics: fzf, fzf-tab, zsh
- Language: Shell
- Homepage:
- Size: 137 KB
- Stars: 66
- Watchers: 3
- Forks: 9
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fzf-tab-source
[](https://results.pre-commit.ci/latest/github/Freed-Wu/fzf-tab-source/main)
[](https://github.com/Freed-Wu/fzf-tab-source/releases)
[](https://github.com/Freed-Wu/fzf-tab-source/releases/latest)
[](https://github.com/Freed-Wu/fzf-tab-source/issues)
[](https://github.com/Freed-Wu/fzf-tab-source/issues?q=is%3Aissue+is%3Aclosed)
[](https://github.com/Freed-Wu/fzf-tab-source/pulls)
[](https://github.com/Freed-Wu/fzf-tab-source/pulls?q=is%3Apr+is%3Aclosed)
[](https://github.com/Freed-Wu/fzf-tab-source/discussions)
[](https://github.com/Freed-Wu/fzf-tab-source/milestones)
[](https://github.com/Freed-Wu/fzf-tab-source/network/members)
[](https://github.com/Freed-Wu/fzf-tab-source/stargazers)
[](https://github.com/Freed-Wu/fzf-tab-source/watchers)
[](https://github.com/Freed-Wu/fzf-tab-source/graphs/contributors)
[](https://github.com/Freed-Wu/fzf-tab-source/graphs/commit-activity)
[](https://github.com/Freed-Wu/fzf-tab-source/commits)
[](https://github.com/Freed-Wu/fzf-tab-source/releases/latest)
[](https://github.com/Freed-Wu/fzf-tab-source/blob/main/LICENSE)
This zsh plugin is a collection of
[fzf-tab](https://github.com/Aloxaf/fzf-tab)'s sources. Please read
[the wiki](https://github.com/Aloxaf/fzf-tab/wiki/Preview) first.
## Install
This plugin respects
[zsh plugin standard](https://github.com/zdharma-continuum/Zsh-100-Commits-Club/blob/master/Zsh-Plugin-Standard.adoc),
so if you use any plugin manager and follow the instructions of your plugin
manager, it can be installed correctly.
If you don't use any plugin manager, just add the following code to `~/.zshrc`:
```zsh
source /the/directory/of/this/plugin/*.plugin.zsh
```
**NOTE**: Don't source `*.zsh`! They will be sourced by `*.plugin.zsh` automatically.
## Preview
You need some optional tools:
- [bat](https://github.com/sharkdp/bat): view code
- [pandoc](https://github.com/jgm/pandoc): convert any kind of file to
markdown. Any generated cache file will be store in same
`/tmp/zsh-fzf-tab-$USER` as [fzf-tab](https://github.com/Aloxaf/fzf-tab)
- render markdown: Refer
- [grc](https://github.com/garabik/grc): colorize the output of some commands
- [less](https://github.com/vbwagner/less): a pager
### less
This plugin uses `less` to display any file. `less` can be configured by
the environment variable `LESSOPEN`.
```sh
$ echo $LESSOPEN
|/usr/bin/lesspipe %s
```
_NOTE_: in some GNU/Linux distributions, it's `lesspipe.sh` or other names.
[lesspipe](https://github.com/wofr06/lesspipe) is a script to select
different tool for different kind of file.
You can write your `~/.lessfilter` to
[customize lesspipe](https://github.com/wofr06/lesspipe#9-user-defined-filtering).
For example:
[lesspipe selects `ls` to display
a directory](https://github.com/wofr06/lesspipe/pull/107).
You can install some tools to view directories, such as:
- [eza](https://github.com/eza-community/eza): written in rust
- [lsd](https://github.com/lsd-rs/lsd): written in rust
- [colorls](https://github.com/athityakumar/colorls): written in ruby
You can install some tools to view code, such as:
- [syncat](https://github.com/foxfriends/syncat): use
[tree sitter](https://github.com/tree-sitter/tree-sitter)
- [bat](https://github.com/sharkdp/bat): use
[sublime syntax](https://www.sublimetext.com/docs/syntax.html)
- [pygmentize](https://github.com/pygments/pygments): use python
- [rouge](https://github.com/rouge-ruby/rouge): use ruby
- [vimpager](https://github.com/rkitover/vimpager): use vim script
- [nvimpager](https://github.com/lucc/nvimpager):
[use vim script](https://github.com/lucc/nvimpager/issues/63)
[lesspipe doesn't display image](https://github.com/wofr06/lesspipe/pull/106).
You can install some tools to view images, such as:
- [chafa](https://github.com/hpjansson/chafa): written in C
- [catimg](https://github.com/posva/catimg): written in C
- [timg](https://github.com/hzeller/timg): written in C++
- [tiv](https://github.com/radare/tiv): written in Vala
- [plotext](https://github.com/piccolomo/plotext): written in python
My
[~/.lessfilter](https://github.com/Freed-Wu/my-dotfiles/blob/main/.lessfilter)
can be a reference.
### pinyin
[pinyin-completion](https://github.com/petronny/pinyin-completion): complete
pinyin in your zsh.
This plugin also uses `less` to view the completion results of pinyin-completion.
### zsh
This plugin uses any one of the following tools to display user information:
- `finger`
- `pinky`
This plugin also uses `less` to view commands. `lesspipe` uses `ldd` to view
binary programs.
### zinit
[zinit](https://github.com/zdharma-continuum/zinit) is a zsh plugin manager.
Preview every zsh plugin's `README.md`.
### hexyl
Other tools which can display binary files are supported, too:
- `od`
- `xxd`
### git
This plugin uses your git's pagers to view the outputs of some git command.
For example, by default:
```sh
$ git log --oneline
3ee9df0 :heavy_plus_sign: Add emojify
d74f60a :sparkles: Add sysctl, lsof, arp, netstat, ss, archlinux-java, coredumpctl
592d286 :pencil2: Fix a typo about command
4dd0c69 :children_crossing: Fix #8, don't mkdir ~/.gitmoji
```
You can install [`emojify`](https://github.com/mrowa44/emojify) then:
```sh
git config --global pager.log emojify
```
```sh
$ git log --oneline
3ee9df0 ➕ Add emojify
d74f60a ✨ Add sysctl, lsof, arp, netstat, ss, archlinux-java, coredumpctl
592d286 ✏️ Fix a typo about command
4dd0c69 🚸 Fix #8, don't mkdir ~/.gitmoji
```
My
[~/.config/git/config](https://github.com/Freed-Wu/my-dotfiles/blob/main/.config/git/config)
can be a reference.
### kill
Preview which command will be killed after `kill XXX`.
### make
Preview which command will be executed after `make XXX`.
### systemctl
### adb
We cannot ensure any program (`eza`, etc) are installed in other machine
(Android). This plugin uses Android's `ls` to display directory and `cat` to
display text.
## Customize
### Sources
```zsh
zstyle ':fzf-tab:sources' config-directory /a/directory
```
You can use your customized fzf-tab sources to override
[this plugin's sources](sources).
`*.zsh` in `config-directory` are standalone zsh scripts which can be syntax
highlighted by your editor:
```zsh
# :fzf-tab:complete:context --optional-fzf-option
foobar $word
```
- Built-in commands and aliases should start with `(\\|)` to support `\command`
- Commands should start with `(\\|*/|)` to support `=command`
That is, `\command `, `=command ` will get same preview windows as
`command `.
### Similar Project
- [fifc](https://github.com/gazorby/fifc):
[fzf](https://github.com/junegunn/fzf) for
[fish](https://github.com/fish-shell/fish-shell)