Home

Awesome

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:

RunnerDescription
gnomerun command in a new gnome-terminal window
gnome-tabrun command in a new gnome-terminal tab
xtermrun command in a new xterm window
externalrun command in cmd.exe / gnome-terminal / xterm if possible
floatermrun command in a floaterm window
floaterm-reuserun command in a reusable floaterm window
tmuxrun command in another tmux pane
termhelprun 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

Credit

TODO