muxnect 0.2.4

Quick Introduction

A bare-bones method to muxnect any interactive CLI tool:

$ muxnect -w <tmux_window_name> -c <some_interactive_tool>

Now just nail up some POST requests to http://localhost:6060/muxnect/tmux_window_name

Let’s try using Python:

>>> import requests
>>> url = 'http://localhost:6060/muxnect/<tmux_window_name>'
>>> requests.post(url, data={'keys': 'wonderful keystrokes'})
<Response [200]>

That’s it, our web server just sent wonderful keystrokes to <some_interactive_tool>.

Examples

Okay, that probably left you confused.

Here are some cool examples to cover up:

$ muxnect -w hello_world -c python

>>> import requests
>>> url = 'http://localhost:6060/muxnect/hello_world'
>>> hello_world = 'print("Hello World!")'
# send return key after it is done sending `keys`
>>> requests.post(url, data={'keys':hello_world, 'enter':'true'})
<Response [200]>

# send KeyboardInterrupt after sending keys
>>> requests.post(url, data={'keys':'send Ctrl+c; C-c', 'separator':'; '})
<Response [200]>
# separator will split keys to preserve any special keys
# here it will send "send Ctrl+c" and then immediately "C-c" (Ctrl+c, KBInterrupt)
# you can use any number of separator blocks in `keys` param

# try similar code without using separators
>>> requests.post(url, data={'keys':'no Ctrl+c; C-c'})
<Response [200]>
# note how it sends raw keys directly

# send return key and EOF (Ctrl+d) to end our python session
>>> requests.post(url, data={'keys':'Enter; C-d', 'separator':'; '})
<Response [200]>

$ muxnect -w playback -c "mpv --loop-file https://github.com/mediaelement/mediaelement-files/raw/master/big_buck_bunny.mp4"

>>> import requests
>>> url = 'http://localhost:6060/muxnect/playback'
# space key pauses the video in mpv by default
>>> requests.post(url, data={'keys':' '})
<Response [200]>
# kill this tmux window
>>> requests.post(url, data={'kill':'true'})
<Response [200]>

Syntactic Sugar

muxnect also provides a simple API for Python to make POST requests:

>>> import muxnect
>>> url = 'http://localhost:6060/muxnect/cute_cli'
>>> client = muxnect.Client(url, default_data={'enter':'true'})
>>> client.send('type this, press enter and kill session', data={'kill':'true'})

Installation

You must have tmux installed to use this. You may have to install it from source, if it ain’t in your apt repositories.

muxnect works best with Python 3.

Install the latest stable release from pypa:

$ pip install muxnect

Or install the latest development version:

$ git clone https://github.com/ritiek/muxnect
$ cd muxnect
$ python setup.py install

Usage

usage: muxnect [-h] -c CMD -w WINDOW_NAME [-d] [-s SESSION_NAME]
                 [-b BIND_ADDRESS] [-p PORT]

Send input to just about any interactive command-line tool through a local web
server

optional arguments:
  -h, --help            show this help message and exit
  -d, --detach          detach from ongoing session (default: False)
  -s SESSION_NAME, --session-name SESSION_NAME
                        tmux's session name (default: muxnect)
  -b BIND_ADDRESS, --bind-address BIND_ADDRESS
                        address to bind on, local network: 0.0.0.0 (default:
                        127.0.0.1)
  -p PORT, --port PORT  port number to listen on (default: 6060)

required arguments:
  -c CMD, --cmd CMD     interactive command to send input to (default: None)
  -w WINDOW_NAME, --window-name WINDOW_NAME
                        tmux's window name (default: None)

The URL is generated in the form:

http://<hostaddress>:<port>/<session_name>/<window_name>

The POST request can take the following parameters:

keys - mouse events/keystrokes to send (Default: None)
separator - split `keys` parameter on a character or string (Default: None)
enter - send enter key immediately after sending `keys` (Default: False)
kill - kill tmux window after proceeding with any other params (Default: False)

Security Note

Since there is no way to authenticate at the moment, please use this tool only on systems (and local networks) you completely trust. If an attacker somehow gets to know the URL muxnect is listening on, nothing stops them from running arbitrary shell commands and completely mess you up. Please take care!

Extending Further

Ever wanted to control that movie running on your laptop but is placed meters away from you? Well, now you can with an android app such as HTTP-Shortcuts (built by @Waboodoo) which can be used to create custom HTTP requests.

We’ll leave the rest to you :)

Why muxnect though?

tmux + connect = muxnect :heart:

License