Skip to content


Repository files navigation

Terrarium - UI Prototyping Tool for Coders


Terrarium is a cross platform QML Playground: the view renders lively as you type in the editor, makes prototyping and experimenting with QtQuick a lot more fun!

It monitors changes in its TextEdit, and triggers the view to reload source from the local http server. If you're looking for a file system watcher implementation, please refer to QML LiveReload.


Build Instructions

git clone
cd terrarium-app && git submodule init && git submodule update
qmake && make

Platform Specific Instructions

For Arch-Linux

Just go to AUR: yaourt -S terrarium-git

For Mac OSX/iOS

To add icons to iOS build, first generate and open Terrarium.xcodeproj, switch AppIcon to use Assets Catalog, then replace Terrarium/Images.xcassets/ directory with platform/ios/Images.xcassets.

As for Mac OSX, refer to macdeployqt command in file.

For Ubuntu Desktop/Phone

If you're using Qt packages from apt archive instead of releases, here's the dependencies:

sudo apt-get install qt5-qmake qt5-default qtbase5-dev qtdeclarative5-dev build-essential

All debian/ package information can be found under platform/ubuntu/ directory, copy it to current path and build the package by:

cp -r platform/ubuntu/debian .
cp platform/ubuntu/terrarium.desktop .
dpkg-buildpackage -b

If you're building click package, execute following command on device (for native compile):

cp platform/ubuntu/* .
click build .

And install it

pkcon --allow-untrusted install-local

For Android

First generate your keystore by keytool

keytool -genkey -v -keystore ../TerrariumApp.keystore -alias TerrariumApp -keyalg RSA -keysize 2048 -validity 10000


make install INSTALL_ROOT=../android-terrarium

Build and sign apk by:

~/Qt5.4.1/5.4/android_armv7/bin/androiddeployqt --input \ \
    --output ../android-terrarium --release --sign ../TerrariumApp.keystore TerrariumApp



Copyright © 2014-2015 Ping-Hsun (penk) Chen
The source code is, unless otherwise specified, distributed under the terms of the MIT License.