/horus

An OSINT / digital forensics tool built in Python

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Project | Horus

6abd - horus GitHub tag stars - horus forks - horus issues - horus License

Table of Contents

🚀 About Horus

Horus is an all-in-one encompassing tool for investigations assistance, from API leveraging to compiling data too. Its your pre-ops buddy!

⚡ Installation and Usage Instructions

To get started with this project, you will need Python installed on your device. Once it is installed, follow these steps:

  1. Clone this repository.
  2. cd to the 'horus' directory. (Make sure it isn't the outermost folder)
  3. Install dependencies using the following command: pip install -r requirements.txt
  4. In the 'horus' directory, run python3 horus.py on Linux/MacOS, or py horus.py on Windows

Note: protonvpn-cli is a requirement for the 'pvpn' command Note: openvpn CLI is a requirement for the 'ovpn' command

⚙️ API Configuration

To configure the APIs necessary for usage of certain commands, you can either manually enter them, or use the 'apicon' command

To manually configure API keys, navigate to /src/modules/var/pipes/api_config.json. Enter your API keys in their corresponding entries.

⚠️ Warning: If you are contributing to this repository or are testing it through a public fork, make sure to remove your API keys from the JSON file before pushing changes.

🔮 Intended Features

🟢 = Fully implemented or more than 80% done

🟡 = Partially implemented / In development

🔴 = To be implemented

On Shodan: Shodan is a paid API, so in order for your API to work you need to subscribe to them. A lot of its feature's location-related functionality is available in 'geolock', but more detailed features require that API.

🤝 Current Maintainers

  • 6abd (Me) | Project Lead and Developer

🛠️ Contributing

  • If you notice a bug or want to request a feature, make an issue with the appropriate tag
  • If you would like to fix a bug or add a feature yourself, make a PR and I'll take a look
  • If you would like to become a long-term maintainer/contributor, contact me
  • For any other inquiries, you may also contact me

📧 Contact Me

🤝 Acknowledgements

  • Fox | Was Previously Project Manager
  • Tornado | Was Previously QA
  • Mart | Was Previously Sr Dev
  • Mu | Was Previously Jr Dev

Some code used can be attributed to Fox and Askerdyne Ltd., specifically the 'Loki' encryption toolset.

Some .github files were made by Jesse Squires

Horus - An OSINT / digital forensics tool built in Python | Product Hunt