Skip to content

Getting started

Jump to bottom
Daniel Stock edited this page Jan 5, 2018 · 7 revisions

Contents

The desktop

The screenshot shows the Tooloop OS desktop in all it’s glory. Yup, that’s all of it :-)
By the way, this is also a screenshot of the boot process.

There is however one more thing. Move your mouse, trust me, it’s there. A tool called unclutter hides the cursor while not used.

Now click into the background. This will open the only thing, the desktop has for you, the menu.

That’s pretty much it. Remember, Tooloop OS is meant to get out of the way.

There’s some terminal commands and shortcuts if you’re curious.

Tooloop Settings Server

It’s the settings app of Tooloop OS and as such can be used to easily manage and configure your machine.

It’s called a server, because it’s a also web application. You can open it in a browser on any machine in the network. It also has an extensive REST API so it can be integrated in other tools (think managing many boxes) in the future.

You can open it

  • from the desktop menu
  • with the terminal aliases tooloop-settings
  • by typing the IP address of your box in a browser on another machine

It’s still lacking documentation but it provides some cool features and it also has a plugin interface so you can add controls for you own app right into the settings server.

Have a look at its’ GitHub repo.

Install optional stuff

Tooloop OS ships a script, that helps you install some additional stuff, you might or might not want to have.
You can launch it either using the right click menu under tools→Install stuff or by typing in a terminal:

sudo tooloop-install-optional-stuff

You will be asked for your password.

Copying files

The easiest way to copy files on the machine is using an SFTP browser like FileZilla or Cyberduck.

You will find a volume mounted at /assets. That’s the space to put all your files. It contains five folders:

/assets/presentation/    # put your app here
/assets/data/            # put your images, videos, etc. here
/assets/screenshots/     # screenshots will be saved here
/assets/logs/            # log files, well if your app saves ’em here
/assets/apps/            # app bundles that are locally available to install through the settings server

Develop your own app

You want to develop an app of yourself – cool, that’s what Tooloop is for :-)
Simply follow some conventions and it will behave as a first class citizen on Tooloop OS.

You application should live in /assets/presentation/.

Tooloop OS uses two scripts to start, stop or restart the app.

/assets/presentation/start-presentation.sh
/assets/presentation/stop-presentation.sh

Whatever command is needed to start or stop your app, put it in there.

These scripts are called from

  • the desktop menu
  • the terminal aliases tooloop-presentation-start and tooloop-presentation-stop
  • the settings server

Openframeworks

You can install openframework using the optionals installer.

Copy your app (i.e. the bin/ folder of your openframeworks project) over to /assets/presentation/<YOUR_PROJECT>.

Run your application, e.g.

/assets/presentation/<YOUR_PROJECT>/<YOUR_APPLICATION>

Processing

You can install Processing using the optionals installer.

Run your application, e.g.

/assets/presentation/processing-x.x.x/processing-java --sketch=/assets/presentation/processing-3.0.2/modes/java/examples/Demos/Graphics/Planets --present

Obviously you'll have to change the processing version in the example.

Kivy

You can install Processing using the optionals installer.

Run your application, e.g.

python /assets/presentation/kivy-examples/demo/showcase/main.py

or

python /assets/presentation/<YOUR_PROJECT>/<YOUR_APPLUCATION>.py

Clone this wiki locally