{"id":26167587,"url":"https://github.com/inigochoa/monitorbot","last_synced_at":"2025-10-28T19:10:14.761Z","repository":{"id":38736056,"uuid":"308871417","full_name":"inigochoa/monitorbot","owner":"inigochoa","description":"🕵️‍♂️ I am your private bot for web page monitoring. I can check the status of any web page for you.","archived":false,"fork":false,"pushed_at":"2023-03-05T15:10:21.000Z","size":134,"stargazers_count":10,"open_issues_count":4,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-14T17:43:54.551Z","etag":null,"topics":["bot","heroku","monitor","private","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/inigochoa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2020-10-31T11:57:38.000Z","updated_at":"2024-05-27T06:06:13.000Z","dependencies_parsed_at":"2025-03-11T17:42:46.385Z","dependency_job_id":"9a5d09ad-bbf1-4068-83bd-dfdd684dbaf7","html_url":"https://github.com/inigochoa/monitorbot","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/inigochoa%2Fmonitorbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inigochoa%2Fmonitorbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inigochoa%2Fmonitorbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inigochoa%2Fmonitorbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/inigochoa","download_url":"https://codeload.github.com/inigochoa/monitorbot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248930195,"owners_count":21184974,"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":["bot","heroku","monitor","private","telegram","telegram-bot"],"created_at":"2025-03-11T17:39:45.520Z","updated_at":"2025-10-28T19:10:14.652Z","avatar_url":"https://github.com/inigochoa.png","language":"JavaScript","funding_links":["https://www.buymeacoffee.com/inigochoa"],"categories":[],"sub_categories":[],"readme":"# Website monitor telegram bot\n\n![GitHub package.json version]\n\n\u003e :warning: **If you are looking for potsgres version, switch to [v1.* branch]**\n\n## What is it?\n\nI am your private bot for web page monitoring. I can check the status of any web\npage for you. I can also follow a list of URLs and notify you when their status\nchanges.\n\nI am designed to be private. I will only respond to the messages I receive\nwithin the chat that you have configured for me.\n\n## Available commands\n\n| Command | Description                                           | Parameters                                   |\n|---------|-------------------------------------------------------|----------------------------------------------|\n| /help   | Display bot usage info                                | -                                            |\n| /check  | Check the status of a URL or a list of URLs           | A URL or a list of URLs separated by a space |\n| /add    | Add a URL or a list of URLs to the tracking list      | A URL or a list of URLs separated by a space |\n| /remove | Remove a URL or a list of URLs from the tracking list | A URL or a list of URLs separated by a space |\n| /list   | Display the tracking list                             | -                                            |\n| /report | Display a report of the tracked URLs                  | -                                            |\n\n## Usage\n\n### Local\n\n1. Copy default.env to .env\n\n```\ncp default.env .env\n```\n\n2. Create a new Firebase Firestore database and set the connection values in the\n.env file. [You can read the docs at Google]\n\n3. Configure the telegram variables.\n\n    - **TELEGRAM_TOKEN**. Write to [@BotFather] to create a new bot and get its\n    unique token.\n\n    - **TELEGRAM_TO**. Find out how to get a chat id [here].\n\n4. [Optional] Asign the frequency of the check and report tasks. By default the\nfollowing values are used:\n\n    - Every minute for the check task.\n\n    - At 10 p.m. for the report task.\n\n    \u003e [Crontab guru] is a great tool for generating crontab schedule\n    expressions.\n\n5. [Optional] Set the timezone in the .env file to set the task time correctly.\n\n6. [Optional] I18n.\n\n    1. Duplicate **/locales/en.json** with the new language code.\n\n    2. Edit the translations respecting the texts in braces.\n\n    3. Write the new language code in the .env file...\n\n### Deploying to Heroku\n\nHeroku is a great hosting for this bot as it provides everything you need for\nfree. To carry out the deployment of the project you will need to:\n\n1. Push the code to a Github repository.\n\n2. Connect your Heroku and GitHub accounts.\n\n3. Create a new Heroku app and select GitHub as the deployment method. Choose\nmain branch. Enable *Automatic Deploys* if you wish.\n\n4. In the *Resources* section change the Dyno type from web to **worker**.\n\n5. Create the missing environment variables in the *Settings* section.\n\n## Contributing\n\nPlease make sure to read the [Contributing Guide] to learn about our submission\nprocess, coding rules and more.\n\nHelp us keep Angular open and inclusive. Please read and follow our [Code of\nConduct].\n\n## Supporting\n\nIf you are considering supporting the project, you could buy the developer a\ncoffee.\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://www.buymeacoffee.com/inigochoa\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/default-orange.png\" alt=\"Buy Me A Coffee\" height=\"41\" width=\"174\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n[GitHub package.json version]: https://img.shields.io/github/package-json/v/inigochoa/monitorbot?label=Version\u0026style=flat-square\n[v1.* branch]: https://github.com/inigochoa/monitorbot/tree/postgres\n[You can read the docs at Google]: https://firebase.google.com/docs/firestore/quickstart?hl=en\n[@BotFather]: https://t.me/BotFather\n[here]: https://stackoverflow.com/a/32572159\n[Crontab guru]: https://crontab.guru/\n[Contributing Guide]: https://github.com/inigochoa/monitorbot/blob/main/CONTRIBUTING.md\n[Code of Conduct]: https://github.com/inigochoa/monitorbot/blob/main/CODE_OF_CONDUCT.md\n[Buy me a coffee]: https://www.buymeacoffee.com/inigochoa\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finigochoa%2Fmonitorbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finigochoa%2Fmonitorbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finigochoa%2Fmonitorbot/lists"}