explaingit

d4vinci/humax-cli

Analysis updated 2026-07-10 · repo last pushed 2019-02-02

10PythonAudience · vibe coderComplexity · 2/5DormantSetup · easy

TLDR

A command-line tool that lets you control a Humax IR4000HD satellite receiver from your computer terminal by sending network messages over Wi-Fi, replacing the physical remote.

Mindmap

mindmap
  root((repo))
    What it does
      Sends remote commands via Wi-Fi
      Single button or sequences
      Loop button presses
    Use cases
      Automate channel switching
      Script recording sequences
      Exclusive control via jam
    Tech stack
      Python 2 and 3
      Terminal only
    Audience
      Hobbyists and tinkerers
      Home automation fans
      Command line lovers
Click or tap to explore — scroll the page freely

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 Humax satellite receiver from the terminal instead of using the physical remote.

USE CASE 2

Script a sequence of button presses to turn on the device, switch channels, and start recording with one command.

USE CASE 3

Loop a button press repeatedly to cycle through channels automatically on a schedule.

What is it built with?

PythonPython 2Python 3

How does it compare?

d4vinci/humax-clialsgur9865-sketch/second-brain-enginecompumaxx/gba-video-studio
Stars101010
LanguagePythonPythonPython
Last pushed2019-02-02
MaintenanceDormant
Setup difficultyeasymoderatehard
Complexity2/53/54/5
Audiencevibe coderdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires knowing the IP address of your Humax IR4000HD receiver on your local network.

In plain English

Humax-CLI lets you control a Humax IR4000HD satellite receiver from your computer's terminal instead of using the physical remote or the official mobile app. You type simple text commands, and the receiver responds just as if you'd pressed a button on the remote. This is handy if you've lost your remote, if you prefer keyboard control, or if you want to automate something like cycling through channels on a schedule. The tool works by sending network messages to the receiver over your local Wi-Fi. The author figured out the communication protocol by reverse-engineering the official Android app, then rebuilt it as a lightweight command-line tool. You provide the receiver's IP address, specify which buttons to "press," and the script handles the rest. You can send a single button press, a sequence of buttons, or even loop a button to fire repeatedly every half second. Who would use this? Anyone with this specific Humax receiver model who wants terminal-based control. For example, you could script a sequence to turn the device on, switch to channel 5, and start recording, all with one command. It also includes a "jam" feature that blocks other connections to the receiver, which could be useful if you want exclusive control while a script runs. Hobbyists who enjoy automating home entertainment setups or who prefer doing everything from the command line would find this appealing. The project exposes an extensive list of button codes far beyond the basic volume and channel controls, covering everything from colored remote buttons to teletext and disc tray operations. Notably, the README doesn't detail the security implications of the jam feature or the reverse-engineering process, though it mentions a write-up is coming. The tool works with both Python 2 and 3, requiring only a terminal to run.

Copy-paste prompts

Prompt 1
Write a Python script that uses humax-cli to turn on my Humax receiver, switch to channel 5, and start recording, all in one command sequence.
Prompt 2
Help me set up a scheduled task that runs humax-cli every day at 8pm to switch my Humax receiver to a specific channel.
Prompt 3
Show me how to use the humax-cli jam feature to block other connections while my automation script runs, then release control afterwards.

Frequently asked questions

What is humax-cli?

A command-line tool that lets you control a Humax IR4000HD satellite receiver from your computer terminal by sending network messages over Wi-Fi, replacing the physical remote.

What language is humax-cli written in?

Mainly Python. The stack also includes Python, Python 2, Python 3.

Is humax-cli actively maintained?

Dormant — no commits in 2+ years (last push 2019-02-02).

How hard is humax-cli to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is humax-cli for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.