{"id":18857466,"url":"https://github.com/johnnycrazy/google-birthdays-bot","last_synced_at":"2026-02-07T04:30:17.555Z","repository":{"id":76775445,"uuid":"497363677","full_name":"JohnnyCrazy/google-birthdays-bot","owner":"JohnnyCrazy","description":"Telegram bot, which sends out a daily digest of birthdays at that day","archived":false,"fork":false,"pushed_at":"2022-05-29T10:23:20.000Z","size":73,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-30T19:34:49.020Z","etag":null,"topics":["birthday","google-contacts","oauth2","telegram","telegram-bot","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JohnnyCrazy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2022-05-28T15:57:14.000Z","updated_at":"2023-04-11T09:38:13.000Z","dependencies_parsed_at":"2023-03-01T13:45:18.655Z","dependency_job_id":null,"html_url":"https://github.com/JohnnyCrazy/google-birthdays-bot","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnnyCrazy%2Fgoogle-birthdays-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnnyCrazy%2Fgoogle-birthdays-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnnyCrazy%2Fgoogle-birthdays-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnnyCrazy%2Fgoogle-birthdays-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JohnnyCrazy","download_url":"https://codeload.github.com/JohnnyCrazy/google-birthdays-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239798770,"owners_count":19698941,"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":["birthday","google-contacts","oauth2","telegram","telegram-bot","typescript"],"created_at":"2024-11-08T04:06:30.625Z","updated_at":"2026-02-07T04:30:17.482Z","avatar_url":"https://github.com/JohnnyCrazy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Google Birthdays Bot\n\nTelegram bot, which sends out a daily digest of birthdays at that day. Source of the birthday data is google contacts/people. The API is accessed via OAuth2.\n\n\u003e Did you know Google has a special Birthday calendar, but doesn't provide a way to create notifications for them?!\n\n## Requirements\n\n- PostgreSQL\n- DBmate\n- Public-reachable webserver (for developing: localtunnel or ngrok)\n- Telegram Bot API Key\n- Google Project Credentials (Client ID, Client Secret, Redirect URL)\n\n## Docker\n\nA docker image is available via [johnnycrazy/google-birthdays-bot](https://hub.docker.com/r/johnnycrazy/google-birthdays-bot)\n\n## Configuration\n\nConfiguration is done via environment variables. On development, `direnv` together with a `.env` is used. For a sample, checkout `.env.sample`\n\n| **Key**                       | **Default**                                                                          | **Description**                                                 |\n| ----------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------- |\n| `TELEGRAM_BOT_TOKEN`          | -                                                                                    | Valid Telegram Bot API Token                                    |\n| `GOOGLE_CLIENT_ID`            | -                                                                                    | Google Credentials Client ID                                    |\n| `GOOGLE_CLIENT_SECRET`        | -                                                                                    | Google Credentials Client Secret                                |\n| `GOOGLE_REDIRECT_URL`         | -                                                                                    | Google Credentails Redirect URL                                 |\n| `JWT_SECRET`                  | -                                                                                    | Secret used for encrypting/decrypting JWT. Should be \u003e 16 Chars |\n| `PORT`                        | `3000`                                                                               | Port for the webserver, used for OAuth2 callbacks               |\n| `DATABASE_URL`                | `postgresql://postgres:postgres@localhost:5432/google_birthdays_bot?sslmode=disable` | PostgreSQL Database connection string                           |\n| `BIRTHDAY_NOTIFICATIONS_CRON` | `0 10 * * *`                                                                         | Cron when birthday notifications are sent to all users          |\n| `TZ`                          | `Europe/Berlin`                                                                      | Timezone for the cron                                           |\n| `DBMATE_MIGRATIONS_DIR`       | `db/migrations`                                                                      | Source of dbmate migrations, do not change                      |\n| `DBMATE_SCHEMA_FILE`          | `db/schema.sql`                                                                      | Source of dbmate schema, do not change                          |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnnycrazy%2Fgoogle-birthdays-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnnycrazy%2Fgoogle-birthdays-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnnycrazy%2Fgoogle-birthdays-bot/lists"}