An easy to use HomeAssistant integration to control (dualboot) computers.
Go to file
2024-10-19 11:42:57 +02:00
.github fixed sudo permission for some commands 2024-10-19 11:42:57 +02:00
.images add readme header image 2023-12-31 14:57:46 +01:00
custom_components/easy_computer_manager fixed sudo permission for some commands 2024-10-19 11:42:57 +02:00
.gitignore move gitignore to correct folder 2023-04-06 19:16:14 +02:00
hacs.json massive refactor and code improvements 2023-12-30 20:21:37 +01:00
LICENSE Initial commit 2023-04-04 11:42:50 +00:00
README.md update readme 2024-08-30 11:31:13 +02:00
requirements.txt improved ssh connections and reliability 2024-10-19 11:26:43 +02:00

🖧 Easy Computer Manager

hacs_badge GitHub release (latest by date)

img.png

Easy Computer Manager is a custom integration for Home Assistant that allows you to remotely manage various aspects of your computer, such as sending Wake-On-LAN (WoL) packets, restarting the computer between different operating systems ( if dual-boot), adjusting audio configurations, changing monitor settings, and more.

Features

  • Send Wake-On-LAN (WoL) packets to wake up a device.
  • Restart the computer between Windows and Linux (dual-boot systems).
  • Directly start the computer into Windows.
  • Put the computer into sleep mode.
  • Restart the computer.
  • Modify monitor configurations.
  • Start/Stop Steam Big Picture mode.
  • Adjust audio settings (volume, mute, input, output).
  • Display debug information for setup and troubleshooting.

Installation

Via HACS

  1. Install HACS if not already installed.
  2. In Home Assistant, go to "HACS" in the sidebar.
  3. Click on "Integrations."
  4. Click on the three dots in the top right corner and select "Custom repositories."
  5. Paste the following URL in the "Repo" field: https://github.com/M4TH1EU/HA-EasyComputerManager
  6. Select "Integration" from the "Category" dropdown.
  7. Click "Add."
  8. Search for "easy_computer_manager" and click "Install."

Manually

  1. Download the latest release from the GitHub repository.
  2. Extract the downloaded ZIP file.
  3. Copy the "custom_components/easy_computer_manager" directory to the "config/custom_components/" directory in your Home Assistant instance.

Preparing your computer (required)

Caution

Before adding your computer to Home Assistant, ensure that it is properly configured.

See wiki page here.

Add Computer to Home Assistant

  1. In Home Assistant, go to "Configuration" in the sidebar.
  2. Select "Integrations."
  3. Click the "+" button to add a new integration.
  4. Search for "Easy Computer Manager" and select it from the list.
  5. Follow the on-screen instructions to configure the integration, providing details such as the IP address, mac-adress, username, and password for the computer you want to add.
  6. Once configured, click "Finish" to add the computer to Home Assistant.

Note

If you are managing a dual-boot computer, ensure that the "Dual boot system" checkbox is enabled during the configuration.

Usage

After adding your computer to Home Assistant, you can use the provided services to manage it remotely. Explore the available services in the Home Assistant "Services" tab or use automations to integrate Easy Computer Manager into your smart home setup.

Services

A detailed list of available services and their parameters can be found in the wiki here.

Troubleshooting

If you encounter any issues during installation or configuration, refer to the troubleshooting section in the Wiki or seek assistance from the Home Assistant community.

Contributions

Contributions are welcome! If you find any bugs or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.

Happy automating with Easy Computer Manager!