Home

Time Sync Bot - Documentation

Welcome to the Time Sync Bot Wiki! This document serves as the central hub for all project documentation.

📚 Table of Contents

1. Introduction
2. Features
3. Installation Guide
4. Usage
5. Configuration
6. Troubleshooting
7. FAQ
8. Development
9. License

🌟 Introduction

Time Sync Bot is a lightweight Windows utility designed to keep your system time synchronized with internet time servers. It's particularly useful for systems that frequently lose time synchronization or for users who require precise timekeeping.

✨ Features

• Automatic time synchronization at regular intervals
• Minimal resource usage
• No installation required
• Simple one-click operation
• Adjustable sync frequency
• Works with Windows built-in time service

📥 Installation Guide

Prerequisites

• Windows 7 or later
• Internet connection
• Administrator privileges (for time synchronization)

Installation Steps

1. Download the latest release from the Releases page
2. Extract the ZIP file to your preferred location
3. Navigate to the src directory
4. Run time_sync_bot.bat

🚀 Usage

Basic Usage

1. Double-click time_sync_bot.bat to start the synchronization
2. A command prompt window will appear showing the sync status
3. The bot will continue running in the background

Running at Startup

To automatically start the bot when Windows starts:

1. Press Win + R
2. Type shell:startup and press Enter
3. Create a shortcut to time_sync_bot.bat in the Startup folder

⚙️ Configuration

Adjusting Sync Interval

Edit time_sync_bot.bat and modify the timeout /t 125 line. The number represents seconds between syncs (default: 125 seconds).

Changing Time Server

By default, Windows uses time.windows.com. To change this:

1. Open Command Prompt as Administrator
2. Run: w32tm /config /update /manualpeerlist:"your.time.server.com"
3. Restart the Windows Time service: net stop w32time && net start w32time

🐛 Troubleshooting

Common Issues

1. Time not syncing

   • Ensure you have internet connection
   • Run Command Prompt as Administrator and execute: w32tm /resync
   • Check if Windows Time service is running: net start | find "Windows Time"

2. Access Denied error

   • Run the script as Administrator
   • Ensure your user account has administrative privileges

3. Sync fails

   • Try changing the time server (see Configuration section)
   • Check your firewall settings to allow NTP traffic (UDP port 123)

❓ Frequently Asked Questions

Q: Is this safe to use?

A: Yes, the bot uses Windows' built-in time synchronization tools and doesn't require any special permissions beyond what's needed for time synchronization.

Q: How often should I sync my time?

A: The default of every 2 minutes is good for most users. More frequent syncing might be needed for time-sensitive applications.

Q: Does this work on Linux/Mac?

A: No, this is a Windows-only utility as it relies on Windows-specific commands.

🛠️ Development

Building from Source

1. Clone the repository
2. Make your changes to time_sync_bot.bat
3. Test your changes thoroughly
4. Submit a pull request

Testing

1. Run the script on a Windows machine
2. Verify time synchronization occurs at the specified interval
3. Check for any error messages in the console

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on how to contribute to this project.

---

📅 Last updated: September 2025