https://github.com/omaranos517/autosync-windowstime

Ultimate Windows Time Sync Tool – A robust Python/CLI utility to fix Windows clock desync issues caused by Dual Boot (Linux/Windows), dead CMOS batteries, or W32Time service failures. Featuring auto-admin elevation and smart retry logic.
https://github.com/omaranos517/autosync-windowstime

automation python system-utility time-sync windows

Last synced: 3 months ago
JSON representation

Ultimate Windows Time Sync Tool – A robust Python/CLI utility to fix Windows clock desync issues caused by Dual Boot (Linux/Windows), dead CMOS batteries, or W32Time service failures. Featuring auto-admin elevation and smart retry logic.

• Host: GitHub
• URL: https://github.com/omaranos517/autosync-windowstime
• Owner: omaranos517
• Created: 2026-01-27T08:53:34.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-03-06T21:44:20.000Z (3 months ago)
• Last Synced: 2026-03-06T23:48:36.882Z (3 months ago)
• Topics: automation, python, system-utility, time-sync, windows
• Language: Python
• Homepage:
• Size: 719 KB
• Stars: 7
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


    



# 🕒 TimeSync

**The definitive solution for Windows time desynchronization.**  

Perfect for Dual-Boot users (Windows + Linux) and systems with CMOS battery issues.



  

    

  



---

## ❓ The Problem

If you dual-boot **Windows and Linux**, you've probably noticed that your Windows clock becomes incorrect after switching operating systems.

This happens because:

- 🐧 Linux stores the hardware clock (RTC) in **UTC**

- 🪟 Windows expects the RTC in **Local Time**

This mismatch causes Windows to display the wrong time after rebooting from Linux.

**TimeSync bridges this gap** by force-synchronizing Windows time using official Microsoft time services immediately after login.

---

## ✨ Key Features

- ✅ **One-Click Repair**  

  Restores and properly configures the `w32time` Windows Time Service.

- 🌐 **Smart Auto-Sync**  

  Automatically retries synchronization until an internet connection is available.

- 🏢 **System Integration**  

  Registers as a professional application inside Windows **Apps & Features**.

- 💻 **Global Command Access**  

  Run `timesync` from any CMD or PowerShell window.

- 🔐 **Silent Background Execution**  

  Uses Windows Task Scheduler with **Highest Privileges** for seamless startup sync.

- 🔔 **Native Windows Notifications**  

  Uses Windows Toast Notifications to inform you about sync status.

---

## 🚀 Getting Started

### 🔧 Installation

1. Download the latest installer from Releases (`TimeSync__Setup.exe`).

2. Run the installer as Administrator and complete the setup wizard.

3. (Optional) Keep **Run TimeSync at Windows startup** enabled during setup.

The installer will:

- Install TimeSync to `C:\Program Files\TimeSync`

- Add the install directory to the system `PATH`

- Register the app in Windows Apps & Features

- Optionally enable:

  - Startup sync task

  - Resume-from-sleep sync task

---

## 💻 Usage

### GUI Mode

- Open **TimeSync** from the Start Menu, or run `timesync` with no arguments.

- Use the GUI to:

  - Sync immediately

  - Enable/disable Startup sync

  - Enable/disable Sync on Wake (Resume)

  - Enable/disable Notifications

  - Open the log file

### CLI Mode

Open **CMD** or **PowerShell** and use:

| Command | Description |

|----------|------------|

| `timesync help` / `timesync commands` | Show all available commands |

| `timesync now` | Sync time immediately |

| `timesync status` | Show admin, startup, resume, and notification status |

| `timesync startup status` | Check startup sync task status |

| `timesync startup enable` | Enable sync at Windows login |

| `timesync startup disable` | Disable sync at Windows login |

| `timesync resume status` | Check sync-on-wake task status |

| `timesync resume enable` | Enable sync after sleep/hibernate wake |

| `timesync resume disable` | Disable sync after sleep/hibernate wake |

| `timesync notify status` | Check notification status |

| `timesync notify enable` | Enable desktop notifications |

| `timesync notify disable` | Disable desktop notifications |

| `timesync logs` | Open the log file |

| `timesync about` | Show app information |

| `timesync version` | Show current version |

Advanced/internal commands:

- `timesync now --auto` (used by scheduled tasks)

- `timesync cancel`

- `timesync disable-warning`

---

## 🛠 How It Works

TimeSync does not simply "change the time".

It executes a controlled sequence of official Windows commands:

### 1️⃣ Service Configuration

Sets the Windows Time Service (`w32time`) to start automatically.

### 2️⃣ Service Reset

Stops and restarts the time service to ensure a clean state.

### 3️⃣ NTP Peer Configuration

Configures reliable official time servers:

- `time.google.com`

- `pool.ntp.org`

- `time.windows.com`

### 4️⃣ Forced Resync

Triggers an immediate hardware clock update using: `w32tm /resync`

---

## 🔒 Safety & Transparency

- 🛑 **No permanent background process**  

  The app runs, syncs, and exits. No memory waste.

- 🧰 **Official Windows Methods Only**  

  Uses:

  - `sc`

  - `net`

  - `w32tm`

  - Windows Task Scheduler

---

## 🎯 Ideal For

- Dual-boot users (Windows + Linux)

- Systems with CMOS battery issues

- Users experiencing Windows time drift

- Developers who switch OS frequently

- Anyone who wants automatic, reliable time correction

---

## 👤 Author

Omar Anoss  

---

⭐ If this project helped you, consider starring the repository.