🌍 Global Time Utility (gtime)

A modern, colorful Python CLI utility for global time zone lookup, comparison, and management
Sick of Googling time zones every day?! Stop wasting time figuring out the time. 🕐 gtime makes it effortless to work across time zones with fuzzy search, favorites, real-time updates, and beautiful terminal output.
⭐ Love this project? Give it a star!
If gtime helps you manage time zones more efficiently, please consider giving it a ⭐ on GitHub! Your support helps us improve and motivates continued development.
⭐ Star this project • 🐛 Report issues • 💡 Request features
🎯 Why gtime?
- ⚡ Lightning fast - Optimized for large city databases
- 🔍 Smart search - Fuzzy matching finds cities even with typos
- ❤️ Favorites - Save your most-used cities for quick access
- 🔄 Live updates - Watch mode for real-time monitoring
- 🎨 Beautiful output - Colorful, rich terminal interface
- 🤝 Meeting helper - Convert meeting times across all favorites with timezone support
- 🌐 Global team ready - Supports UTC, EST, PST, JST, CET and more timezones
- 📊 Compare easily - Side-by-side time comparisons
📦 Installation
From PyPI (Recommended)
pip install gtime
From Source
git clone https://github.com/savitojs/gtime.git
cd gtime
pip install .
🚀 Quick Start
gtime London
gtime add Tokyo Singapore "New York"
gtime list
gtime compare London Tokyo Sydney
gtime meeting at "2:00 PM"
gtime watch
🎬 Demo
See gtime in action:

Note: Some command output may appear broken in the demo, but it works perfectly in real terminal usage
🎯 Features
🏙️ City Lookup
- Fuzzy search:
gtime toky
finds Tokyo
- Suggestions: Get helpful suggestions for misspelled cities
- Instant results: Lightning-fast lookups even with huge databases
⭐ Favorites Management
gtime add "Los Angeles" Berlin Mumbai
gtime remove Tokyo
gtime list
gtime clear
🔍 Multi-City Comparison
gtime compare London Tokyo "New York"
gtime compare
📅 Meeting Time Conversion
gtime meeting at "10:00 AM"
gtime meeting at "15:30"
gtime meeting at "3 PM UTC"
gtime meeting at "9:00 AM EST"
👀 Live Watch Mode
gtime watch
gtime watch London Tokyo
🌐 Timezone Support
When you specify a timezone, gtime shows the full timezone name for clarity:
gtime meeting at "10:00 AM JST"
gtime meeting at "3 PM UTC"
gtime meeting at "2:00 PM EST"
📚 Usage Examples
Basic Usage
gtime Paris
gtime "San Francisco"
gtime mumbai
gtime pairs
gtime newyork
Managing Favorites
gtime add London Tokyo "San Francisco" Berlin
gtime add Mumbai
gtime list
gtime remove Berlin
gtime clear
Advanced Features
gtime compare London Tokyo Sydney Mumbai
gtime meeting at "9:00 AM"
gtime meeting at "14:30"
gtime meeting at "3 PM UTC"
gtime watch
🛠️ Development
Running Tests
pip install -r requirements.txt
pytest tests/
python tests/perf/profile_lookup.py
Contributing
We welcome contributions! Here's how to get started:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Make your changes and add tests
- Run tests:
pytest
- Commit your changes:
git commit -m 'Add amazing feature'
- Push to the branch:
git push origin feature/amazing-feature
- Open a Pull Request
🚀 GitHub Actions
This project includes automated workflows:
- 🧪 Tests: Runs on every push/PR across Python 3.8-3.12
- 📦 Publish: Automatically publishes to PyPI upon new GitHub release
🤝 Support
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🌟 Show Your Support
If gtime makes your life easier, please consider:
- ⭐ Starring this repository
- 🐦 Sharing it on social media
- 📝 Writing a review
- 🤝 Contributing to the project
Made with ❤️ for developers working across time zones
Happy time zone management! 🌍