🌏 中文 | English
⏰ A beautiful cross-platform shutdown timer with custom wallpapers, themes, autostart, auto-update and lock-screen reliable triggering
Shut your computer down gracefully at the time you choose — once, or on a weekly schedule.
- 🎨 Polished interface — rounded card layout, smooth animation, dark and light modes
- 🖼️ Custom wallpaper — a local image, an image URL, or a random source (Picsum, LoremFlickr, anime-style, Bing)
- 🌈 Four themes — Midnight Blue / Night Purple / Forest Green / Sunset Orange; switching is instant, no restart
- 🌏 Bilingual UI — Chinese and English, one click to switch, with a smooth transition
- ⏱️ Three units — seconds / minutes / hours, plus 5 min / 10 min / 30 min / 1 h presets
- 🗓️ Scheduled shutdown — fire once at a clock time, or repeat on a weekly pattern (weekdays at 23:30, for example)
- 🔔 Pre-shutdown reminder — an overlay in the bottom-right corner for the last 60 seconds, one click to cancel
- 📋 Shutdown log — every arm and every trigger is recorded, so "it didn't shut down" can be traced back to a cause
- 🔒 Fires even when locked — the deadline is handed to a kernel waitable timer, so locking, sleeping or idling all still trigger it on time
- 🖱️ Lives in the tray — closing the window does not quit the app; the weekly schedule needs it running
- 🚀 Start on boot — one switch to toggle; the registry entry / LaunchAgent is handled for you
- 🔄 Auto-update — detects a new version, then downloads, replaces and restarts in one click
- 💾 Persistent settings — theme, language, wallpaper and schedule rules are all remembered
Real captures from v1.0.4 (light mode · Midnight Blue theme). The UI is bilingual — switch it to English in Settings → Language and every screen below follows.
| Main window | Countdown running |
|---|---|
![]() Seconds / minutes / hours, plus the quick presets |
![]() Ring progress and the exact shutdown time, with the button turned into "Cancel" |
| Settings panel | Scheduled shutdown |
|---|---|
![]() Language, four themes, wallpaper, autostart, update check, log entry |
![]() Two segments — one clock time or a weekly repeat; weekdays are single- or multi-select |
| Pre-shutdown reminder | Shutdown log |
|---|---|
![]() The last 60 seconds, bottom-right, cancels the shutdown directly |
![]() One line for every setting and every trigger |
Grab the latest build from Releases:
- Windows 10 / 11 (64-bit):
ShutdownTimer.exe— double-click to run, no installation - Windows 7 SP1 or later / 32-bit:
ShutdownTimer_x86.exe— pick this one on old machines and Win7 - macOS Apple silicon (arm64):
ShutdownTimer-macos-arm64.dmg - macOS Intel (x64):
ShutdownTimer-macos-x64.dmg— mount it, then drag the app into Applications
The two Windows builds are functionally identical and differ only in packaging architecture: x64 is faster, x86 covers 32-bit systems and Windows 7.
This work is licensed under CC BY-NC 4.0, so you are free to clone, read, modify and run it locally (non-commercial use only):
git clone https://github.com/ZSOF-Rui/ShutdownTimer.git
cd ShutdownTimer
pip install Pillow
python ShutdownTimer.pyPython 3.8 or newer is required (the Windows 7 / 32-bit build is made with 3.8), and Pillow is the only third-party dependency.
Three files in the repository root are the complete input for every published build:
| File | Role |
|---|---|
ShutdownTimer.py |
All of the source, one file, shared by all four platforms |
app.ico |
The app icon; Windows packaging references it directly, macOS generates the .icns from it |
selfcheck.py |
Self-check script — python selfcheck.py drives the critical paths unattended |
selfcheck.pyreplaces the shutdown call with an empty function, so running it never shuts your machine down.
For commercial use (bundling into a paid product, offering it as a paid service, and so on) please get written permission from the copyright holder first — see the license section below.
The repository ships .github/workflows/build.yml: push a
change to ShutdownTimer.py (or tag a v* release) and Actions compiles the four
artifacts above from that same source, then automatically replaces the matching
exe / dmg files and the four version*.json manifests in the repository. GitHub
Pages picks them up, so no manual upload is involved.
- The version number comes only from
CURRENT_VERSIONin the code; on a tag trigger the workflow additionally checkstag == v<CURRENT_VERSION>and stops on a mismatch, so a release can never be tagged 1.0.5 while its manifest says 1.0.4 - The update prompt text lives in
release-notes.jsonat the root — rewriting the copy never means editing the workflow - The automated commit carries
[skip ci], and the workflow'spaths-ignoreexcludes every artifact and manifest, so it cannot re-trigger itself - The same
paths-ignorealso excludes documentation-only files — both READMEs, thedocs/screenshots, the changelog and the web page — so rewriting copy never burns a four-platform rebuild - If one leg fails to build (a macOS runner that cannot get a machine, for instance), the other three are still replaced and the log says which one is missing
SPDX-License-Identifier: CC-BY-NC-4.0
(GitHub's license index does not list the NC series, so the repository header shows
"Other" — that does not affect the grant)
The source code, documentation, images and icon of ShutdownTimer are licensed under the Creative Commons Attribution-NonCommercial 4.0 International license (CC BY-NC 4.0). The full legal text is in LICENSE at the repository root.
Copyright (c) 2026 ZSOF.Rui
share and adapt the work, as long as you obey the license:
- Share — copy and redistribute the material in any medium or format;
- Adapt — remix, transform, and build upon the material, and distribute your version;
- use it for personal, educational and research purposes, with no separate licence to apply for.
- Attribution (BY) — give appropriate credit, provide a link to the license, and indicate if changes were made; do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
- NonCommercial (NC) — you may not use the material for anything primarily intended for or directed towards commercial advantage or monetary compensation (including bundling it into a commercial product, offering it as a paid service, or using it in a for-profit business activity).
- remove, alter or hide the copyright notice, author attribution or license terms in this work;
- apply any legal terms or technological measures that restrict others from receiving the freedoms this license grants;
- use it commercially — for that, obtain written permission first (see below).
Reverse engineering and decompilation are permitted only to the extent explicitly allowed by law (interoperability, for example).
For anything beyond the CC BY-NC 4.0 grant — commercial distribution, paid services, waiver of attribution — contact the copyright holder for written permission:
- Email: xinchencloud@outlook.com
- GitHub: https://github.com/ZSOF-Rui
THE WORK IS PROVIDED "AS IS", AND THE LICENSOR MAKES NO WARRANTY EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING FROM YOUR USE OF, OR INABILITY TO USE, THE WORK.
License: Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) Copyright (c) 2026 ZSOF.Rui
You are free to share and adapt this work for non-commercial purposes only, as long as you give appropriate credit, indicate the changes you made, and provide a link to the license. Commercial use requires prior written permission from the copyright holder. See LICENSE for the full legal code.
The Chinese sections in README.md are an unofficial summary of CC BY-NC 4.0; if the two ever disagree, the English legal code in LICENSE prevails.





