https://github.com/wfxr/tmux-fzf-url
🚀 Quickly open urls on your terminal screen!
https://github.com/wfxr/tmux-fzf-url
cli fzf tmux tmux-plugin tui
Last synced: 10 days ago
JSON representation
🚀 Quickly open urls on your terminal screen!
- Host: GitHub
- URL: https://github.com/wfxr/tmux-fzf-url
- Owner: wfxr
- License: other
- Created: 2018-04-06T02:06:33.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-14T14:24:53.000Z (about 1 year ago)
- Last Synced: 2024-10-13T02:09:04.425Z (6 months ago)
- Topics: cli, fzf, tmux, tmux-plugin, tui
- Language: Shell
- Homepage:
- Size: 1.35 MB
- Stars: 522
- Watchers: 5
- Forks: 42
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Funding: FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-starred - tmux-fzf-url - 🚀 Quickly open urls on your terminal screen! (Shell)
- awesome-list - tmux-fzf-url
- awesome-tmux - tmux-fzf-url
README
# tmux-fzf-url
[](https://github.com/tmux-plugins/tpm)
[](https://github.com/rothgar/awesome-tmux)
[](https://wfxr.mit-license.org/2018)
A tmux plugin for opening urls from browser quickly without mouse.
### 📥 Installation
Prerequisites:
* [`fzf`](https://github.com/junegunn/fzf)
* [`bash`](https://www.gnu.org/software/bash/)
**Install using [TPM](https://github.com/tmux-plugins/tpm)**
Add this line to your tmux config file, then hit `prefix + I`:
``` tmux
set -g @plugin 'wfxr/tmux-fzf-url'
```
**Install manually**
Clone this repo somewhere and source `fzf-url.tmux` at the config file.
### 📝 Usage
The default key-binding is `u`(of course prefix hit is needed), it can be modified by
setting value to `@fzf-url-bind` at the tmux config like this:
``` tmux
set -g @fzf-url-bind 'x'
```
You can also extend the capture groups by defining `@fzf-url-extra-filter`:
``` tmux
# simple example for capturing files like 'abc.txt'
set -g @fzf-url-extra-filter 'grep -oE "\b[a-zA-Z]+\.txt\b"'
```
The plugin default captures the current screen. You can set `history_limit` to capture
the scrollback history:
```tmux
set -g @fzf-url-history-limit '2000'
```
You can use custom fzf options by defining `@fzf-url-fzf-options`.
```
# open tmux-fzf-url in a tmux v3.2+ popup
set -g @fzf-url-fzf-options '-w 50% -h 50% --multi -0 --no-preview --no-border'
```
By default, `tmux-fzf-url` will use `xdg-open`, `open`, or the `BROWSER`
environment variable to open the url, respectively. If you want to use a
different command, you can set `@fzf-url-open` to the command you want to use.
```tmux
set -g @fzf-url-open "firefox"
```
### 💡 Tips
- You can mark multiple urls and open them at once.
- The tmux theme showed in the screenshot is [tmux-power](https://github.com/wfxr/tmux-power).
### 🧩 Similar projects
- [tmux-fzf-links](https://github.com/alberti42/tmux-fzf-links): A more versatile tmux plugin that allows you to search for and open links.
### 🔗 Other plugins
- [tmux-power](https://github.com/wfxr/tmux-power)
- [tmux-net-speed](https://github.com/wfxr/tmux-net-speed)
### 📃 License
[MIT](https://wfxr.mit-license.org/2018) (c) Wenxuan Zhang