Skip to content
Leo Wehrfritz edited this page Sep 8, 2025 · 2 revisions

Overview and basic concept

Equilibrium is a hub-based universal remote, designed to work like Logitechs Harmony series. This means that you configure devices and scenes ("Activities" in Harmony).

  • A device represents a single device in your media cabinet, like a TV, Bluray player or Soundbar.
  • A scene represents an activity you want to perform, like "Watching a Bluray" and contains a start- and stop-sequence of actions (like turn on tv, switch to input HDMI 3, turn on Bluray player).
  • The remotes button mappings change depending on the current context (like the navigation buttons controlling the Bluray player during the "Watch Bluray" scene and the TV during the "Watch TV" scene)

Important Considerations

  • Equilibrium is a hobby project. Some things may not work as expected or at all and I can't provide support like the manufacturer of a commercial product would.
  • If you're looking for something hackable that is open source and runs completely local, Equilibrium may be just the thing for you.
    If you're looking for a stable, off-the-shelf solution, you should look elsewhere.
  • The setup and usage of this project requires at least basic knowledge of the linux command line and Python.
  • If you encounter bugs or any other issues, please create an issue
  • If you want to discuss anything about the project or suggest a feature, use the discussions section

Layout

The wiki is divided in three sections:

  1. Hardware-Setup which will guide you through the required hardware and how it should be configured/connected.
  2. Software-Setup which will guide you through the initial installation of Equilibrium on your hardware
  3. Usage which will explain the key concepts of using Equilibrium

Clone this wiki locally