{"id":34632091,"url":"https://github.com/ingk/chrono-ntp","last_synced_at":"2026-05-03T18:08:02.604Z","repository":{"id":309239565,"uuid":"1035534141","full_name":"ingk/chrono-ntp","owner":"ingk","description":"Simple command-line tool that synchronizes with an NTP server, displaying the precise date and time in your terminal.  Set your mechanical or digital watches or use it as a minimal distraction-free terminal clock.","archived":false,"fork":false,"pushed_at":"2026-05-03T16:42:40.000Z","size":212,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-03T17:29:06.766Z","etag":null,"topics":["clocks","ntp","time","watches"],"latest_commit_sha":null,"homepage":"","language":"Go","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/ingk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-10T15:50:43.000Z","updated_at":"2026-05-03T16:40:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"3dd93c1d-276b-4b1e-b13c-cd4494d1e8ae","html_url":"https://github.com/ingk/chrono-ntp","commit_stats":null,"previous_names":["ingk/chrono-ntp"],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/ingk/chrono-ntp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ingk%2Fchrono-ntp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ingk%2Fchrono-ntp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ingk%2Fchrono-ntp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ingk%2Fchrono-ntp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ingk","download_url":"https://codeload.github.com/ingk/chrono-ntp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ingk%2Fchrono-ntp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32579145,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: 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":["clocks","ntp","time","watches"],"created_at":"2025-12-24T16:52:44.281Z","updated_at":"2026-05-03T18:08:02.599Z","avatar_url":"https://github.com/ingk.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Improved compatibility of back to top link: See: https://github.com/othneildrew/Best-README-Template/pull/73 --\u003e\n\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n# chrono-ntp\n\n![chrono-ntp](https://honey.badgers.space/badge/-/chrono-ntp/blue?icon=feather-watch\u0026label=)\n![Supported Platforms](https://honey.badgers.space/badge/-/Linux,%20macOS,%20Windows/black?icon=feather-check\u0026label=)\n![Release](https://badgers.space/github/release/ingk/chrono-ntp?color=black)\n![Checks](https://badgers.space/github/checks/ingk/chrono-ntp/main)\n![MIT license](https://badgers.space/github/license/ingk/chrono-ntp/?color=blue)\n\n## About the Project\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n  \u003cimg src=\"assets/chrono-ntp.svg\" width=\"200rem\" height=\"200rem\" /\u003e\n\u003c/p\u003e\n\nchrono-ntp is a simple command-line tool that synchronizes with an NTP (Network Time Protocol) server to account for any difference between your computer’s clock and the actual time, displaying the precise date and time in your terminal.\n\nYou can use chrono-ntp to set your mechanical or digital watches or as a minimal distraction-free terminal clock.\n\n## Getting Started\n\nDownload the latest release from the [releases page on GitHub](https://github.com/ingk/chrono-ntp/releases) and choose the binary for your platform.\n\n### Supported Platforms\n\n| OS      | CPU Architectures |\n|---------|-------------------|\n| Linux   | x86_64, arm64     |\n| macOS   | x86_64, arm64     |\n| Windows | x86_64, arm64     |\n\n### Installation via Homebrew\n\nmacOS or Linux users can use [Homebrew](https://brew.sh/) to install chrono-ntp.\n\n```bash\nbrew tap ingk/chrono-ntp\nbrew install chrono-ntp\n```\n\n## Usage\n\nRun chrono-ntp from your terminal:\n\n```sh\nchrono-ntp [options]\n```\n\n```\nUsage of chrono-ntp:\n  -server string\n        NTP server to sync time from (default \"time.google.com\")\n  -time-zone string\n        Time zone name (e.g., 'America/New_York') (default \"Local\")\n  -show-time-zone\n        Show the time zone below time\n  -date-format string\n        Date display format (YYYY-MM-DD, DD/MM/YYYY, MM/DD/YYYY, DD.MM.YYYY) (default \"YYYY-MM-DD\")\n  -time-format string\n        Time display format (ISO8601, 12h, 12h_AM_PM, .beat, septimal, mars, lunar, unix) (default \"ISO8601\")\n  -hide-date\n        Hide the current date\n  -hide-status-bar\n        Hide the status bar\n  -beeps\n        Play 6 beeps at the end of each minute, with the sixth beep at second 0 (emulates the Greenwich Time Signal)\n  -offline\n        Run in offline mode (use system time, ignore NTP server)\n  -write-config\n        Write configuration file (merged from existing configuration file and flags)\n  -debug\n        Show debug information (e.g. offset from NTP server), then exit\n```\n\n### Example\n\n```sh\nchrono-ntp -server time.google.com -time-zone Europe/Berlin\n```\n\n![Demo GIF](assets/demo.gif)\n\n### Time Format Options\n\nThe `-time-format` option (or `time-format` in the [configuration file](#configuration-file)) controls how the time is displayed. The following formats are available:\n\n| Name                                                                                  | Configuration Value | Example     |\n|---------------------------------------------------------------------------------------|---------------------|-------------|\n| ISO 8601                                                                              | ISO8601             | 14:30:00    |\n| 12-hour                                                                               | 12h                 | 02:30:00    |\n| 12-hour (AM/PM)                                                                       | 12h_AM_PM           | 02:30:00 PM |\n| [Swatch Internet Time](https://en.wikipedia.org/wiki/Swatch_Internet_Time)            | .beat               | @625.00     |\n| [Septimal Time](http://the-light.com/cal/veseptimal.html) (base-7 pairs)              | septimal            | 43 11 52    |\n| [Coordinated Mars Time (MTC)](https://en.wikipedia.org/wiki/Timekeeping_on_Mars)      | mars                | 12:34:56    |\n| [Coordinated Lunar Time (LTC)](https://en.wikipedia.org/wiki/Timekeeping_on_the_Moon) | lunar               | 12:34:56    |\n| Unix Timestamp (seconds since epoch)                                                  | unix                | 1696173377  |\n\n### Configuration File\n\nchrono-ntp supports a configuration file for default values. You can create a TOML file at `~/.chrono-ntp.toml` to specify your preferred options, which will be loaded automatically on startup.\n\nExample `~/.chrono-ntp.toml`:\n\n```toml\nserver = \"time.google.com\"\ntime-zone = \"Europe/Berlin\"\nshow-time-zone = true\ndate-format = \"YYYY-MM-DD\"\ntime-format = \"ISO8601\"\nhide-date = false\nhide-status-bar = false\nbeeps = true\n```\n\nAny command-line options will override the values set in the configuration file.\n\n### Periodic Offset Refresh\n\nBy default, chrono-ntp automatically refreshes its time offset from the NTP server every 15 minutes while running (unless started in offline mode). This ensures the displayed time remains accurate even if your system clock drifts.\n\n## Build from Source\n\nTo build chrono-ntp from source, you will need Go installed (version 1.18 or newer recommended).\n\nClone the repository, build, and run:\n\n```sh\ngit clone https://github.com/ingk/chrono-ntp.git\ncd chrono-ntp\nmake build\n./chrono-ntp\n```\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## License\n\nThis project is distributed under the MIT License. See `LICENSE.txt` for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fingk%2Fchrono-ntp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fingk%2Fchrono-ntp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fingk%2Fchrono-ntp/lists"}