asyncrun.extra
asyncrun.extra copied to clipboard
Extra runners for asyncrun to run your command in Tmux/Gnome-terminal panel, xterm, Floaterm and more.
Obsoleted
This plugin is obsoleted, because latest asyncrun has included these runners below, and no reason to maintain this project any more.
User should use asyncrun directly.
What is it ?
Extra runners for asyncrun to run your command in gnome-terminal, tmux, floaterm and more:
| Runner | Description |
|---|---|
| gnome | run command in a new gnome-terminal window |
| gnome-tab | run command in a new gnome-terminal tab |
| xterm | run command in a new xterm window |
| external | run command in cmd.exe / gnome-terminal / xterm if possible |
| floaterm | run command in a floaterm window |
| floaterm-reuse | run command in a reusable floaterm window |
| tmux | run command in another tmux pane |
| termhelp | run command in the terminal_help window |
Installation
For vim-plug:
Plug 'skywind3000/asyncrun.vim'
Plug 'skywind3000/asyncrun.extra'
asyncrun version 2.7.8 or latter is required.
Available Runners
Gnome-terminal
Run command in a new gnome-terminal window:
:AsyncRun -mode=term -pos=gnome ls -la
GVim Screencast:

Terminal Vim:

Run command in a new gnome-terminal tab:
:AsyncRun -mode=term -pos=gnome_tab ls -la
Screencast:

NOTE: -pos=external is an alias of -pos=gnome on Linux.
Xterm
Run command in a new xterm window:
:AsyncRun -mode=term -pos=xterm ls -la
Screencast:

External
The default external runner in asyncrun can run commands in cmd.exe:
:AsyncRun -mode=term -pos=external echo Hello, World !!
The command above runs in cmd.exe:

The default external runner in asyncrun works on Windows only, and will do nothing if you are using Linux.
This plugin provide an enhanced version of external runner which detect what OS currently in used and choose an appropriate external terminal (cmd.exe, gnome-terminal or xterm) when possible.
Floaterm
Run command in floaterm:
:AsyncRun -mode=term -pos=floaterm ls -la
With more floaterm options:
:AsyncRun -mode=term -pos=floaterm -position=bottomright -width=0.4 ls -la
:AsyncRun -mode=term -pos=floaterm -focus=0 ls -la
Gif:

Hint: try -pos=floaterm_reuse if you want to reuse existing floaterm window.
Tmux
Run command in another tmux panel (vimux is required):
:AsyncRun -mode=term -pos=tmux ls -la
Gif:

Terminal Help
Run command in the terminal_help window:
:AsyncRun -mode=term -pos=termhelp ls -la
Gif:

Help Required
- [ ] iterm2 runner
- [ ] terminal.app runner
- [ ] windows terminal runner
Credit
TODO