Metadata-Version: 2.1
Name: ros-web-gui
Version: 0.2.6
Summary: A web gui for ROS (robot operating system)
Home-page: https://github.com/smanschi/ros_web_gui
Author: Simon Manschitz
Author-email: simon.manschitz@gmx.de
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: Flask (>=1.1.2)
Requires-Dist: PyYAML (>=5.3.1)
Requires-Dist: pydot (>=1.4.2)
Requires-Dist: rosdep (>=0.20.1)

# About
ros_web_gui is a package for visualizing the available ROS nodes, topics, parameters and service
calls in a web browser. It provides much of the functionality that is also available with
the ROS command line tools and rqt_graph, but with a graphical user interface. When running
the ros_web_gui, a flask-based webserver will be started that can be accessed on port 5000.

<table>
  <tr>
    <td><img src="doc/screenshots/01_graph.png" width="200" /></td>
    <td><img src="doc/screenshots/02_nodes.png" width="200" /></td>
    <td><img src="doc/screenshots/03_node.png" width="200" /></td>
  </tr>
  <tr>
    <td><img src="doc/screenshots/04_parameters.png" width="200" /></td>
    <td><img src="doc/screenshots/05_topic.png" width="200" /></td>
    <td><img src="doc/screenshots/06_topic.png" width="200" /></td>
  </tr>
</table>

# Installation
First, you should install ros on your machine. It is heavily recommened to use Ubuntu 20.04
or higher as ros-noetic is the first version with support for python3.

After installing ROS, you can install ros_web_gui via pip:
```
pip install ros_web_gui
```

When using the package from Github, you need the python packages pygraphviz, pyyaml and flask. So you can set up a conda env or virtual environment with

```
conda install flask pydot pyyaml rosdep
```

OR

```
pip install flask pydot pyyaml rosdep
```

After this, you should be ready to use the ros_web_gui.

# Running
When ros_web_gui was installed via pip, you can simply type `ros_web_gui` in the terminal.
When you checked out the repository you can run `scripts/run_flask.sh`. Then, go to your browser and open http://localhost:5000.

For trying out ros_web_gui, you can also run the `scripts/run_ros.sh` script which will
start a roscore together with a simple publisher and a subscriber for testing purposes.


