shutdown-on-lan 1.0.0

Shutdown On Lan is a FastAPI application that allows you to remotely shut down the system.

Shutdown On Lan

Shutdown On Lan is a FastAPI application that allows you to remotely shut down the system.

Why?

• It's easy to integrate into existing projects like UpSnap (It was created for it!)
• It simplifies the process of remotely shutting down the PC without requiring complex configurations.

Example Use Case

I use this tool combined with UpSnap for booting my gaming PC, Tailscale as VPN for the remote connection, and Sunshine for streaming so I can connect and play my games even when I'm not at home.

Usage

1. Download the package:

   pip install shutdown-on-lan
   

2. Start the application:

   shutdown-on-lan
   

3. Send an HTTP request to shut down the computer. For example, using curl:

   Replace <IP_ADDRESS> with the IP address of the machine you want to shut down and <PORT> with the port number (default is 8000).

   curl "http://<IP_ADDRESS>:<PORT>/shutdown"
   

Adding the Command to Startup on Windows

To run shutdown-on-lan automatically at startup on Windows, follow these steps:

1. Create a shortcut:

   • Right-click on your desktop or in a folder and select New > Shortcut.
   • In the location field, enter:

     cmd /c "shutdown-on-lan --<PORT> --<MESSAGGE>"
     

   • Click Next and give the shortcut a name, e.g., Shutdown On Lan.

2. Move the shortcut to the Startup folder:

   • Press Win + R, type shell:startup, and press Enter.
   • Move the shortcut you created into the Startup folder.

Now, shutdown-on-lan will run automatically when you log in to Windows.

Arguments

Port

You can specify a custom port for the application to run on by using the --port argument. The default port is 8000.

Example:

shutdown-on-lan --port 8080

Message

You can specify a custom shutdown message to be displayed before the system shuts down by using the --message argument. The default message is System will shut down in 5 minutes

Example:

shutdown-on-lan --message "System will shut down in 5 minutes"

Hide Message

You can hide the shutdown message by using the --hide-message argument. By default, the message is shown.

Example:

shutdown-on-lan --hide-message

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.