mirror of
https://github.com/FliegendeWurst/tmux-thumbs.git
synced 2024-11-22 04:45:00 +00:00
Add readme background
This commit is contained in:
parent
2ebdcbc005
commit
4c42803ed6
48
README.md
48
README.md
@ -7,7 +7,7 @@ A lightning fast version of [tmux-fingers](https://github.com/Morantron/tmux-fin
|
|||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
Press ( <kbd>prefix</kbd> + <kbd>Space</kbd> ) to highlist in you current tmux
|
Press ( <kbd>prefix</kbd> + <kbd>Space</kbd> ) to highlist in you current tmux
|
||||||
visible pane all text that match specific pattern. The press the highlighted
|
visible pane all text that match specific pattern. Then press the highlighted
|
||||||
letter hint to yank the text in your tmux buffer.
|
letter hint to yank the text in your tmux buffer.
|
||||||
|
|
||||||
### Matched patterns
|
### Matched patterns
|
||||||
@ -22,7 +22,7 @@ letter hint to yank the text in your tmux buffer.
|
|||||||
- kubernetes resources
|
- kubernetes resources
|
||||||
- UUIDs
|
- UUIDs
|
||||||
|
|
||||||
Those are the list of mattched patterns that will be highlighted by default. If
|
These are the list of mattched patterns that will be highlighted by default. If
|
||||||
you want to highlight a pattern that is not in this list you can add one or
|
you want to highlight a pattern that is not in this list you can add one or
|
||||||
more with `--regexp` parameter.
|
more with `--regexp` parameter.
|
||||||
|
|
||||||
@ -38,6 +38,13 @@ Clone the repo:
|
|||||||
git clone https://github.com/fcsonline/tmux-thumbs ~/.tmux/plugins/tmux-thumbs
|
git clone https://github.com/fcsonline/tmux-thumbs ~/.tmux/plugins/tmux-thumbs
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Compile it with [cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html):
|
||||||
|
|
||||||
|
```
|
||||||
|
cd ~/.tmux/plugins/tmux-thumbs
|
||||||
|
cargo build --release
|
||||||
|
```
|
||||||
|
|
||||||
Source it in your `.tmux.conf`:
|
Source it in your `.tmux.conf`:
|
||||||
|
|
||||||
```
|
```
|
||||||
@ -50,27 +57,11 @@ Reload TMUX conf by running:
|
|||||||
tmux source-file ~/.tmux.conf
|
tmux source-file ~/.tmux.conf
|
||||||
```
|
```
|
||||||
|
|
||||||
## Install
|
|
||||||
|
|
||||||
The easiest way right now is to install with [cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html):
|
|
||||||
|
|
||||||
```
|
|
||||||
cargo install tmux-thumbs
|
|
||||||
tmux-thumbs -
|
|
||||||
```
|
|
||||||
|
|
||||||
or download the source code and compile it:
|
|
||||||
|
|
||||||
```
|
|
||||||
git clone git@github.com:fcsonline/tmux-thumbs.git && cd tmux-thumbs
|
|
||||||
cargo build --release
|
|
||||||
```
|
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
If you want to customize how is shown your tmux-thumbs hints you can run the
|
If you want to customize how is shown your tmux-thumbs hints you can run the
|
||||||
command `tmux-thumbs` directly and play with all available parameters to set
|
command `target/release/tmux-thumbs` directly and play with all available
|
||||||
your perfect profile.
|
parameters to set your perfect profile.
|
||||||
|
|
||||||
Once completed, write those parameters in
|
Once completed, write those parameters in
|
||||||
`~/.tmux/plugins/tmux-thumbs/tmux-thumbs.sh` file. There is a `COMMAND`
|
`~/.tmux/plugins/tmux-thumbs/tmux-thumbs.sh` file. There is a `COMMAND`
|
||||||
@ -79,7 +70,7 @@ variable where you can set all those options.
|
|||||||
Example:
|
Example:
|
||||||
|
|
||||||
```
|
```
|
||||||
tmux-thumbs -a qwerty -r -u
|
./target/release/tmux-thumbs -a qwerty -r -u
|
||||||
```
|
```
|
||||||
|
|
||||||
You can review all available options executing:
|
You can review all available options executing:
|
||||||
@ -113,6 +104,11 @@ OPTIONS:
|
|||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Extra features
|
||||||
|
|
||||||
|
- **Arrow navigation:** You can use the arrows to move arround between all matched items.
|
||||||
|
- **Auto paste:** If your last typed hint character is uppercase, you are going to pick and paste the desired hint.
|
||||||
|
|
||||||
### Arguments
|
### Arguments
|
||||||
|
|
||||||
- **alphabet:** Choose which set of characters is used to build hints. Default [qwerty]
|
- **alphabet:** Choose which set of characters is used to build hints. Default [qwerty]
|
||||||
@ -170,11 +166,15 @@ This is the list of available colors:
|
|||||||
- white
|
- white
|
||||||
- default
|
- default
|
||||||
|
|
||||||
## Extra features
|
## Background
|
||||||
|
|
||||||
- **Arrow navigation:** You can use the arrows to move arround between all matched items.
|
As I said, this project is based in [tmux-fingers](https://github.com/Morantron/tmux-fingers). He did an extraordinary job, building all necessary pieces in Bash to achieve the text picker behaviour. He only deserves my gratitude for all the time I have been using [tmux-fingers](https://github.com/Morantron/tmux-fingers).
|
||||||
- **Auto paste:** If your last typed hint character is uppercase, you are going to pick and paste the desired hint.
|
|
||||||
|
|
||||||
|
During a [Fosdem](https://fosdem.org/) conf, we had the idea to rewrite it to another language. He had these thoughts many times ago but it was hard to start from scratch. So, we decided to start playing with Node.js and [react-blessed](https://github.com/Yomguithereal/react-blessed), but we detected some unacceptable latency when the program booted. We didn't investigate much about this latency.
|
||||||
|
|
||||||
|
During those days another alternative appeared, called [tmux-picker](https://github.com/RTBHOUSE/tmux-picker), implemented in python and reusing many parts from [tmux-fingers](https://github.com/Morantron/tmux-fingers). It was nice, because it was fast and added original terminal color support.
|
||||||
|
|
||||||
|
I was curious to know if this was possible to be written in [Rust](https://www.rust-lang.org/), and soon I realized that was something doable. The ability to implement tests for all critic parts of the application give you a great confidence about it. On the other hand, Rust has an awesome community that lets you achieve this kind of project in a short period of time.
|
||||||
|
|
||||||
## Contribute
|
## Contribute
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user