Thanks to visit codestin.com
Credit goes to Github.com

Skip to content
/ deq Public

Homelab control plane with native Android app, Wear OS, and Android Auto. SSH-based control from a dashboard. Single Python file. Zero dependencies. Dynamic config. No YAML.

License

Notifications You must be signed in to change notification settings

deqrocks/deq

Repository files navigation

DeQ

Your homelab under control. From anywhere.

A single Python file providing SSH-based control via a web interface, connected to a native Android app, Wear OS, and Android Auto.

Zero dependencies. Dynamic config. No YAML.

DeQ Hero

Website · Documentation · FAQ · Press Kit · Patreon

Table of Contents

Features

  • Onboarding – Automatic device and container population
  • Native Android App - Background monitoring, push notifications, widgets, Android Auto, Wear OS
  • DeQ Nodes - Devices with app connect to a node network that can WOL your server when you're not at home
  • Device Control - Wake-on-LAN, shutdown, suspend, Docker start/stop
  • Device Monitoring - CPU load, temp, SMART... with alarm thresholds
  • File Manager - Dual-pane browser, copy/move/upload between devices
  • Scheduled Tasks - Wizard guided automated backups, wake, shutdown, and scripts
  • Extension API - Write Python extensions. Build custom GUIs. Make DeQ whatever you need.
  • HTTP API - Connect Home Assistant, Tasker, or build your own automations
  • Theming - Custom colors, wallpapers, transparency effects
  • Quick Stuff - Bookmark and script runner buttons with support for Lucide, Dash...
  • PWA Support - Install as app on any device
  • Admin Auth - Adds an additional security layer

Concept

Ambitions

  • Less, but better. Lateral thinking over complexity.
  • Use what’s there. Move fast. Make it useful.

DeQ is an ultra-lightweight network control layer that exposes the raw power of SSH on mobile devices — without unnecessary abstraction.

Architecture

At the core of DeQ is a single Python file: server.py. It lives on your server and acts as the entire control layer.

What makes it powerful — yet lightweight — is its restraint. DeQ is essentially SSH commands wrapped in a thin, vanilla Python shell. There are no dependencies beyond Linux and Python. The same file serves a dashboard-like web interface. It is mobile-first, responsive, and accessible from any browser.

We deliberately restrict server.py to a maximum size of 500 KB. It currently sits at around 350 KB. A typical fresh installation, managing a few devices, containers, and tasks, uses roughly 20 MB of RAM and virtually no CPU.

Connectivity

The native Android app, Android Auto, and Wear OS sync directly with server.py. The server, in turn, connects to your host and other network devices via SSH.

DeQ is not a dashboard. DeQ is a control layer disguised as a dashboard. It is a well-connected control layer with access to core homelab functions such as Wake-on-LAN, task scheduling, and file management — as well as sensors and context from your mobile devices.

For example, the Android app can automatically put selected containers or servers to sleep when you plug in your phone at night — and wake them again when you unplug it in the morning.

Your Control Layer

The core remains lean. How you extend it is up to you.

HTTP API connects Home Assistant, Tasker, or your custom scripts. Extension API lets you write Python that adds custom sections to the web interface. Drop shell scripts into /opt/deq/scripts/ for quick automation.

DeQ provides the infrastructure. You build what you need.

DeQ Connectivity

Free Android App

Push notifications · Full web interface

Native companion app with background monitoring and push notifications when devices go offline, containers stop, or backups fail. Ad-Free

DeQ Free on Google Play Free APK on GitHub

Paid Android Pro App

Ambient Mode with BCD clock

DeQ Pro adds powerful automation and visualization features. Your purchase keeps this project alive as a full-time effort.

Feature Description
Widgets 5 widget styles for home and lock screen
Live Wallpaper Animated status display as background
Ambient Mode Wall-mount display with BCD clock, OLED optimized
Android Auto Homelab status in your car
Wear OS Watch app, tile, and complications
Sleep With Me Homelab sleeps when you sleep

Sleep With Me: Plug in to sleep · Unplug to wake

Android Auto integration

Wear OS app · Quick tile

DeQ Pro on Google Play

Installation

wget https://github.com/deqrocks/deq/releases/latest/download/deq.zip
unzip deq.zip -d deq && cd deq
sudo ./install.sh

The installer asks a few questions and gives you your access URL.

Full setup guide: deq.rocks/documentation

Screenshots

User onboarding wizard

Dual-pane file manager (desktop)

Dual-pane file manager (phone)

Task scheduler

Desktop PWA

License

CC BY-NC 4.0 - Free for personal use, no commercial use without permission.

Credits