Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
In order to simplify its use and to make it available to restricted systems, Ardublockly does not need to be installed, just downloaded and executed.
There are two ways to run Ardublockly:
a) Executable application: Simplest method, download a zip file which contains the pre-packaged Ardublockly executable desktop software.
b) Core version: Running directly from source code, requires only Python and a modern browser (like Chrome or Firefox).
Both these methods can be run from the "pre-packaged" downloads, and the GitHub repository source code.
Download executable Ardublockly
The easiest way to use Ardublockly is to download the packaged version, which is a self-contained application that does not have any other dependencies (other than the Arduino IDE).
|Download the latest stable version from the GitHub releases page.|
Or alternatively, but not recommended, you can download the latest development builds from the links below. These are automatically generated every time code is pushed to the repository and might contain unfinished or buggy features.
|Linux (64 bit only)||Windows 7 or higher (32/64 bits)||macOS 10.10 or higher|
|Download Link||Download Link||Download Link|
For any of these and other platforms, the "core version" should work on all operating systems with Python and a modern web browser.
Run the executable Ardublockly
To run the application the steps are slightly different depending on the platform.
Windows: Double click on the
ardublockly_run.batfile located on the Ardublockly folder.
Linux: Execute the
ardublockly_run.shshell script located on the Ardublockly folder.
OS X: Right click the
Ardublockly.appfile and click
The Arduino IDE is required to compile and load the programs into an Arduino board, more information can be found in the Configure Ardublockly page.
Download Ardublockly source code
The easiest way to download a full copy of the repository is using git:
git clone https://github.com/carlosperate/ardublockly.git cd ardublockly git submodule update --init --recursive
When the repository is downloaded directly from github as zip file, the internal git submodules are not included, which is why git is the best method to download a working copy.
If you have already "git cloned" the Ardublockly source code, make sure the submodules are initialised. You can run the last git command above in the project root directory to ensure this is the case.
Download without git
If for some reason you are unable to use git, you can download Ardublockly from GitHub as zip file and the Closure library as a zip file. Uncompress the contents from the Ardublockly zip file and then unzip the Closure library into the
closure-library folder within Ardublockly (make sure there is not an additional "closure-library" nested folder inside this one).
If you also need to build Ardublockly locally (which is not necessary to run the development version), all the git submodules required are listed in the .gitmodules file in the repository.
Run "core version" of Ardublockly
This version is the main development environment for the application. You can easily run the latest updates using this method, and should be able to work if there is an issue running the packed Ardublockly application in your platform.
- Python 3: Ardublockly maintains compatibility with Python 2 and 3 (tested on 2.7 and 3.4)
- Arduino IDE version 1.6 or higher: The latest version is always recommended
- Modern browser of your choice: Currently supports Firefox, Chrome, IE10+, Opera and Safari; Chrome is recommended
- Ardublockly source code: The "Downloading Ardublockly" section details how to obtain it
Linux only requirement
Tkinter, which is used in Ardublockly, is not always part of standard Python environment on Linux and needs to be installed.
Install Tkinter for Python 2 on Ubuntu:
sudo apt-get install python-tk
OR, install Tkinter for Python 3 on Ubuntu:
sudo apt-get install python3-tk
Run Ardublockly from source code
To run the "core version" execute the
start.py python script file located on the the root of the Ardublockly folder (this also works on the "packaged" executable Ardublockly version):
Your default browser should open a local web page to load the Ardublockly application.
Run the full Ardublockly desktop application from source
To run the full desktop version of the development Ardublockly you will also need to install node.js.
Navigate to the
electron folder inside the
Execute the following command to download all the dependencies required to for the desktop application, this might take a while:
Once that's done, run the following command to open the desktop application:
The Arduino IDE is still required to compile and load the programs into an Arduino board, more information can be found in the Configure Ardublockly page.