{"id":21819021,"url":"https://github.com/vernonthedev/conmon","last_synced_at":"2025-03-21T10:28:31.101Z","repository":{"id":203840598,"uuid":"710515264","full_name":"vernonthedev/conmon","owner":"vernonthedev","description":"Python terminal application that allows users to effortlessly check the connectivity of websites","archived":false,"fork":false,"pushed_at":"2024-10-11T12:24:28.000Z","size":32,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-26T07:09:22.041Z","etag":null,"topics":["async","await","http","http-client","https","python","requests","urlib"],"latest_commit_sha":null,"homepage":"","language":"Python","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/vernonthedev.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}},"created_at":"2023-10-26T21:19:30.000Z","updated_at":"2024-10-11T12:24:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"eb4aa89e-b7c5-4e6f-bfdd-00e6091470d1","html_url":"https://github.com/vernonthedev/conmon","commit_stats":null,"previous_names":["vernonthedev/conmon"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vernonthedev%2Fconmon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vernonthedev%2Fconmon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vernonthedev%2Fconmon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vernonthedev%2Fconmon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vernonthedev","download_url":"https://codeload.github.com/vernonthedev/conmon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244777420,"owners_count":20508714,"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":["async","await","http","http-client","https","python","requests","urlib"],"created_at":"2024-11-27T16:16:23.095Z","updated_at":"2025-03-21T10:28:31.072Z","avatar_url":"https://github.com/vernonthedev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n \u003cimg src=\"https://github.com/vernonthedev/conmon/assets/108737724/dbef586a-bd26-4853-9381-c1a264ecb92b\" width=\"500px\"/\u003e\n\n\u003c/div\u003e\n\u003ch1 align=\"center\"\u003eImpressive Website Connectivity Checker Documentation\u003c/h1\u003e\n\n## Table of Contents\n\u003cul\u003e\n \u003cli\u003eIntroduction\u003c/li\u003e\n \u003cli\u003eFeatures\u003c/li\u003e\n \u003cli\u003eInstallation Guide\u003c/li\u003e\n \u003cli\u003eUsage\u003c/li\u003e\n  \u003cli\u003eCommand line Arguments\u003c/li\u003e\n  \u003cli\u003eChecking Websites\u003c/li\u003e\n \u003cli\u003eExamples\u003c/li\u003e\n \u003cli\u003eContributing\u003c/li\u003e\n \u003cli\u003eLicense.\u003c/li\u003e\n\u003c/ul\u003e\n\n### Top Level Directory Structure\n\n    .\n    ├── conmon/                        # Source files (alternatively `lib` or `app`)\n      ├── __pycache__.py \n      ├── __init__.py \n      ├── __main__.py \n      ├── connection_checker.py \n      ├── cli.py \n    ├── requirements.txt              # Required installation packages\n    ├── README.md                     # Documentation files (alternatively `doc`)\n    ├── .gitignore                    # Virtual environment files ignored\n    \n## Introduction\nConmon is an exceptional Python terminal application that allows users to effortlessly check the connectivity of websites by sending a HEAD request to the server. It can efficiently detect if a website is online or offline and can also read URLs from a text file for batch checking.\n\nWhether you're a system administrator, developer, or just curious about the status of your favorite websites, Conmon makes it simple to monitor website connectivity.\n\n## Features\nConmon boasts an impressive array of features that set it apart from other website connectivity checkers:\n\n\u003cstrong\u003eWebsite Connectivity Check\u003c/strong\u003e: Conmon can determine whether a website is online or offline by sending a HEAD request to the server. This provides quick and efficient results.\n\n\u003cstrong\u003eBatch URL Checking\u003c/strong\u003e: Not just limited to checking a single website, Conmon can read a list of URLs from a text file and loop through them, displaying the status (online or offline) for each website.\n\n\u003cstrong\u003eInformative Output\u003c/strong\u003e: Conmon provides clear and informative output that includes the status of each checked website. If a website is offline, it also displays an error message to help diagnose the issue.\n\n\u003cstrong\u003eCommand-Line Interface (CLI)\u003c/strong\u003e: Conmon offers a user-friendly CLI with options to specify URLs directly as arguments or to read them from a file, making it versatile for different use cases.\n\n\u003cstrong\u003eDeveloper-Friendly\u003c/strong\u003e: Conmon is an open-source project, which means you can explore its code, contribute to its development, or even use it as a base for your own projects.\n\n\n  ## Installation Guide\n  \u003cul\u003e\n      \u003cli\u003eDownload the Zip File above or Clone the repository using \u003c/li\u003e\n  \u003c/ul\u003e\n  \n```\ngit clone https://github.com/vernonthedev/conmon.git\n```\n\u003cul\u003e\n      \u003cli\u003eCreate a virtual environment Using the following Commands in the terminal \u003c/li\u003e\n\u003c/ul\u003e\n\n```python\npython -m venv env\n```\n\u003cul\u003e\n      \u003cli\u003eActivate Virtual Environment\u003c/li\u003e\n\u003c/ul\u003e\n\n\u003eWindows\n```python\ncall /env/scripts/activate.bat\n```\n\n\u003eLinux\n```python\nsource /bin/env/activate\n```\n\u003cul\u003e\n      \u003cli\u003eInstall the packages required by running \u003c/li\u003e\n\u003c/ul\u003e\n\n```python\npip install -r requirements.txt\n```\n\n## Usage\n\u003e You can run the help command in the terminal for a more detailed help documentation.\n```python\npython -m conmon -h\n```\n\u003e Help Usage\n```\nUsage: Conmon [-h] [-u URLs [URLs ...]] [-f FILE]\nDeveloped by vernonthedev\nCheck Availability of Websites.\n\noptions:\n  -h, --help            show this help message and exit\n  -u URLs [URLs ...], --urls URLs [URLs ...]\n                        Enter one or more website URLs.\n  -f FILE, --input-file FILE\n                        Read URLs from a File.\n```\n\n### Command Line Arguments...\nConmon provides a user-friendly command-line interface with the following options:\n\n```-u```, ```--urls```: Specify one or more website URLs directly as arguments.\n\n```-f```, ```--input-file```: Read a list of URLs from a text file.\n\n### Checking Websites\nThe ```-u``` Argument supports arguments as urls that the user would like to test connectivity to.\n```python\npython -m conmon -u google.com\n#=================OUTPUT=====================\nThe Status of \"google.com\" is : \"Online!\" 👍\n```\nThe ```-f``` Argument enables the user to add a file as input to the program that contains all the website urls that the user would require to test their connectivity\n```python\npython -m conmon -f U:\\Developments\\urlSites.txt\n#===============OUTPUT=======================\nThe Status of \"google.com\" is : \"Online!\" 👍\nThe Status of \"facebook.com\" is : \"Offline?\" 👎 \n Error: \"timed out\"\nThe Status of \"idontexisthere.com\" is : \"Offline?\" 👎 \n Error: \"[Errno 11001] getaddrinfo failed\"\nThe Status of \"laucher.com\" is : \"Online!\" 👍\nThe Status of \"microsoft.com\" is : \"Online!\" 👍\n```\n\n\n## Examples\nLet's illustrate some real-world usage scenarios for Conmon:\n\n\u003cstrong\u003eWebsite Administrator\u003c/strong\u003e: You can use Conmon to regularly check the status of your company's website. By scheduling it to run periodically, you can proactively detect downtime and address issues promptly.\n\n\u003cstrong\u003eWeb Developer\u003c/strong\u003e: Conmon is a handy tool for web developers who want to monitor the websites they are working on. It helps ensure that the sites are up and running, especially during critical development and testing phases.....\n\n\u003cstrong\u003eNetwork Administrator\u003c/strong\u003e: In a corporate network environment, you can use Conmon to monitor various web services and check their accessibility. This can help you identify network-related problems.\n\n## Contributing\nConmon is an open-source project, and contributions from the community are highly valued. If you'd like to contribute to its development, please check out the \u003ca href=\"https://github.com/vernonthedev/conmon.git\"\u003eGitHub repository\u003c/a\u003e and follow the contribution guidelines.\n\n## License\nConmon is released under the MIT License. You can find the detailed license information in the project's LICENSE file.\n\nThank you for choosing Conmon for your website connectivity checking needs! We hope you find it a valuable tool for monitoring the online presence of your favorite websites. If you have any questions or encounter issues, please don't hesitate to reach out to our community of users and developers.\n\nHappy website monitoring! 🚀🌐\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvernonthedev%2Fconmon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvernonthedev%2Fconmon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvernonthedev%2Fconmon/lists"}