NexusClock

A powerful live clock library with timezone support, custom dates, and reverse time functionality.

How to install

python -m pip install nexusclock

Quick Start

from nexusclock import nexusclock

# Current time (12-hour format) - Just works!
nexusclock.nexusclock.today()

# Current time (24-hour format)
nexusclock.nexusclock.today()._24h()

# Time going backwards (reverse)
nexusclock.nexusclock.backwards()

# Reverse time in 24-hour format
nexusclock.nexusclock.backwards()._24h()

# Custom date/time
nexusclock.nexusclock.custom("2026-07-09 14:30:00")

# Custom with 24-hour format
nexusclock.nexusclock.custom("2026-07-09 14:30:00")._24h()

# Custom going backwards
nexusclock.nexusclock.custom("2026-07-09 14:30:00").backwards()

# Change timezone
nexusclock.nexusclock.changetz("America/New_York")

# Show help guide
nexusclock.nexusclock.help()

Methods

Features

• ✅ Live clock with carriage return updates (no screen flicker)
• ✅ 12/24 hour formats support
• ✅ Reverse time mode (time goes backwards)
• ✅ Custom date/time with validation
• ✅ Timezone switching with automatic offset
• ✅ Automatic location detection via IP geolocation
• ✅ Ordinal suffixes (st, nd, rd, th) for day numbers
• ✅ Keyboard interrupt & EOF error handling - no crashes!
• ✅ Rich panel help guide with beautiful formatting
• ✅ Supports both class and instance methods

Example Output

The 9th of July, 2026, 4:52:38 PM, GMT+6 (Paltan, Bangladesh)

Requirements

• Python 3.7+
• rich >= 10.0.0
• python-dateutil >= 2.8.0

License

Copyright (c) 2026 Light Bulb Experiments

MIT License - see LICENSE.txt

Links

• Homepage: https://nexusclock.today
• Target: nexusclock.nexusclock.today()
• Class: nexusclock
• Author: Light Bulb Experiments

Why NexusClock?

• 🚀 Zero configuration - Just import and use
• 🌍 Location aware - Automatically detects your timezone
• 🎯 Simple API - Chain methods for different formats
• ⚡ Real-time updates - Live clock with smooth updates
• 🛡️ No crashes - Handles all errors gracefully
• 📦 Lightweight - Minimal dependencies

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

Support

For issues and feature requests, please open an issue on our GitHub repository.

Made with ❤️ by Light Bulb Experiments