Kodular Starter + Companion on Linux

Kanishka_Developer · January 18, 2019, 5:32pm

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.

$ mkdir -p ~/Kodular/
$ cd ~/Kodular/
$ git clone https://github.com/Kodular/Starter.git
$ cd ~/Kodular/Starter/
$ python3 linux.py

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

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

Peter · January 18, 2019, 5:42pm

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.

Rakib_205 · January 18, 2019, 7:55pm

What about mac ?

Peter · January 18, 2019, 7:58pm

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

Diego · January 18, 2019, 8:01pm

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

Rakib_205 · January 18, 2019, 8:02pm

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

Rakib_205 · January 18, 2019, 8:03pm

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

akzashine · January 19, 2019, 4:32am

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

Kanishka_Developer · January 21, 2019, 4:21pm

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

Daaniiieel · January 21, 2019, 5:05pm

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

Kanishka_Developer · January 21, 2019, 5:43pm

Not required for wireless connection via the Companion.

Daaniiieel · January 21, 2019, 5:47pm

Yeah, but we’re speaking of starter

techcvr · March 6, 2019, 9:24pm

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.?

Kanishka_Developer · March 7, 2019, 3:39am

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).

Stiaen · August 19, 2019, 1:27pm

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>

JM_Castro · July 29, 2020, 8:04pm

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?

condigital · July 30, 2020, 9:53pm

127.0.0.1 - - [30/Jul/2020 16:33:53] “GET /ucheck/ HTTP/1.1” 200 32
Finding device…
127.0.0.1 - - [30/Jul/2020 16:33:54] “GET /ucheck/ HTTP/1.1” 200 32
Finding device…
127.0.0.1 - - [30/Jul/2020 16:33:55] “GET /ucheck/ HTTP/1.1” 200 32
Finding device…
127.0.0.1 - - [30/Jul/2020 16:33:56] “GET /ucheck/ HTTP/1.1” 200 32
Finding device…
127.0.0.1 - - [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

condigital · July 30, 2020, 9:56pm

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