🌐 简体中文文档 / 中文版说明

🖥️ A Windows utility for scheduled and remotely controlled shutdown/sleep.
📅 Supports timer-based control and now includes TCP/UDP command support for remote management.

• ⏰ Schedule automatic shutdown or sleep with random delay
• 🧠 Lightweight and runs quietly in background
• 🌐 Remote command support via TCP/UDP
• 🔒 Useful for parental control and personal PC automation
• ⚠️ Pre-shutdown warning dialog with configurable timing

• Enforcing screen time for kids
• Power-saving automation
• Remote PC shutdown in home network

To make automatic shutdown/hibernate operations more natural, AutoShutdown implements a random delay mechanism:

• When entering the specified time range, the system will not immediately execute shutdown/hibernate
• Instead, it randomly selects a time point within the next 1-10 minutes
• This randomness prevents users from predicting the exact shutdown time
• It also provides users with a buffer period to save their work

For example, if the shutdown time is set to 22:00, the system will execute the shutdown or hibernate operation at a random time between 22:00 and 22:10.

AutoShutdown can display a warning dialog before performing shutdown or hibernate operations:

• Gives users a chance to save their work before shutdown/hibernate
• Configurable warning time (default: 5 minutes before operation)
• Can be enabled/disabled via command line or remote commands
• Users can choose to proceed with the operation or cancel it

git clone https://github.com/ihugang/AutoShutdown.git
cd AutoShutdown

Note: Since this project uses Windows-specific APIs, it is strongly recommended to build it in a Windows environment. Cross-compiling on non-Windows systems like macOS or Linux may encounter dependency issues.

# Install dependencies
go mod tidy

# Build for x64
go build -o AutoShutdown-amd64.exe ./src

# Build for ARM64
set GOARCH=arm64
go build -o AutoShutdown-arm64.exe ./src

# Install dependencies
go mod tidy

# Build for Windows x64
GOOS=windows GOARCH=amd64 go build -tags windows -o AutoShutdown-amd64.exe ./src

# Build for Windows ARM64
GOOS=windows GOARCH=arm64 go build -tags windows -o AutoShutdown-arm64.exe ./src

• Windows 10/11 with Go 1.18 or higher
• Visual Studio Code with Go extension

Configure your schedule, remote port, and warning settings, then run the program.

# Basic usage with default settings
AutoShutdown.exe

# Disable warning dialog
AutoShutdown.exe -warning=false

# Change warning time to 10 minutes before shutdown
AutoShutdown.exe -warning-time=10

# Set start and end times (setting hours and minutes separately)
AutoShutdown.exe -start-hour=21 -start-minute=30 -end-hour=6 -end-minute=30

# Set time range using HH:MM format
AutoShutdown.exe -start-time=21:30 -end-time=06:30

# Full configuration example
AutoShutdown.exe -mode=hibernate -tcp=2200 -udp=2200 -remote=true -warning=true -warning-time=5 -start-time=22:00 -end-time=06:00 -lang=en

# Install as Windows service with custom settings
AutoShutdown.exe -mode=hibernate -warning=true -warning-time=10 -start-time=22:30 -end-time=06:30 -lang=en install

# Start the service
AutoShutdown.exe start

• Default TCP/UDP Port: 2200 (configurable)
• Command Line Options:

  AutoShutdown.exe -tcp=2200 -udp=2200
  

• Security: Make sure to adjust firewall rules to allow these ports

If you have already installed AutoShutdown as a Windows service, follow these steps to change the ports:

1. Stop the service:

   AutoShutdown.exe stop
   

2. Remove the service:

   AutoShutdown.exe remove
   

3. Reinstall with new ports:

   AutoShutdown.exe -tcp=8080 -udp=8080 install
   

4. Start the service:

   AutoShutdown.exe start
   

Note: After changing ports, make sure to update your firewall rules accordingly.

# Windows
telnet <target-ip> 2200

# macOS (no built-in telnet)
nc <target-ip> 2200

# Linux
telnet <target-ip> 2200
# or
nc <target-ip> 2200

# Windows (PowerShell)
$endpoint = New-Object System.Net.IPEndPoint([System.Net.IPAddress]::Parse("<target-ip>"), 2200)
$client = New-Object System.Net.Sockets.UdpClient
$bytes = [System.Text.Encoding]::ASCII.GetBytes("hibernate")
$client.Send($bytes, $bytes.Length, $endpoint)
$client.Close()

# macOS/Linux
echo "hibernate" | nc -u <target-ip> 2200

• shutdown: Shutdown the computer
• hibernate: Hibernate the computer (default action)
• reboot: Restart the computer
• logoff: Log off the current user
• status: View system status
• setmode <mode>: Set operation mode (shutdown, hibernate, reboot, logoff)
• settime start HH:MM: Set start time
• settime end HH:MM: Set end time
• setwarning on [minutes]: Enable shutdown warning (optionally specify minutes)
• setwarning off: Disable shutdown warning
• help: Show help information
• menu: Show interactive menu (TCP only)

MIT License Copyright (c) 2025

⸻

Made with ❤️ by Hu Gang