Kodular Starter + Companion on Linux

What is Kodular Starter?

Kodular Starter is a program that creates a server on your machine that is used by the Companion to transfer data (e.g. blocks) between the Creator and your test device.

You can check Kodular Starter status here.

What is Kodular Companion?

Kodular Companion is an app to test changes in your Kodular App Project, in real time. It can be highly valuable for prototyping, especially while building user interfaces. The app can connect to the Creator (TEST > Companion) once the Starter is running.
Note: All features might not work equally well on the Companion. It is advisable to compile an APK (EXPORT > Generate QR code for app or EXPORT > Save .apk to my computer) for thorough testing. Some components only work on compiled APKs, while some work differently for the Companion or the APK.

The Companion can be installed on Android devices from here.

How to use the Companion with the Creator running on a Linux host?

Prerequisites: To make the Companion work with a Linux host, you’ll be needing the following packages:

  • python3
  • python3-bottle
  • git

Process: In this guide we’ll be storing the Starter in ~/Kodular/, but any folder will do.

  1. $ mkdir -p ~/Kodular/
  2. $ cd ~/Kodular/
  3. $ git clone https://github.com/Kodular/Starter.git
  4. $ cd ~/Kodular/Starter/
  5. $ python3 linux.py

That’s it! You can now use the Kodular Companion for real-time testing. :smile:

Guide Test Details

Kodular Creator Version: 1.3.0
Kodular Companion Version: 1.3 Draco
Creator Host OS: Kubuntu 18.10 64-bit; Linux Kernel 4.18.0-13-generic
Companion Host OS: Android 9; Linux Kernel 3.10.108


Thanks @Kanishka_Developer. I used your guide:

Kodular Creator Version: 1.3.0
Kodular Companion Version: 1.3 Draco
Creator Host OS: Ubuntu 18.04 64-bit; Linux Kernel 4.15.0-43-generic
Companion Host OS: Android 8.1; Linux Kernel 3.10.73

Installed python 3

sudo apt install python3-minimal

Installed python bottle

sudo apt install python3-bottle

Installed Git

sudo apt install git

Phone connected and i can use starter now.


What about mac ?

1 Like

This is a guide for Linux. Maybe you can make one for Mac?

1 Like

It should work on both Mac and Linux this guide, as Mac console is quite similar to Linux one


I know this is for linux. And I asked about mac version. When it will release or any news about mac version. Got it?

Thanks. I am going to try now and i will inform you.

1 Like

thanks for this guide, i will try as soon as possible

Tested to be working with full functionality on my portable setup. Fairly amazing, because it is an Android tablet.

Kodular Creator Version: 1.3.1
Kodular Companion Version: 1.3 Draco
Creator Host OS: Android 7.1.2; Linux Kernel 3.10.108
Starter Host OS: Debian Testing (Buster) (arm7l); Linux Kernel 3.10.108; chroot
Companion Host OS: Android 9; Linux Kernel 3.10.108

Photographic Proof

1 Like

For someone who has problems with it, do not forget to install adb, the starter needs that!

Not required for wireless connection via the Companion.

Yeah, but we’re speaking of starter

i am new to this installation process on linux, i have Manjaro version of linux and i dont know how to find the packages to install.

@Kanishka_Developer can you please help me to install this.

i tried to install using terminal, but its not working for me, i gives an error - sudo: apt: command not found

what should i do.?

1 Like

Manjaro doesn’t have apt as its Package Manager. You should install Muon or Synaptic Package Manager from the app store on Manjaro, and then use that to get the packages (I recommend that since both Muon and Synaptic provide a great GUI and search function for managing packages).


I used Manjaro for a while, it is quite different form the other linux distrib.
Pacman is the package manager on majaro, so you have to use the command :

sudo pacman -S <package name>

1 Like

Hi Peter,

I’m trying install companion on linux by USB. I did your tips, but when I command python KodularStarter.py get the error:

$ python KodularStarter.py
Traceback (most recent call last):
File “KodularStarter.py”, line 13, in
ADB = get_adb_exe()
File “/home/jmc/Downloads/Starter-master/utils.py”, line 16, in get_adb_exe
pre_installed_adb_exe = shutil.which(‘adb’)
AttributeError: ‘module’ object has no attribute ‘which’

I’m not understand what is happening, could you help me?

image - - [30/Jul/2020 16:33:53] “GET /ucheck/ HTTP/1.1” 200 32
Finding device… - - [30/Jul/2020 16:33:54] “GET /ucheck/ HTTP/1.1” 200 32
Finding device… - - [30/Jul/2020 16:33:55] “GET /ucheck/ HTTP/1.1” 200 32
Finding device… - - [30/Jul/2020 16:33:56] “GET /ucheck/ HTTP/1.1” 200 32
Finding device… - - [30/Jul/2020 16:33:57] “GET /ucheck/ HTTP/1.1” 200 32

It seems that this Starter is just an interface to use the adb, it just doesn’t work in fedora, it gives the same result as when we use the starter for windows with WINE

Important : Iptables RULES

The Device is in DEBUG mode

start with python3 KodularStarter.py not only python or exec python -V to see your python version