try it out

To try out TBNL, you have 2 options:

download & install it without the source code: Easy and quick to get started; but may not have the latest version; does not support further development.
build & install it with the source code: Longer to set up the first time; but easy to build against the latest version; support further development.

In both case, ensure that:

Have a sole (in the sense that adb can unambiguously find it) Android device/emulator with Android SDK 18 running.
- You might want to check out the Genymotion emulator; take a look at here or download the ARM translator directly.

All tested on Arch Linux. Other Linux'es should work. Please adapt the procedure for Windows and MacOS X.

JDK (at least JDK 6): http://www.oracle.com/technetwork/java/javase/downloads/index.html
Leiningen: http://leiningen.org/
Android SDK (SDK 18): https://developer.android.com/sdk/index.html
- Android SDK locates at under "$HOME/android-sdk/" (symlink is acceptable)
- "tools", "built-tools", and "platform-tools" can be found on $PATH
dex2jar: https://code.google.com/p/dex2jar/
GNU Make: https://www.gnu.org/software/make/

JDK (at least JDK 6): http://www.oracle.com/technetwork/java/javase/downloads/index.html
Graphviz (for the cnc.plugin.model.figurehead.visualization plugin): http://www.graphviz.org/

rm -f tbnl.tar; wget https://github.com/pw4ever/tbnl/releases/download/tryout/tbnl.tar && tar xvf tbnl.tar
cd tbnl
./install-to-guest.sh

First, clone the repo:

git clone https://github.com/pw4ever/tbnl.git
cd tbnl

One-stop shop for building source&doc, preparing for installation, and packaging:

make -j4 all

Installing figurehead on an Android device (again: make sure the device can be identified by adb unambiguously):

make install

Alternatively, you can break down the process:

make -j4 build
make -j4 doc
make prepare && make package

If you want to have a clean setup:

make clean

or more completely:

make distclean

First, make sure you have installed TBNL as above.

Let us assume we are at the directory with tbnl in it (no matter whether it is from downloading or building).

To see available plugins and their corresponding commands options, do these:

adb shell figurehead -h
tbnl/host/messenger -h
tbnl/host/mastermind -h
tbnl/host/cnc -h

For the last 3 commands, you can alternatively use java on your computer explicitly:

java -jar tbnl/host/messenger.jar -h
java -jar tbnl/host/mastermind.jar -h
java -jar tbnl/host/cnc.jar -h

Provide feedback