🌩️LNXlink
Effortlessly manage your Linux machine
Welcome
LNXlink is a Home Assistant companion app for Linux that bridges the gap between your PC and your smart home ecosystem. By leveraging MQTT and Autodiscovery, it allows you to monitor system stats and trigger remote commands in real-time with zero manual entity configuration.
Features
Automated Sensors: Discovers and exposes system metrics and controls automatically.
MQTT Autodiscovery: Integrates instantly with Home Assistant with update notifications.
Lightweight: Built to run with minimal system dependencies.
Extensible: Supports a modular architecture; easily import or create custom modules.
Supported Modules
🧮 Graphical Interface
📢 Notify
Send rich desktop notifications via notify.send_message. Usage
📂 Open URL/File
Launch files or websites remotely using the xdg-open command. Usage
🚥 Keep Alive
Prevent monitor sleep or idle states using xset or gsettings.
⌛ Idle time
Monitor user inactivity duration with a dedicated sensor.
🎶 Media
Track playback status, metadata and media control. Setup
🔆 Brightness
Adjust display luminance globally or for individual monitors via number entities.
💡 Screen On/Off
Toggle monitor power states using the xset command.
⛶ Fullscreen
Detect if a window is currently in fullscreen mode and view its name.
📸 Screenshot
Stream your desktop directly to Home Assistant via a camera entity.
🎧 Audio Select
Switch between available speaker or microphone input devices.
⌨️ Keyboard Hotkeys
Capture specific keypresses for automation triggers. Settings
🖱️ Mouse control
Simulate mouse movement and actions. Works with the LNXlink Touchpad Card.
🔑 Send Keys
Broadcast keystrokes or complex combinations using xdotool or ydotool. Usage
🎮 Steam
Launch Steam or non-Steam games from a dropdown list.
🪟 Display Env
Identify the current display environment (e.g., :0).
🗔 Active Window
Monitor the name and title of the currently focused window.
✅ System Actions
🔴 Shutdown
Shut down the computer instantly from your dashboard.
⚪ Restart
Reboot the system remotely.
💤 Suspend
Trigger sleep mode to save power when not in use.
🚀 Boot Select
Choose which operating system to load on the next boot.
⚡ Power Profile
Toggle between performance, balanced, or power-saver profiles.
⚙️ SystemD
Manage Linux services; check status, start, or stop specific units. Settings
🖥 System Information
🧠 CPU
Monitor real-time CPU load and performance.
💾 RAM
Track memory usage and availability.
🖼️ GPU
Monitor load and usage for NVIDIA or AMD graphics cards.
🔋 Battery
Track battery levels for all connected devices.
🌡️ Temperature
Monitor thermal data from all discovered system sensors.
⚠️ Restart Required
Detect if a system reboot is needed (usually after kernel updates).
🔄 System Updates
Track pending packages and update availability in real-time.
📥 Disk IO
Measure read/write throughput for each physical disk.
📀 Disk Usage
Monitor storage capacity and percentage used per disk. Usage
🖴 Mounts
View space usage for all currently mounted volumes. Usage
📡 Network & Devices
📶 Network Speed
Monitor real-time upload and download speeds.
🌐 Interfaces
List active network interfaces and their assigned IP addresses.
📱 Bluetooth
Control global Bluetooth power or connect/disconnect specific devices.
🛜 WiFi
Monitor signal strength and connection metadata.
🔌 WOL
Enable or disable Wake-On-LAN support for compatible network cards.
🗺️ BeaconDB
Locate the device using WiFi triangulation or custom coordinates. Settings
🎚️ Audio/Video/Input
🎤 Microphone Used
Monitor if any application is currently accessing the microphone.
🔈 Speaker Used
Detect active audio output to determine if the system is "in use."
🎥 Camera Used
Track webcam activity for privacy or presence automations.
🎮 Gamepad Used
Report controller activity (active if input detected within 40s).
🧰 Applications & Tools
🧩 Advanced/Other
⏳ Inference Time
Debug performance by measuring sensor data collection latency.
📜 Logging Level
Change debug verbosity on-the-fly for troubleshooting.
🐚 Bash Commands
Create custom sensors, binary_sensors, buttons, or switches using shell scripts. Settings
🐳 Docker
Manage containers; toggle status, check for updates, or prune images. Settings
📊 Statistics
Opt-in to send anonymous usage data to help improve LNXlink. Usage
📮 RESTful
Interact with the system using standard HTTP requests. Usage
📦 Custom Modules
Lutris Game Launcher
Active Window (Wayland)
Screens On/Off (KDE)
AM2302 Temp/Humidity
Satisfactory Server
GPU nvidia-settings
Supported OS
LNXlink is built specifically for Linux. There are currently no plans for Windows or macOS support due to deep system dependencies.
Windows: We recommend HASS.Agent.
Cross-Platform: Consider IoTuring.
Last updated