Skip to content

Accessible UI-driven programming for your product

License

Notifications You must be signed in to change notification settings

jetspiking/Roblocks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Github All Releases License Stars

Accessible GUI-driven programming for your product

Description

Roblocks aims to be an accessible Graphical Programming Tool which enables programming for everyone. By configuring an outgoing JSON-protocol and recognizing this, you can link the Roblocks-GUI to your robot or product. This enables other people to control your product, while hiding your back-end and complicated code. This makes the product an option for expositions and educational purposes (to let people create programs in a more accessible way). Roblocks is especially suitable for IoT-projects and robotics, since custom JSON-messages can be used to execute your desired action(s).

Overview

Installation

Navigate to the releases tab, i.e. Releases

From here you can download Roblocks for Mac OS, Windows, Linux and Android. Launch the executable to startup Roblocks, it should work out of the box.

The application has been verified to run on Apple Silicon (M1).

If you are using Mac OS you might get a message that you can not open the application, because you don't have the permissions or it would be corrupt. You can fix this by opening terminal and executing the following command:

xattr -d com.apple.quarantine /path/to/roblocks.app

After the installation create your toolbox configuration .json file, as the example displayed here.

Usage

Add / Remove Node(s)

Select the Visual Edit window (center) and click the "add (+)" button. To remove a Node, select it (click), and click the "remove (-)" button.

Add / Remove Operation(s)

Select a node (click) and click the "add (+)" button. To remove an operation, select it (click), and click the "remove (-)" button.

Configure Operation(s)

Click on an operation inside a node and click the "settings" icon.

Compile to .json file

Click on "File", "Save Project" to save your project to the selected location on your disk.

Change read / write location

Click on the app logo "RB", "Preferences" to adjust the paths for reading and writing. After closing the window the toolbox.json will be reloaded, if no previous file was loaded.

Hiding / Showing views

Click on "View" and select the windows you would like to show / hide.

Log

A more detailed log can be viewed by navigating to "View" and click on "Expand log".

Configuration (Roblocks Protocol)

Documentation

Help

Need help and don't know where to start? Feel free to open an issue. Describe your project, use-case(s) and issues so we can attempt to support and help you out as good as possible.

Building

This section is inapplicable if you just want to use the application, and not tweak the Source code.

The application has been built using IntelliJ Community Edition and uses the libraries gson-2.8.6 and json-simple-1.1.1. Make sure to include these as libraries using your prefered methods.

Contributors

Huge thanks to Jascha Huisman (@jaschahuisman) for creating awesome banners and actively sharing a lot of feedback and ideas for Roblocks.

Thank you for using Roblocks

If you enjoy Roblocks and feel like it's an improvement and you want to support me, you could consider buying me a drink by navigating to my Buy Me A Coffee account.

Buy Me A Coffee