{"id":13569808,"url":"https://github.com/oz/tz","last_synced_at":"2025-05-14T19:07:13.586Z","repository":{"id":45156875,"uuid":"334494310","full_name":"oz/tz","owner":"oz","description":"🌐 A time zone helper","archived":false,"fork":false,"pushed_at":"2025-02-14T01:46:51.000Z","size":498,"stargazers_count":860,"open_issues_count":8,"forks_count":34,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-05-10T04:06:03.043Z","etag":null,"topics":["timezone","tzdata","zone-helper"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"caffeinatedme","liberapay":"oz"}},"created_at":"2021-01-30T19:27:26.000Z","updated_at":"2025-04-28T04:36:14.000Z","dependencies_parsed_at":"2024-01-10T03:27:31.468Z","dependency_job_id":"69601bb2-d2ed-491e-b551-de07caa716c7","html_url":"https://github.com/oz/tz","commit_stats":{"total_commits":133,"total_committers":13,"mean_commits":10.23076923076923,"dds":0.631578947368421,"last_synced_commit":"a0820b3dfb1911ed81532574482f2dc9adace491"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oz%2Ftz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oz%2Ftz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oz%2Ftz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oz%2Ftz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oz","download_url":"https://codeload.github.com/oz/tz/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254178698,"owners_count":22027872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["timezone","tzdata","zone-helper"],"created_at":"2024-08-01T14:00:44.506Z","updated_at":"2025-05-14T19:07:12.788Z","avatar_url":"https://github.com/oz.png","language":"Go","readme":"# 🌐 A time zone helper\n\ntz helps you schedule things across time zones. It's an interactive TUI\nprogram that displays time across the time zones of your choosing.\n\n\n# Usage\n\nRun `tz` with no arguments to show the local time, as well as the UTC\ntime zone. It gets more useful when you pass some time zones to the\nprogram, to list those below the local time zone.\n\nFor now, you need to select the time zones from the [tz_data][tzdata]\nlist. Yes, there are plans to make this friendlier for humans too.\nYou're welcome to file an issue about it. I enjoy reading those.\n\nIf you would rather not type the list everytime, you could set an alias\nfor your shell, or use the `TZ_LIST` environment variable with a\nsemi-colon separated list of [tz data][tzdata] zone names, or use a\nconfiguration file (see *Configuration* below).\n\nCheck out `tz -h` for other flags.\n\n\u003cp align=\"center\"\u003e\n\u003cimg align=\"center\" src=\"./docs/tz.png\" /\u003e\n\u003c/p\u003e\n\nThe program will adjust to light and dark terminals themes.\n\n[tzdata]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones\n\n\n# Installing\n\nI provide linux/amd64 builds for \"official\" releases, and you can build\nfrom source for your favorite architecture. Kind souls have also\npackaged the program for other OSes.\n\n## Packages\n\n### Brew\n\nBrew has a tz package: `brew install tz`\n\n### Archlinux\n\nIf you're an Archlinux user, packages are also available:\n\n  - [tz][tz-arch] follows releases and,\n  - [tz-git][tz-arch-git] builds the `main` git branch.\n\n[tz-arch]: https://aur.archlinux.org/packages/tz\n[tz-arch-git]: https://aur.archlinux.org/packages/tz-git\n\n### Go\n```\ngo install github.com/oz/tz@latest\n```\n\n# Configuration\n\nThe tz program uses standard time zones as described\n[here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).\n\nYou can specify preferences through a configuration file, an environment variable,\nor as command arguments.\n\nThey are applied in this order, overriding at each subsequent step:\n\n1. Configuration file `~/.config/tz/conf.toml`\n2. Environment variable `TZ_LIST`\n3. Command line arguments `tz UTC`\n\nThe local time zone is always displayed first.\n\n## Configuration File\n\nConfigs are read from `$HOME/.config/tz/conf.toml`.\n\nTime zone `id`s should reference items from the standard tz database names.\nAlias them by providing your own name with the `name` key.\n\nSample configuration: [example-conf.toml](./example-conf.toml)\n\n## Environment Variable\n\nThis method only supports setting time zones. Keymaps must be configured through\nthe configuration file.\n\nSpecify time zones to display by setting the `TZ_LIST` environment variable. For\nexample, to display your local time, the time in California, and the time Paris,\nset `TZ_LIST` to `US/Pacific;Europe/Paris`.\n\nThe `TZ_LIST` environment variable recognizes items from the standard tz\ndatabase names, but you can alias these, using a special value: use the\nstandard name followed by `,` and your alias. For example:\n\n```bash\nTZ_LIST=\"Europe/Paris,EMEA office;US/Central,US office\"\n```\n\nIf adding this to a shell configuration, remember to export it:\n\n```bash\nexport TZ_LIST=\"Europe/Paris,EMEA office;US/Central,US office\"\n```\n\n\n# Building\n\nYou need a recent-ish release of go with modules support:\n\n```bash\ngit clone https://github.com/oz/tz\ncd tz\ngo build\n```\n\n\n# Testing\n\n```bash\ngo test -cover\n```\n\n\n# Debug\n\n```bash\nDEBUG=1 tz # Logs will write to debug.log\n```\n\n\n# Contributing\n\nPlease do file bugs, and feature requests.  I am accepting patches too,\nthose are the best, but please, open an issue first to discuss your\nchanges. 😄\n\n\n# License\n\nThe GPL3 license.\n\nCopyright (c) 2021-2022 Arnaud Berthomier\n","funding_links":["https://ko-fi.com/caffeinatedme","https://liberapay.com/oz"],"categories":["Go","\u003ca name=\"organizers\"\u003e\u003c/a\u003eOrganizers and calendars","Applications"],"sub_categories":["Productivity and Organization"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foz%2Ftz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foz%2Ftz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foz%2Ftz/lists"}