Metadata-Version: 2.4
Name: fixtime
Version: 2.0.0
Summary: Time synchronization tool for Kerberos authentication
Home-page: https://github.com/watcher1337/fixtime
Author: watcher1337
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: ntplib
Requires-Dist: click
Requires-Dist: python-dateutil
Requires-Dist: requests
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# fixtime

[![GitHub release](https://img.shields.io/github/release/watcher1337/fixtime.svg)](https://github.com/watcher1337/fixtime/releases/latest)
[![GitHub downloads](https://img.shields.io/github/downloads/watcher1337/fixtime/total.svg)](https://github.com/watcher1337/fixtime/releases)
[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com/watcher1337/fixtime/releases)


**Time synchronization tool designed to resolve Kerberos authentication issues by correcting system time offsets during Active Directory penetration testing.**

---

## 📋 Table of Contents

- [Features](#-features)
- [Quick Install](#-quick-install)
- [Usage](#-usage)
- [Common Use Cases](#-common-use-cases)

---

## ✨ Features

- 🔒 Corrects system time to match Active Directory servers
- 🖥️ Cross-platform: Windows, Linux, macOS (x64 & ARM64)
- 🔧 NTP auto-sync with fallback servers
- 🎯 Kerberos tolerance-aware with force option
- 🔄 One-command restore functionality


---

## 🚀 Quick Install

### Linux / macOS

**One-liner installer:**

```bash
curl -fsSL https://raw.githubusercontent.com/watcher1337/fixtime/refs/heads/main/installer.sh | bash
```

### uv install
```bash
uv tool install git+https://github.com/watcher1337/fixtime.git
```
```bash
fixtime -h
```

### pipx install
```bash
pipx install git+https://github.com/watcher1337/fixtime.git
```
```bash
fixtime -h
```
### pip3 install From GitHub
```bash
python3 -m venv venv && source venv/bin/activate
```
```bash
pip3 install git+https://github.com/watcher1337/fixtime.git
```
```bash
fixtime -h
```
### pip3 install from local clone
```bash
git clone https://github.com/watcher1337/fixtime.git && cd fixtime
```
```bash
python3 -m venv venv && source venv/bin/activate
```
```bash
pip3 install .
```
```bash
fixtime -h
```

### Windows

Download `fixtime.exe` from [releases](https://github.com/watcher1337/fixtime/releases/latest)

---

## 📖 Usage

```bash
fixtime -i <target-ip>          # Sync time with AD server
fixtime -i <target-ip> --force  # Force sync (bypass 5-min tolerance)
fixtime --restore               # Restore NTP service
fixtime -h                      # Show help
```

**Options:**
- `-i IP` - Target Active Directory server IP
- `--force` - Force sync even if within Kerberos tolerance
- `--restore` - Re-enable NTP service
- `-h` - Display help


---

## 🎯 Common Use Cases

- **Fix Kerberos errors:** `KDC_ERR_CLOCK_SKEW`, "Clock skew too great"
- **Before AD penetration testing:** Sync time with DC before using Impacket, BloodHound, etc.
- **Force sync:** When offset exceeds 5 minutes
- **Cleanup:** Restore NTP after engagement

---









