Dikciz Launcher

Dikciz Launcher

*yes, it's dick cheese*

Dikciz is a programmable Android home screen. Build pages from HTML widgets, native app shortcuts and Android widgets, write Lua or background JavaScript automations, and control your phone through WebSocket, MCP or HTTP over USB, Wi-Fi or Tailscale.

Your home lives in editable files under /sdcard/Dikciz/. The signed release includes scripting, inspection and remote control. Ordinary launcher control needs neither a debug build nor root. Android permissions govern access to the rest of the phone.

Who this is for

TL;DR: Your phone, your controls. Dikciz is for developers, tinkerers and anyone who wants to program their phone: build a home screen in HTML/CSS/JavaScript, automate events with Lua or JavaScript, and let their own AI use the phone through MCP.

Also for goblins who want their phone to say "peen goes in vageen", flash the torch like Christmas and play alien noises. Speech, audio, lights and SMS are programmable too. Build something useful, something ridiculous, or both.

You choose the model provider, scripts, permissions and network access. The built-in assistant and external clients use the same phone tools. Android's permission and hardware limits still apply.

Current four-page starter on the emulator, with live London weather, sample calendar entries, a saved voice note and a configured battery level. Device counters reflect what Android exposes to the app.

Contents

Install it

Download the signed dikciz-launcher-vX.Y.Z.apk from GitHub Releases, or add https://github.com/psyb0t/dikciz-launcher to Obtainium for updates. On the phone, open obtainium://add/https://github.com/psyb0t/dikciz-launcher to add it directly. Dikciz is not published through Google Play.

1. Install the APK and open Dikciz. For an ADB installation, use adb install -r dikciz-launcher-vX.Y.Z.apk.
2. Choose Dikciz as Android's default Home app.
3. Tap Grant file access, allow shared-storage access in Android, and return to Dikciz. It creates the starter home in /sdcard/Dikciz/.
4. Open Settings, Getting started for Android access, widget templates, assistant setup and remote control. Choose Review Android access for features that need additional grants. You choose which permissions and special access to grant. Cross-app UI control needs Dikciz cross-app automation enabled in Android Accessibility settings.

Dikciz reopens after an APK update when it is the default Home app or has Draw over other apps access. If Android prevents automatic reopening, tap the Dikciz updated notification or open the app. This also restarts the remote listeners. See update recovery.

Release packages use eu.psyb0t.dikciz.launcher; debug packages use eu.psyb0t.dikciz.launcher.debug and install alongside them. Updates signed with the same key retain app data. Each release includes an APK checksum. Verify the signer with apksigner verify --print-certs dikciz-launcher-vX.Y.Z.apk; its certificate SHA-256 fingerprint is:

5F:A2:02:5D:F9:B8:31:C3:56:3E:8D:44:00:88:7A:77:61:86:F1:F6:F4:69:4E:4E:41:04:EF:CF:0E:20:75:15

What the home supports

• Native pages arranged across two axes, each with a fixed grid, stable identity and configurable layout.
• Local HTML, CSS and JavaScript widgets with persistent state, events and the window.dikciz bridge.
• Custom apps with complete editable HTML/CSS/JavaScript interfaces, Lua or JavaScript backends, independent state, event subscriptions and native timers.
• Native app shortcuts, app groups and third-party Android AppWidget providers.
• Lua and background JavaScript scripts with event subscriptions, typed actions, owner command access and a native script dashboard. Enable only trusted scripts; their command access includes files and shell.
• Themes, fonts, wallpaper, widget appearance, editing locks and a chosen Android Home destination.
• Semantic UI inspection, screenshots, logs, configuration editing and device actions through the remote APIs.

The starter combines everyday launcher controls with programmable widgets. Home has clock/weather, app icons ranked by optional usage history, and native Phone, Camera, Settings and app-store shortcuts along the bottom. Tools has agenda and voice notes. Device has a live battery gauge, memory/storage bars and CPU charts. Tap the home quick actions for a short torch pulse sequence or speech; neither starts automatically. Each HTML document remains separately editable. The HTML library offers complete editable WebView templates, including system metrics and BTC/USD with economic news. Save customized documents to reuse them. Six Lua examples start disabled, including GPS London announcements, outdoor heat commentary and speed warnings. The Goblin page adds tap-operated speech, torch pulses and alien sounds. The complete bundled catalog describes every template and script. See the starter home guide.

Bundled widgets and scripts

The nineteen complete HTML templates cover Time and weather, Most used apps, Agenda, Voice notes, Device status, Goblin control, Home dashboard, System dashboard, Live sensors, BTC and economic news, Clock and search, Find an app, Quick note, Android app settings, Android display settings, Lock screen, Post a notification, Dikciz diagnostics and Vehicle console. Add copies from the widget picker and edit their full HTML, CSS, JavaScript and saved state. The complete catalog explains every template and its data sources.

Six Lua examples ship disabled: Low battery reminder, Unplug at 80 percent, Lock screen on demand, Goblin London, Goblin heat and Goblin speed. The goblin rules announce London arrival, complain above 35 Celsius outdoors, and yell above 80 km/h GPS speed. Their saved cooldowns and rearm thresholds prevent constant repetition. The Goblin page lets you preview the voices, say "peen goes in vageen", flash the torch and play synthesized alien sounds. Enable scripts individually in Settings; read triggers, permissions and weather setup.

Navigate and manage the home

Tap the Dikciz mark beside the bottom page rail for the app drawer, widgets, page management and Settings. Swipe up from that rail to open the app drawer. Tap the magnifier to find a page by name or address. A full page refuses another widget rather than overlapping existing items.

The illustrated user guide walks through pages, apps, groups, provider widgets, moving and resizing items, appearance, scripts and recovery.

Chat with your phone

Tap the cheese beside the launcher controls for an on-device assistant. Add an OpenAI-compatible or Anthropic-compatible provider connection once, choose models from its API-backed chat dropdown, keep independent model/token/reasoning settings for each conversation, and let it discover the same phone MCP tools used by external agents. Read-only mode hides mutating tools and blocks direct write calls in the executor. The panel streams Markdown, expands from half screen, and can hide while the agent uses another app. Its quiet Open chat notification also opens it over any app while the assistant is idle. Event rules can wake a conversation in the background. A live notification shows its activity, reopens the exact chat on a tap and offers Stop. SQLite keeps full transcripts; choose old-exchange trimming or summary compaction with an output reserve. Use Make me a widget to generate a complete widget on the current page, or Explain this screen to capture the screen behind chat and ask for a read-only explanation. Read chat setup and controls.

Safety, journeys and devices

Open Settings, Safety, journeys and devices for inactive contact plans, opt-in missed check-ins/SOS, geofences, recorded routes, retained Bluetooth/USB/NFC connections, image OCR/barcodes/PDFs, Health Connect records and Android-approved Wi-Fi flows. All use the shared phone APIs. Read the setup and limits before enabling background work. The optional Vehicle console template reads a paired ELM327 adapter. Chat also offers five read-only routines.

Dikciz, Apps opens complete editable apps. SOS is an ordinary bundled app whose message/check-in logic lives in /sdcard/Dikciz/apps/sos/main.js, beside its HTML/CSS/JavaScript UI and state. Voice notes, Agenda, Device status and Travel todo also ship as independent apps. Each app has its own Android task and Recents entry, without a manager toolbar. Create or import your own. Apps share the Android access