{"id":19037460,"url":"https://github.com/marsavar/suntrack","last_synced_at":"2025-10-25T10:43:56.899Z","repository":{"id":65142957,"uuid":"583104545","full_name":"marsavar/suntrack","owner":"marsavar","description":"A command line tool that lets you know when the sun rises and sets in a given city.","archived":false,"fork":false,"pushed_at":"2022-12-29T18:09:16.000Z","size":1259,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-26T07:52:59.044Z","etag":null,"topics":["cli","offline","rust","sunset","sunsrise"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/suntrack","language":"Rust","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/marsavar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-12-28T19:26:56.000Z","updated_at":"2022-12-29T15:44:49.000Z","dependencies_parsed_at":"2023-01-02T01:16:18.928Z","dependency_job_id":null,"html_url":"https://github.com/marsavar/suntrack","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marsavar/suntrack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsavar%2Fsuntrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsavar%2Fsuntrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsavar%2Fsuntrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsavar%2Fsuntrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marsavar","download_url":"https://codeload.github.com/marsavar/suntrack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsavar%2Fsuntrack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280943423,"owners_count":26417747,"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","status":"online","status_checked_at":"2025-10-25T02:00:06.499Z","response_time":81,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","offline","rust","sunset","sunsrise"],"created_at":"2024-11-08T21:59:57.357Z","updated_at":"2025-10-25T10:43:56.878Z","avatar_url":"https://github.com/marsavar.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌄 Suntrack\n\n`suntrack` is a command line tool that lets you know when the sun rises and sets in a given city.\n\n### Installation\n```shell\n$ cargo install suntrack\n```\n\n### Usage\n```\nA command line tool that lets you know when the sun rises and sets in a city on any given date\n\nUsage: suntrack [OPTIONS] \u003cCITY\u003e\n\nArguments:\n  \u003cCITY\u003e  The name of the city\n\nOptions:\n  -l, --local        Use local time instead of UTC\n  -d, --date \u003cDATE\u003e  Show times for a given date, which must be provided in the format YYYY-MM-DD. Defaults to today if not provided\n  -h, --help         Print help information\n```\n\nExample:\n```shell\n$ suntrack stockholm\n```\n\n```\n🌍 City \tStockholm (SE)\n🌄 Sunrise\t2022-12-29 07:45:00 UTC\n🌆 Sunset\t2022-12-29 13:54:03 UTC\n```\n\nIf more than one match is found, `suntrack` lets you disambiguate with multiple choices. For instance:\n\n```shell\n$ suntrack london\n```\n\n```\nFound 6 options for london:\n1) London (US)\n2) London Grove (US)\n3) Londonderry (US)\n4) London Colney (GB)\n5) London (CA)\n6) London (GB)\nInput number:\n6\n🌍 City \tLondon (GB)\n🌄 Sunrise\t2022-12-29 08:06:11 UTC\n🌆 Sunset\t2022-12-29 15:58:29 UTC\n```\n\n### Local time\nIf you want to use your local system time instead of UTC, you can use the flag `-l` or `--local`.\nFor example, if you were based in New South Wales and wanted to check sunrise and sunset times for Sydney, the times would be displayed using UTC+11.\n\n```shell\n$ suntrack -l sydney\n```\n\n```\n🌍 City \tSydney (AU)\n🌄 Sunrise\t2022-12-29 05:45:10 +11:00\n🌆 Sunset\t2022-12-29 20:08:23 +11:00\n```\n\n### Overriding the date\n`suntrack` defaults to today's sunrise and sunset times. However, you can use the `-d \u003cDATE\u003e` or `--date \u003cDATE\u003e` flag to pick an arbitrary date in the format `YYYY-MM-DD`. \n\n```shell\n$ suntrack -d 2025-08-15 'London (GB)'\n```\n```\n🌍 City \tLondon (GB)\n🌄 Sunrise\t2025-08-15 04:46:14 UTC\n🌆 Sunset\t2025-08-15 19:23:59 UTC\n```\n\n### Credits\n`suntrack` relies on the basic version of the [World Cities Database](https://simplemaps.com/data/world-cities), which is licensed under Creative Commons Attribution 4.0.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarsavar%2Fsuntrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarsavar%2Fsuntrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarsavar%2Fsuntrack/lists"}