{"id":15472599,"url":"https://github.com/wberredo/isitup","last_synced_at":"2025-04-22T13:47:06.819Z","repository":{"id":87260379,"uuid":"85844482","full_name":"WBerredo/IsItUP","owner":"WBerredo","description":"Telegram bot to verify if a website is up or track an URL to be notified when it gets down.","archived":false,"fork":false,"pushed_at":"2018-04-05T18:15:54.000Z","size":47,"stargazers_count":35,"open_issues_count":3,"forks_count":14,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-10T08:56:03.620Z","etag":null,"topics":["bot","down","isitup","telegram","up","website"],"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/WBerredo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2017-03-22T15:27:11.000Z","updated_at":"2024-05-20T00:08:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"9945d444-7f87-473a-9ca2-43f962a1d9b4","html_url":"https://github.com/WBerredo/IsItUP","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WBerredo%2FIsItUP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WBerredo%2FIsItUP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WBerredo%2FIsItUP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WBerredo%2FIsItUP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WBerredo","download_url":"https://codeload.github.com/WBerredo/IsItUP/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250251444,"owners_count":21399823,"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","down","isitup","telegram","up","website"],"created_at":"2024-10-02T02:40:23.010Z","updated_at":"2025-04-22T13:47:06.812Z","avatar_url":"https://github.com/WBerredo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IsItUP? Bot\n\u003e A Telegram bot that verifies whether or not a website is up, tracks URLs and notifies when hosts have unreachable connections. https://t.me/Is_it_UPBot\n\n\u003cimg src=\"logo.jpg\" width=\"48px\" /\u003e\n\n## Installation\n\n1. Meet [IsItUP?](https://t.me/Is_it_UPBot) at telegram :D\n\n### or run your own bot\n1. Clone the project\n2. Go to your IsItUp directory\n```bash\ncd /path/to/IsItUP/\n```\n\n3. Set an enviroment variable named `IS_IT_UP_TOKEN` with your telegram token.\nRead this [great article](https://www.schrodinger.com/kb/1842) and learn how to do it properly.\nOn bash:\n```bash\nexport IS_IT_UP_TOKEN=your_telegram_token\n```\n4. (Optional) Setup Firebase if you want to enable the [track feature](#track-if-enabled))\n    * [Create a Firebase project and download its credentials](https://firebase.google.com/docs/server/setup)\n    * Set environment variables named `IS_IT_UP_FIREBASE_PRIVATE_KEY`,\n    `IS_IT_UP_FIREBASE_CLIENT_EMAIL` and `IS_IT_UP_FIREBASE_DATABASE_URL` with your firebase credentials (private key and client email are in the downloaded file)\n    ```bash\n    export IS_IT_UP_FIREBASE_CLIENT_EMAIL=email@domain.com\n    ```\n\n5. Install [node and npm](https://docs.npmjs.com/getting-started/installing-node)\n\n6. Download the dependencies\n```bash\nnpm install\n```\n\n7. Run the script\n```bash\nnpm start\n```\n\n## Usage\n\nIt can be done with [IsItUP?](https://t.me/Is_it_UPBot) bot or your own bot:\n\n### Conversation\n\n* Start a conversation with the bot\n* Type:\n```\n/verify https://telegram.org\n```\nor just\n```\nhttps://telegram.org\n```\nto verify whether a website is available or not\n\n### Track (if enabled)\n* You may track an URL by typing: _// check step #4 for enabling tracking_\n```\n/track https://telegram.org\n```\n\n* You may delete an URL from the track list by typing:\n```\n/track_delete\n```\nand then click at the URL you want to delete\n\n* To list the URLs you are tracking:\n```\n/track_list\n```\n\nEvery 5 minutes the bot will check the track list. The user will be notified when the status of an URL get changed(up-\u003edown, down-\u003eup).\n\n### Group\n* You may as well [invite](http://stackoverflow.com/a/40175742) the bot to a group\n\n* Call it by name and tell the domain you want to watch\n```\n@Is_it_UPBot https://telegram.org\n```\n\nPS: telegram.org is a sample (of course :D), type whatever you need.\n\n## Contributing\n\n1. Fork it!\n2. Create your feature branch: `git checkout -b my-new-feature`\n3. Commit your changes: `git commit -am 'Add some feature'`\n4. Push to the branch: `git push origin my-new-feature`\n5. Submit a pull request :D\n\n## Thanks\n\n* [isitup.org](https://isitup.org/) - for the concepts and ideas\n* [Node.js Telegram Bot API](https://github.com/yagop/node-telegram-bot-api) - for providing an easy way to create a telegram bot\n\n\n## License\n[MIT](LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwberredo%2Fisitup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwberredo%2Fisitup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwberredo%2Fisitup/lists"}