{"id":20956077,"url":"https://github.com/rust-dd/google-calendar-cli","last_synced_at":"2025-05-14T04:33:55.402Z","repository":{"id":241973339,"uuid":"803402923","full_name":"rust-dd/google-calendar-cli","owner":"rust-dd","description":"Google Calendar CLI written in Rust","archived":false,"fork":false,"pushed_at":"2024-11-05T22:39:44.000Z","size":107,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T13:21:48.215Z","etag":null,"topics":["cli","google-calendar","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/rust-dd.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-20T16:50:21.000Z","updated_at":"2025-03-11T10:49:43.000Z","dependencies_parsed_at":"2024-05-31T00:34:25.426Z","dependency_job_id":"768dea2d-6fd1-464a-a855-9e8d5da8929b","html_url":"https://github.com/rust-dd/google-calendar-cli","commit_stats":null,"previous_names":["zeldan/google-calendar-cli","rust-dd/google-calendar-cli"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rust-dd%2Fgoogle-calendar-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rust-dd%2Fgoogle-calendar-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rust-dd%2Fgoogle-calendar-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rust-dd%2Fgoogle-calendar-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rust-dd","download_url":"https://codeload.github.com/rust-dd/google-calendar-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254071445,"owners_count":22009792,"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":["cli","google-calendar","rust"],"created_at":"2024-11-19T01:24:09.207Z","updated_at":"2025-05-14T04:33:55.132Z","avatar_url":"https://github.com/rust-dd.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Google Calendar CLI - gcal\n\n![example workflow](https://github.com/rust-dd/google-calendar-cli/actions/workflows/rust.yml/badge.svg)\n\nThe Google Calendar CLI (gcal) is a command-line interface (CLI) tool written in Rust, designed to make managing your Google Calendar from the terminal both quick and easy. Whether you're adding new events or listing existing ones, gcal allows you to do it all without leaving your terminal.\n\n\n*Note: This project is currently in its early stages. While it is functional, many features are still under development. Consider it a playground for exploration and experimentation.*\n\n![Screenshot](docs/screenshot.png)\n\nHappy scheduling!\n\n***\n\n## Installation\n\nTo get started with gcal, clone the repository and build the project using Cargo:\n\n\n```sh\ngit clone git@github.com:zeldan/google-calendar-cli.git\ncd google-calendar-cli\ncargo build \u0026\u0026 cargo install --path . --locked\n```\n\n## Usage\n\n\n### Help Command\n\nTo view available commands and options, use:\n\n\n```sh\ngcal help\n```\n\n### Example Commands\n\nHere are some example commands to help you get started:\n\n\n| Description                          | Command                                          |\n|--------------------------------------|--------------------------------------------------|\n| Quick event for today                | `gcal \"Retro \u0026 Demo at 16:00\"`                   |\n| Quick event on a specific date       | `gcal \"Appointment on June 3rd 10am-10:25am\"`    |\n| Add event specifying only the time   | `gcal \"Appointment\" \"10:25\"`                     |\n| Add event with month and day         | `gcal \"Appointment\" \"07-13 23:25\"`               |\n| Add event with full date and time    | `gcal add \"Appointment\" \"2024-07-12 10:25\"`      |\n| Add event with conference meeting    | `gcal \"Appointment\" \"23:45\" --conference`        |\n| List events                          | `gcal list`                                      |\n\n\n## Authentication\n\nTo use gcal, you'll need to authenticate with your Google account. The project includes a default, hardcoded Google API secret, which is suitable for temporary use but has a user cap. For long-term usage, or if you hit the user cap, you can set up custom authentication via Google Console.\n\n### Setting Up Custom Authentication\n\nIf you prefer to use your own Google API credentials, follow the step-by-step instructions provided [here](docs/custom_auth.md).\n\n### Authentication Process\n\n1. Run any gcal command; the authentication process will start automatically.\n2. Follow the on-screen instructions to complete the authentication.\n3. The authentication token will be saved to ~/.gcal/store.json for future use.\n\n\n## Development\n\nFor developers looking to contribute or experiment with gcal, you can run the project directly from the source:\n\n\n```sh\ncargo run -- list\n```\n\nThis command will compile and run the gcal tool, allowing you to list events or perform other tasks directly from your development environment.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frust-dd%2Fgoogle-calendar-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frust-dd%2Fgoogle-calendar-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frust-dd%2Fgoogle-calendar-cli/lists"}