Skip to main content

Client to handle micropython web_repl interactively

Project description

Build Status


Python module to handle micropython websocket (WS) repl protocol interactively. It is modified original implementation to make it more user friendly.


It should work with python3 with simple pip commands:

pip install iwebrepl


Few webreplcmd examples:

iwebrepl --host --password ulx3s

Note that you can also specify basic parameters using environment variables:

export IWEBREPL_PORT=8266

and then you can just specify command:


All options are listed using --help:

iwebrepl --help


usage: iwebrepl [-h] [--host HOST] [--time TIME] [--port PORT] [--verbose]
                [--debug] [--redirect] [--password PASSWORD] [--cmd CMD]
                [--after AFTER] [--before BEFORE]

iwebrepl - connect to websocket webrepl

optional arguments:
  -h, --help            show this help message and exit
  --host HOST, -i HOST  Host to connect to
  --time TIME, -t TIME  Delay time to receive response
  --port PORT, -P PORT  Port to connect to
  --verbose, -v         Verbose information
  --debug, -d           Enable debugging messages
  --redirect, -r        Redirect
  --password PASSWORD, -p PASSWORD
                        Use following password to connect
  --cmd CMD, -c CMD     command to execute
  --after AFTER, -A AFTER
                        command to execute after interactive mode
  --before BEFORE, -B BEFORE
                        command to execute before interactive mode

iwebrepl --host --password ulx3s
iwebrepl --host --password ulx3s --cmd 'import os; os.listdir()'

Keyboard: Ctrl-x to exit, Ctrl-d softreboot, Ctrl-k display help

Keyboard shortcuts

You can use following keyboard shortcuts:

Custom keybindings:
- CTRL-x : to exit WebREPL Terminal
- CTRL-e : Enters paste mode
- CTRL-d: In normal mode does a soft reset (and exit), in paste mode : executes pasted script
- CTRL-c : Keyboard interrupt in normal mode, in paste mode : cancel
- CTRL-r: Backsapce x 20 (to erase current line in chunks) or flush line buffer
- CTRL-u: import shortcut command (writes import)
- CTRL-f: to list files in cwd (ls shorcut command)
- CTRL-n: shows mem info
- CTRL-y: gc.collect() shortcut command
- CTRL-space: repeats last command
- CTRL-t: runs if present
- CTRL-w: flush test_code from sys modules, so it can be run again
- CTRL-a: force synchronized mode (better if using wrepl through ssh session)
- CTRL-p: toggle autosuggest mode (Fish shell like) (if not in synchronized mode)
- CTRL-k: prints the custom keybindings (this list)

Complete Requirements

It should work with python3 with simple pip commands:

sudo apt-get update
sudo apt-get install -y python3 python3-pip
sudo pip3 install iwebrepl

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for iwebrepl, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size iwebrepl-0.2.0.tar.gz (6.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page