{"id":34087803,"url":"https://github.com/savitojs/gtime","last_synced_at":"2026-04-02T19:20:37.022Z","repository":{"id":303512170,"uuid":"1015707938","full_name":"savitojs/gtime","owner":"savitojs","description":"Global Time (gtime) is a modern, colorful Python CLI utility for global time zone lookup, comparison, and management. It supports fuzzy search, favorites, city comparison, meeting time conversion, and a live/watch mode","archived":false,"fork":false,"pushed_at":"2026-03-31T02:51:07.000Z","size":48803,"stargazers_count":10,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-31T04:52:58.708Z","etag":null,"topics":["cli","global","python3","time","timezone","timezone-conversion","worldtime"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/savitojs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-07T23:27:21.000Z","updated_at":"2026-03-31T02:51:12.000Z","dependencies_parsed_at":"2025-07-08T03:20:58.784Z","dependency_job_id":"89d7d1e6-0f63-4efd-9aa3-ffb947bec06a","html_url":"https://github.com/savitojs/gtime","commit_stats":null,"previous_names":["savitojs/gtime"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/savitojs/gtime","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savitojs%2Fgtime","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savitojs%2Fgtime/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savitojs%2Fgtime/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savitojs%2Fgtime/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/savitojs","download_url":"https://codeload.github.com/savitojs/gtime/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savitojs%2Fgtime/sbom","scorecard":{"id":1245397,"data":{"date":"2026-03-31T02:51:24Z","repo":{"name":"github.com/savitojs/gtime","commit":"6d5f27308156baaa42567e8cc5b4c0cfa4966dfb"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":7.3,"checks":[{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: RenovateBot: renovate.json:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 0/14 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":10,"reason":"GitHub workflow tokens follow principle of least privilege","details":["Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release-please.yml:15","Info: jobLevel 'contents' permission set to 'read': .github/workflows/test.yml:16","Info: jobLevel 'actions' permission set to 'read': .github/workflows/test.yml:118","Info: topLevel 'contents' permission set to 'read': .github/workflows/dependency-review.yml:7","Info: found token with 'none' permissions: .github/workflows/release-please.yml:1","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yml:9","Info: found token with 'none' permissions: .github/workflows/test.yml:1"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":10,"reason":"all dependencies are pinned","details":["Info:   7 out of   7 GitHub-owned GitHubAction dependencies pinned","Info:   7 out of   7 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/test.yml:52"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"SAST","score":5,"reason":"SAST tool is not run on all commits -- score normalized to 5","details":["Warn: 13 commits out of 24 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.8.1 not signed: https://api.github.com/repos/savitojs/gtime/releases/303492022","Warn: release artifact v0.8.0 not signed: https://api.github.com/repos/savitojs/gtime/releases/303489421","Warn: release artifact v0.7.1 not signed: https://api.github.com/repos/savitojs/gtime/releases/303477907","Warn: release artifact v0.7.0 not signed: https://api.github.com/repos/savitojs/gtime/releases/295482325","Warn: release artifact v0.6.0 not signed: https://api.github.com/repos/savitojs/gtime/releases/281978394","Warn: release artifact v0.8.1 does not have provenance: https://api.github.com/repos/savitojs/gtime/releases/303492022","Warn: release artifact v0.8.0 does not have provenance: https://api.github.com/repos/savitojs/gtime/releases/303489421","Warn: release artifact v0.7.1 does not have provenance: https://api.github.com/repos/savitojs/gtime/releases/303477907","Warn: release artifact v0.7.0 does not have provenance: https://api.github.com/repos/savitojs/gtime/releases/295482325","Warn: release artifact v0.6.0 does not have provenance: https://api.github.com/repos/savitojs/gtime/releases/281978394"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}},{"name":"Contributors","score":3,"reason":"project has 1 contributing companies or organizations -- score normalized to 3","details":["Info: found contributions from: red hat"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}},{"name":"CI-Tests","score":10,"reason":"13 out of 13 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}}]},"last_synced_at":"2026-03-31T04:54:06.737Z","repository_id":303512170,"created_at":"2026-03-31T04:54:06.737Z","updated_at":"2026-03-31T04:54:06.737Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31314375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","global","python3","time","timezone","timezone-conversion","worldtime"],"created_at":"2025-12-14T13:54:19.372Z","updated_at":"2026-04-02T19:20:37.011Z","avatar_url":"https://github.com/savitojs.png","language":"Python","funding_links":[],"categories":["\u003ca name=\"utility\"\u003e\u003c/a\u003eUtilities"],"sub_categories":[],"readme":"# Global Time Utility (gtime)\n\n[![PyPI version](https://badge.fury.io/py/gtime.svg?maxAge=0)](https://badge.fury.io/py/gtime)\n[![Python Support](https://img.shields.io/pypi/pyversions/gtime.svg?maxAge=0)](https://pypi.org/project/gtime/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/savitojs/gtime/badge)](https://scorecard.dev/viewer/?uri=github.com/savitojs/gtime)\n\n**Stop Googling time zones.**\n\n![demo](./assets/demo.gif)\n\n*Recorded in [Ghostty](https://ghostty.org/). Some output may look off in the GIF but works perfectly in a real terminal. Best with Ghostty or [Kitty](https://sw.kovidgoyal.net/kitty/).*\n\n\u003e If this saves you from one more \"what time is it in Tokyo?\" search, [give it a star](https://github.com/savitojs/gtime).\n\nA modern, colorful Python CLI for global time zone lookup, comparison, and management. Fuzzy search, favorites, live updates, meeting time conversion, and beautiful terminal output.\n\n## Installation\n\n```bash\n# With uv (recommended)\nuv tool install gtime\n\n# Or with pip\npip install gtime\n\n# From source\ngit clone https://github.com/savitojs/gtime.git\ncd gtime \u0026\u0026 uv sync\nuv run gtime --help\n```\n\n## Quick Start\n\n```bash\ngtime London                              # Look up any city (fuzzy search)\ngtime add Tokyo Singapore \"New York\"      # Add favorites\ngtime                                     # Show all favorites\ngtime compare London Tokyo Sydney         # Compare times side by side\ngtime meeting at \"2:00 PM\"                # Convert across favorites\ngtime meeting at \"3 PM UTC\"               # With timezone support\ngtime watch                               # Live monitoring (refreshes every 60s)\n```\n\n## Features\n\n**Smart search** - Fuzzy matching, case-insensitive, works with typos (`gtime toky` finds Tokyo), and country names (`gtime india` finds Delhi).\n\n**Favorites** - Save your most-used cities. Sorted by UTC offset for a natural reading order.\n\n```bash\ngtime add London Tokyo Mumbai Berlin      # Add multiple cities\ngtime remove Berlin                       # Remove a city\ngtime                                     # View all favorites\n```\n\n**Meeting planner** - Convert a meeting time across all your favorite cities. Supports 12/24-hour format and timezone abbreviations.\n\n```bash\ngtime meeting at \"10:00 AM\"               # Your local time across favorites\ngtime meeting at \"15:30\"                   # 24-hour format\ngtime meeting at \"9:00 AM EST\"            # Eastern Standard Time\ngtime meeting at \"3 PM UTC\"               # Coordinated Universal Time\n```\n\n**Live watch mode** - Real-time updates for favorites or specific cities.\n\n```bash\ngtime watch                               # Monitor all favorites\ngtime compare London Tokyo --watch        # Watch specific cities\n```\n\n## GNOME Desktop Widget\n\nDisplay your favorite cities on your GNOME desktop using the [Desktop Widgets (azclock)](https://extensions.gnome.org/extension/5156/desktop-clock/) extension.\n\n![gtime desktop widget](./assets/widget-screenshot.png)\n\nThree styles available:\n\n```bash\ngtime widget        # Style A (default) - flags, color-coded time, status\ngtime widget b      # Grouped by status (Working, Sleeping, etc.)\ngtime widget c      # Compact cards with hour diff from local\n```\n\n**Style A** - Flags + color-coded time + status:\n```\n🇺🇸 New York   23:05       ● Sleeping  UTC-4\n🇨🇿 Brno       04:05  +1d  ● Sleeping  UTC+1\n🇮🇳 Delhi      09:35  +1d  ● Working   UTC+5:30\n🇦🇺 Melbourne  14:05  +1d  ● Working   UTC+11\n```\n\n**Style B** - Grouped by status:\n```\n💻 Working\n  🇮🇳 Delhi      09:35  +1d\n  🇦🇺 Melbourne  14:05  +1d\n💤 Sleeping\n  🇺🇸 New York   23:05\n  🇨🇿 Brno       04:05  +1d\n```\n\n**Style C** - Compact cards:\n```\n🇺🇸 New York  🌙\n   23:05  ● Sleeping  local\n🇮🇳 Delhi  🌅\n   09:35  +1d  ● Working  +9.5h\n```\n\n### Setup\n\n1. Install the [Desktop Widgets](https://extensions.gnome.org/extension/5156/desktop-clock/) GNOME extension\n2. Add a widget with a **Command Label** element\n3. Set the command to `gtime widget a` (or `b` / `c`)\n4. Enable **Polling** with interval `60000` (1 minute)\n\nA reference dconf config is included at `gtime/widget-azclock-sidebar.dconf`:\n\n```bash\n# Back up first\ndconf dump /org/gnome/shell/extensions/azclock/ \u003e backup.dconf\n\n# Import the sidebar layout\ndconf load /org/gnome/shell/extensions/azclock/ \u003c gtime/widget-azclock-sidebar.dconf\n```\n\n## Development\n\n```bash\nuv venv .venv \u0026\u0026 source .venv/bin/activate\nuv sync\npytest tests/\n```\n\nContributions welcome! Fork, branch, make changes, add tests, and open a PR.\n\n## License\n\nMIT - see [LICENSE](LICENSE).\n\n---\n\n[Report bugs](https://github.com/savitojs/gtime/issues) or [request features](https://github.com/savitojs/gtime/issues).\n\n**Made with ❤️ for developers working across time zones**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsavitojs%2Fgtime","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsavitojs%2Fgtime","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsavitojs%2Fgtime/lists"}