{"id":24163279,"url":"https://github.com/hackfutsec/envspy","last_synced_at":"2025-10-07T02:12:09.005Z","repository":{"id":270527554,"uuid":"910657863","full_name":"HackfutSec/EnvSpy","owner":"HackfutSec","description":"EnvSpy: Uncover and extract hidden .env files with ease – your ultimate tool for configuration discovery!","archived":false,"fork":false,"pushed_at":"2025-03-18T20:44:36.000Z","size":29,"stargazers_count":1,"open_issues_count":11,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-13T19:42:17.007Z","etag":null,"topics":["automation","cybersecurity","cybersecurity-tools","env","environment-file-management","ethical-hacking","python-tools","scripting","web-scraping"],"latest_commit_sha":null,"homepage":"https://github.com/HackfutSec/EnvSpy.git","language":"Python","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/HackfutSec.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":"2025-01-01T00:40:36.000Z","updated_at":"2025-03-18T20:44:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"70e91ba0-e146-43bf-95d6-b9cfc8542b63","html_url":"https://github.com/HackfutSec/EnvSpy","commit_stats":null,"previous_names":["hackfutsec/envspy"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/HackfutSec/EnvSpy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackfutSec%2FEnvSpy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackfutSec%2FEnvSpy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackfutSec%2FEnvSpy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackfutSec%2FEnvSpy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HackfutSec","download_url":"https://codeload.github.com/HackfutSec/EnvSpy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackfutSec%2FEnvSpy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278708004,"owners_count":26031932,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["automation","cybersecurity","cybersecurity-tools","env","environment-file-management","ethical-hacking","python-tools","scripting","web-scraping"],"created_at":"2025-01-12T18:17:15.212Z","updated_at":"2025-10-07T02:12:09.000Z","avatar_url":"https://github.com/HackfutSec.png","language":"Python","readme":"# **EnvSpy**  \n**Uncover and extract hidden `.env` files with ease – your ultimate tool for configuration discovery!**\n\n[![GitHub](https://img.shields.io/github/license/HackfutSec/EnvSpy)](https://github.com/HackfutSec/EnvSpy)  \n[![GitHub issues](https://img.shields.io/github/issues/HackfutSec/EnvSpy)](https://github.com/HackfutSec/EnvSpy/issues)  \n[![GitHub forks](https://img.shields.io/github/forks/HackfutSec/EnvSpy)](https://github.com/HackfutSec/EnvSpy/network)\n\n## **Overview**\n\n**EnvSpy** is a powerful tool designed to uncover and retrieve `.env` files from URLs or from a list of URLs provided in a file. It allows security researchers and developers to quickly extract environment variable files from web resources, automate the process of retrieving sensitive information (if legally permitted), and offers integration with Telegram for easy alerts.\n\n---\n\n## **Features**\n\n- **Retrieve `.env` Files**: Extract `.env` files from any accessible URL.\n- **Bulk URL Processing**: Process a list of URLs from a file, one after another.\n- **Save Results**: Save retrieved `.env` file contents to a local file for future reference.\n- **Telegram Integration**: Automatically send the results to your Telegram bot for real-time monitoring and alerts.\n- **Customizable Timeout**: Adjust the timeout for HTTP requests to suit your network conditions.\n- **Clear, User-Friendly Interface**: Dynamic and clean terminal output with beautiful banners.\n\n---\n\n## **Installation**\n\n### **Prerequisites**\n- Python 3.x\n- The following Python packages:\n  - `requests`\n  - `beautifulsoup4`\n  - `colorama`\n\n### **Step 1: Clone the Repository**\nClone the repository to your local machine:\n\n```bash\ngit clone https://github.com/HackfutSec/EnvSpy.git\ncd EnvSpy\n```\n\n### **Step 2: Install Dependencies**\nInstall the required Python dependencies using `pip`:\n\n```bash\npip install -r requirements.txt\n```\n\n### **Step 3: Run the Tool**\nOnce the installation is complete, you can start using **EnvSpy** by running:\n\n```bash\npython envspy.py\n```\n\n---\n\n## **Usage**\n\nWhen you run the tool, you’ll be presented with a menu of options:\n\n1. **Test a single URL**: Enter a URL to retrieve the `.env` file content.\n2. **Test multiple URLs**: Provide a file containing a list of URLs to process.\n3. **Exit**: Exit the program.\n\nIf you choose to send the results to your Telegram bot, you will be prompted for:\n- **Telegram Bot Token**: Create a bot via [BotFather](https://core.telegram.org/bots#botfather) on Telegram and get your token.\n- **Chat ID**: Get the chat ID to send messages using your bot. You can use this [Telegram API tool](https://api.telegram.org/bot\u003cYourBotToken\u003e/getUpdates) to find your chat ID.\n\n### **Example Menu Flow:**\n\n```bash\n[1] Test a single link.\n[2] Test a file containing multiple links.\n[3] Exit the program.\nChoose an option (1/2/3):\n```\n\n---\n\n## **Command-Line Arguments**\n\nYou can also use the following command-line arguments for customization:\n\n- `--lines-per-page`: Number of lines to display per page.\n- `--timeout`: HTTP request timeout duration (default is 5 seconds).\n\n### **Example:**\n\n```bash\npython envspy.py --lines-per-page 50 --timeout 10\n```\n\n---\n\n## **Example Output**\n\nWhen testing a URL, you will see output similar to this:\n\n```bash\n[✓] Content found at the following URL: http://example.com/.env\nHTML page content (only visible text):\nDB_HOST=localhost\nDB_PORT=3306\nDB_USER=root\nDB_PASS=password\n\nResults saved to env.txt\n```\n\nFor bulk URL testing, the program will display:\n\n```bash\n[!] Processing URL: http://example.com/.env\n[✓] Content found at the following URL: http://example.com/.env\nHTML page content (only visible text):\nDB_HOST=localhost\nDB_PORT=3306\nDB_USER=root\nDB_PASS=password\n\nResults saved to env.txt\n```\n\n---\n\n## **Telegram Integration**\n\nIf you opt to send the results to your Telegram bot, the tool will automatically send the contents of the `.env` file to the chat you specify.\n\nExample:\n\n```bash\n[✓] Message sent to Telegram.\n```\n\n---\n\n## **Contributing**\n\nWe welcome contributions to **EnvSpy**! If you have ideas for new features, bug fixes, or improvements, please fork the repository and create a pull request.\n\n### Steps to contribute:\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature-name`).\n3. Make your changes.\n4. Commit your changes (`git commit -am 'Add new feature'`).\n5. Push to your branch (`git push origin feature-name`).\n6. Open a pull request.\n\n---\n\n## **License**\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## **Acknowledgments**\n\n- Thanks to [HackfutSec](https://github.com/HackfutSec) for making **EnvSpy** available to the community.\n- Libraries used in this project:\n  - [requests](https://docs.python-requests.org/en/master/)\n  - [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/)\n  - [colorama](https://pypi.org/project/colorama/)\n\n---\n\n## **Disclaimer**\n\n**EnvSpy** is a tool designed for educational and ethical use. **The creator is not responsible for the misuse of this tool**. Always ensure that you have permission to access the URLs and data you are working with.\n\n--- \n\nFeel free to adjust the details like your GitHub username or any additional features you might add. This README will help users easily understand the tool's purpose, how to install and use it, and how to contribute.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackfutsec%2Fenvspy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhackfutsec%2Fenvspy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackfutsec%2Fenvspy/lists"}