explaingit

vaddisrinivas/codecks

Analysis updated 2026-05-18

0KotlinAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A local-first Android app that turns your phone or tablet into a Mac command deck, Bluetooth trackpad, and safe automation surface.

Mindmap

mindmap
  root((Codecks))
    What it does
      Mac command deck
      Bluetooth trackpad
      Local automations
    Tech stack
      Kotlin
      Jetpack Compose
      Android
    Use cases
      Control Mac from phone
      Trackpad with gestures
      When if then automations
    Audience
      Mac and Android users
      Privacy conscious users
    Notes
      Apache-2.0 license
      No account required
      Public beta APK release

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Control a Mac from an Android phone or tablet using large command buttons instead of memorizing shortcuts.

USE CASE 2

Use an Android device as a Bluetooth trackpad with gestures for a connected Mac.

USE CASE 3

Set up local when-if-then automations that run Mac commands based on chosen triggers.

USE CASE 4

Draft custom automations with optional AI assistance while keeping every generated action disabled until reviewed.

What is it built with?

KotlinJetpack ComposeAndroid

How does it compare?

vaddisrinivas/codecksandroosio/thortuneazcomp2000/battery-sentinel
Stars000
LanguageKotlinKotlinKotlin
Setup difficultymoderateeasymoderate
Complexity2/52/52/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires enabling Remote Login on the Mac and pairing a Bluetooth connection for trackpad features.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Codecks turns an Android phone, tablet, or a Samsung DeX window into a second screen for controlling a Mac. Instead of trying to remember keyboard shortcuts, you get a set of large command buttons, a Bluetooth trackpad with gestures and scrolling, and automation recipes that run when a chosen event happens. Everything is local first, meaning there is no account to sign up for, no company server storing your data, and no analytics or advertising tracking built in. The command deck covers everyday Mac actions like opening Finder or Terminal, switching between Spaces, controlling media playback, taking screenshots, and managing browser tabs, alongside custom commands you set up yourself. The trackpad acts as a real Bluetooth pointer with support for gestures, haptics, and screen rotation. Automations follow a simple when, if, then structure, and the app lets you test a new automation before turning it on for real use. There is also an optional AI assisted feature that can draft new buttons or automations for you, but anything it generates stays switched off until you personally review and enable it. Because this app can run commands directly on a connected Mac, the README spends real attention on safety. Built in command templates are limited to an approved list, risky shell command patterns are blocked outright, SSH connections use pinned host keys, and any optional AI API keys are stored encrypted on the device. The author recommends using a non-admin Mac account and reviewing every custom command before turning it on. This project suits Mac and Android users who want a physical style control surface for their computer without handing data to a cloud service. It is currently a public beta, distributed as a signed APK you install directly from GitHub releases rather than through an app store, and it requires Remote Login enabled on the Mac plus a paired Bluetooth connection for trackpad features.

Copy-paste prompts

Prompt 1
Walk me through installing Codecks on my Android device and connecting it to my Mac.
Prompt 2
Explain the safety model in this README, like the command allowlist and SSH host key pinning.
Prompt 3
Help me set up Remote Login on my Mac so Codecks can control it.
Prompt 4
What kinds of when-if-then automations could I build with this app for my daily Mac workflow?

Frequently asked questions

What is codecks?

A local-first Android app that turns your phone or tablet into a Mac command deck, Bluetooth trackpad, and safe automation surface.

What language is codecks written in?

Mainly Kotlin. The stack also includes Kotlin, Jetpack Compose, Android.

What license does codecks use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codecks to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codecks for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.