{"id":20612114,"url":"https://github.com/sindhuinti/chronx","last_synced_at":"2025-04-15T05:43:25.505Z","repository":{"id":165228421,"uuid":"640586058","full_name":"Sindhuinti/Chronx","owner":"Sindhuinti","description":"📆Chronx is a CLI tool that offers a set of commands for managing your calendar events with ease! ","archived":false,"fork":false,"pushed_at":"2023-10-16T06:05:51.000Z","size":81,"stargazers_count":24,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T05:43:20.105Z","etag":null,"topics":["cobra-cli","go","google-calendar-api","oauth2"],"latest_commit_sha":null,"homepage":"https://pkg.go.dev/github.com/Sindhuinti/chronx","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sindhuinti.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-14T15:25:41.000Z","updated_at":"2025-02-02T23:44:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"346f178e-1b0d-49eb-abf9-6390d16a463d","html_url":"https://github.com/Sindhuinti/Chronx","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sindhuinti%2FChronx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sindhuinti%2FChronx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sindhuinti%2FChronx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sindhuinti%2FChronx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sindhuinti","download_url":"https://codeload.github.com/Sindhuinti/Chronx/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249016308,"owners_count":21198829,"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":["cobra-cli","go","google-calendar-api","oauth2"],"created_at":"2024-11-16T10:23:19.358Z","updated_at":"2025-04-15T05:43:25.487Z","avatar_url":"https://github.com/Sindhuinti.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chronx\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./logo.png\" width=\"300px\"\u003e\n\n![GitHub](https://img.shields.io/github/license/sindhuinti/chronx) ![GitHub last commit](https://img.shields.io/github/last-commit/sindhuinti/chronx)\n[![Go-reference](https://pkg.go.dev/badge/github.com/Sindhuinti/kubebrew.svg)](https://pkg.go.dev/github.com/Sindhuinti/chronx)\n\u003c/div\u003e\n\nChronx is a command line tool that allows you to access your Google Calendar(s) from a command line. It's easy to get your events, search for events, add new events, delete events. from your terminal without any extra clicks. \n\nTo install the Chronx CLI, use the command `go install github.com/sindhuinti/chronx@latest`. Go will automatically install it in your $GOPATH/bin directory, which should be in your $PATH.\n\nOnce installed, you can use the Chronx CLI command.\n\n\u003e **Note** If you are getting an error like `command not found: chronx`, then you need to add `$GOPATH/bin` to your `$PATH` environment variable. \n\n## Features\n- OAuth2 authention with your Google account\n- list your calendars\n- add event to calendar\n- show details of event\n- delete an event\n- flag file support for specifying option defaults\n\n## How to use\n\n```bash\nChronx is a CLI tool that offers a set of commands for managing your calendar events with ease!\n\nUsage:\n  chronx [command]\n\nAvailable Commands:\n  add         Add new event to user's calendar\n  delete      Delete an existing event in user's calendar\n  help        Help about any command\n  init        Add user's google calendar oauth token\n  list        Get list of events from user's calendar\n\nFlags:\n  -h, --help      help for chronx\n  -v, --version   version for chronx\n\nUse \"chronx [command] --help\" for more information about a command.\n```\n\n### usage\nchronx provides a series of subcommands with the following functionality:\n\n```bash\ninit         oauth the user account\nadd          add new event to calendar\nlist         list upcoming event\ndelete       delte an event\nhelp         help about any command\nversion      get version of the tool\n```\n\n### Login information\n\nOAuth2 is used for authenticating with your Google account. The resulting token is placed in the `%LOCALPATH%\\chronxToken` file in windows and `/tmp/chronxToken` file in linux (or) macOS. When you first start chronx using  `chronx init` command, the authentication process will proceed. Simply follow the instructions.\n\nYou currently have to use your own Calendar API token. Our Calendar API token is restricted to few users only and waits for Google's approval to be unlocked.\n\n1. [Create a New Project](https://console.cloud.google.com/projectcreate) within the Google developer console\n2. Enable the [Google Calendar API](https://console.cloud.google.com/apis/api/calendar-json.googleapis.com)\n3. [Create OAuth2 consent screen](https://console.cloud.google.com/apis/credentials/consent/edit;newAppInternalUser=false) for an \"Desktop Application\".\n4. [Create OAuth Client ID](https://console.cloud.google.com/apis/credentials/oauthclient)\n5. Grab your newly created Client ID and Client Secret from the Credentials page.\n6. Set these google credientials as Environmental varibales in your system and call `chronx init` command.\n\u003e **Note** ClientID as `CHRONXID` and client secret as `CHRONXSECRET`\n\n7. This should provide with a link to open it in your default browser.\n\n## License\nThis project is licensed under the Apache-2.0 license - see the [LICENSE](https://github.com/Sindhuinti/chronx/blob/main/LICENSE) file for details.\n\n## Support\n\nDon't forget to leave a star ⭐️.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsindhuinti%2Fchronx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsindhuinti%2Fchronx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsindhuinti%2Fchronx/lists"}