Security News
Research
Data Theft Repackaged: A Case Study in Malicious Wrapper Packages on npm
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
homebridge-config-ui-x
Advanced tools
This is a plugin for Homebridge. This is a fork of the work originally done by mkellsy.
This plugin allows you to monitor, backup and configure your Homebridge server from a browser.
npm install -g --unsafe-perm homebridge-config-ui-x
https://homebridge-ui-demo.oz.nu
admin
admin
The demo environment is reset every 15 minutes. You might notice some high latency when using this demo as it's hosted in Australia.
Add this to your homebridge config.json
file
"platform":[
{
"platform": "config",
"name": "Config",
"port": 8080,
"sudo": false
}
]
Optional Settings
log
- See below for details.sudo
- See below for details.restart
- The command to run when a restart request is sent from the browser. If not populated it will just terminate the Homebridge process and let your process manager (like systemd) restart it.temp
- The path to the file that can display your current CPU temperature. eg. /sys/class/thermal/thermal_zone0/temp
Homebridge Config UI X allows you to view the homebridge process logs in the browser. These logs can be loaded from a file or from a command.
Example loading logs from a file, change /var/log/homebridge.log
to the actual location of your log file:
"platform":[
{
"platform": "config",
"name": "Config",
"port": 8080,
"log": "/var/log/homebridge.log"
}
]
Make sure the user which is running the Homebridge process has the correct permissions to read the log file. You may need to enable the sudo option to avoid permission errors if you are not running Homebridge as root.
If you are using systemd
to manage the Homebridge process then you can just set log
to systemd
:
"platform":[
{
"platform": "config",
"name": "Config",
"port": 8080,
"restart": "sudo -n systemctl restart homebridge",
"log": "systemd"
}
]
This will only work if your systemd
service has the name homebridge
. You may need to enable the sudo option to avoid permission errors if you are not running Homebridge as root.
The log
option can alternatively specify a command to spawn that will stream the logs to the client. This command should stream the logs to stdout
:
"platform":[
{
"platform": "config",
"name": "Config",
"port": 8080,
"log": {
"tail": "sudo -n tail -n 100 -f /var/log/homebridge.log"
}
}
]
Many operations performed by Homebridge Config UI X, such as installing plugins, upgrading Homebridge and viewing the logs can require root permissions. You can run the Homebridge service as root or you can enable the sudo
option in the config.
"platform":[
{
"platform": "config",
"name": "Config",
"port": 8080,
"sudo": true
}
]
When sudo
mode is enabled Homebridge Config UI X will use sudo
when executing installing, removing or upgrading plugins, viewing the logs using the Logs From File or Logs From Systemd method, and when upgrading Homebridge. It will not be used for Logs From Custom Command or custom restart commands.
For sudo
mode to work password-less sudo is required. You can enable password-less sudo by adding this entry to the bottom of your /etc/sudoers
file (use visudo
to edit the file!):
homebridge ALL=(ALL) NOPASSWD: ALL
Replace homebridge
with the actual user you are running Homebridge as.
Once installed you can open the interface at http://localhost:8080. The default username is admin
and the default password is admin
.
This shows you that the services are running. It also has your HomeKit pin.
This shows you the rolling log. This is helpful for troubleshooting.
This shows you the currently installed plugins and allows you to install, remove and upgrade plugins.
When installing, removing or upgrading plugins the output is show in the browser to help troubleshoot any issues.
And finally the configuration screen allows you to modify your Homebridge settings and your platforms and accessories.
The following browsers are supported by this plugin:
MS Internet Explorer (any version) is not supported!
FAQs
A web based management, configuration and control platform for Homebridge.
We found that homebridge-config-ui-x demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 9 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.