Creating a Keecker app


This page will guide you through writing your first app that will run on Keecker. It will be very simple and just switch between projecting on the wall and projecting on the ceiling every 5 seconds. Let’s get started!


Writing the app

Now that we’re all setup, let’s get started writing an application for Keecker!

  1. In Android Studio, create a new application with an empty Activity. The only important part here is on the “Target Android Devices” page, select “Android TV” with the default API level.

    SDK 22 selection for Keecker

  2. Add the JitPack repository in your root build.gradle at the end of repositories:

        allprojects {
            repositories {
                maven { url '' }
  3. In your application module build.gradle file, add the latest release from JitPack:

        dependencies {
            implementation 'com.github.keecker:services-api:0.2.0-alpha'
  4. Sync gradle

  5. In your main AndroidManifest.xml, add the following permission to be allowed to move the projector:

        <uses-permission android:name="com.keecker.permission.PROJECTION" />
  6. Then add the code that will actually move the projector in your activity:

    class MainActivity : Activity() {
         override fun onCreate(savedInstanceState: Bundle?) {
             GlobalScope.launch {
                 val projector = ProjectorClient(applicationContext)
                 while (true) {
                     projector.setState(ProjectorState(orientation = 0))
                     projector.setState(ProjectorState(orientation = 90))
  7. Connect a USB cable between your computer and Keecker using the port located below Keecker, at the back

  8. Build and install your app on Keecker, using Android Studio

  9. Click on accept on Keecker

  10. Watch the projector wobble