Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/offrange/powercontrolserver
Power Control Server is a lightweight application that enables remote management of your PC's power state via the Power Control Android app. Compatible with Windows, Linux, and MacOS. Currently in development.
https://github.com/offrange/powercontrolserver
linux mac power-control power-management windows
Last synced: 26 days ago
JSON representation
Power Control Server is a lightweight application that enables remote management of your PC's power state via the Power Control Android app. Compatible with Windows, Linux, and MacOS. Currently in development.
- Host: GitHub
- URL: https://github.com/offrange/powercontrolserver
- Owner: OffRange
- License: mit
- Created: 2024-07-31T14:43:03.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-08-09T18:19:38.000Z (3 months ago)
- Last Synced: 2024-10-04T21:51:08.905Z (about 2 months ago)
- Topics: linux, mac, power-control, power-management, windows
- Language: C++
- Homepage:
- Size: 51.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Power Control Server
> [!CAUTION]
> **Power Control Server** is currently in development and may have bugs. Some of the features mentioned
> below, or the app for certain operating systems, may not be available in the current state.
>
> Please use the application with caution and report any issues via
> the [Issues](https://github.com/OffRange/PowerControlServer/issues) page.
**Power Control Server** is a lightweight background service that enables remote management of your PC's power state via the **Power Control** Android app. By installing this server application, you can allow remote shutdown, reboot, log-out, and other power management commands from your Android device.
### Prerequisites
For communication to the target PC, you must have installed the **Power Control** Android app.
> [!NOTE]
> Currently the **Power Control** app is **only available for Android.**
You can find the Power Control app on a separate GitHub
repository: [Power Control](https://github.com/OffRange/PowerControl)
## Features
- **Remote Shutdown**: Allows your PC to be turned off remotely.
- **Remote Reboot**: Restarts your PC via a command from the Power Control app.
- **Remote Log-Out**: Logs out the current session on your PC.
- **Cross-Platform**: Available for Windows, Linux, and macOS.
## Installation
> [!CAUTION]
> Only download the application from the official GitHub repository, as the application is not signed: [`OffRange/PowerControlServer`](https://github.com/OffRange/PowerControlServer).
> Always ensure that you are on the correct URL: [https://github.com/OffRange/PowerControlServer/releases](https://github.com/OffRange/PowerControlServer/releases).
### Linux and macOS
You can install **Power Control Server** on Linux or macOS by running the following command:
```bash
curl -sSL https://github.com/OffRange/PowerControlServer/raw/main/install.sh | bash
```
### Windows
For Windows users, an installer is provided to install **Power Control Server** as a Windows Service:
1. Download the latest Windows installer from the [Releases](https://github.com/OffRange/PowerControlServer/releases) page.
2. Run the installer and follow the on-screen instructions to install **Power Control Server**.
3. The server will automatically start as a Windows Service after installation.
## Configuration
After installation, ensure that:
1. Your PC is on the same network as your Android device running the **Power Control** app.
2. The correct IP address is configured in the Power Control app.
### Wake-On LAN (Optional)
If you want to enable remote booting of your PC, ensure that Wake-On LAN is enabled in your BIOS/UEFI settings and your network adapter's settings in the operating system. After that add your network adapter's mac address to your registered device in the Android **Power Control** app.
## Usage
1. Start your PC, the **Power Control Server** automatically starts at every boot.
2. Open the **Power Control** app on your Android device.
3. Add a new device by entering your PC's IP address in the app.
4. Perform remote power operations like shutdown, reboot, or log-out directly from your Android device.
## Troubleshooting
- **Firewall Settings**: Ensure that your firewall allows incoming connections on the port used by the server (default is 7848).
- **Network Issues**: Make sure both your PC and Android device are connected to the same local network.
- **Application Logs**: Check the server logs for any error messages if the connection fails.
## Contributing
Contributions are welcome! Please fork the repository and submit a pull request with your changes. For major changes, please open an issue first to discuss what you would like to change.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.