+
+[![tio](images/tio-icon.png)]()
+
# tio - a simple serial device I/O tool
-[![](https://img.shields.io/circleci/build/gh/tio/tio?token=da7e7fd0d0ee99b9f986f8877dcdbe28f73d9e06)](https://circleci.com/gh/tio/tio/tree/master)
+[![](https://img.shields.io/circleci/build/github/tio/tio)](https://circleci.com/github/tio/tio/tree/master)
[![](https://img.shields.io/github/v/release/tio/tio?sort=semver)](https://github.com/tio/tio/releases)
[![](https://img.shields.io/repology/repositories/tio)](https://repology.org/project/tio/versions)
[![](https://img.shields.io/tokei/lines/github/tio/tio)](https://github.com/tio/tio)
* Easily connect to serial TTY devices
* Automatic connect and reconnect
- * Sensible defaults
+ * Sensible defaults (115200 8n1)
* Support for non-standard baud rates
* Support for RS-485 mode
* Support for mark and space parity
* Visual or audible alert on connect/disconnect
* Remapping of prefix key
* Man page documentation
+ * Binary size less than 80kB
* Plays nicely with [tmux](https://tmux.github.io)
## 3. Usage
Install latest stable version:
```
-$ snap install tio
+$ snap install tio --classic
```
+Note: Classic confinement is currently required due to limitations of the snapcraft framework.
+See [Issue #187](https://github.com/tio/tio/issues/187) for discussion.
+
### 4.3 Installation using brew (MacOS, Linux)
If you have [brew](http://brew.sh) installed:
Install steps:
```
-$ meson build
+$ meson setup build
$ meson compile -C build
$ meson install -C build
```
Note: The meson install steps may differ depending on your specific system.
+### 4.6 Known issues
+
+Getting permission access errors trying to open your serial device?
+
+Add your user to the group which allows serial device access. For example, to add your user to the 'dialout' group do:
+```
+$ sudo usermod -a -G dialout <username>
+```
+
## 5. Contributing