6abd / horus

An OSINT / digital forensics tool built in Python

Project | Horus

Table of Contents

• 🚀 About Horus
• ⚡ Installation and Usage Instructions
• ⚙️ API Configuration
• 🔮 Intended Features
• 🤝 Current Maintainers
• 🛠️ Contributing
• 📧 Contact Me
• 🤝 Acknowledgements

🚀 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

⚙️ 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

• Email: [email protected]
• Discord: maestro.hq or through the community server

🤝 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's Issues

Fallenflare Feature

Bypass Cloudflare

Ovpn Feature

Connect to a specified openvpn

ModuleNotFoundError

ModuleNotFoundError referring to main.py's call of the modules folder despite init.py files present.

Onionshare Feature

Up/download from Onionshare

Bankindex Feature

Search up BIN/IIN, sort codes, cheque details, etc.

Anonfile Feature

Up/download from Anonfiles

WiGle Feature

Use an API for SSID/BSSIDs stat, locations, and Bluetooth data

Format outputs better

Some files, like cryptotracer.py, have outputs that do not utilize the prints templates. Try to beautify the outputs using the output variables at the top of each module. Issue for beginners

FileNotFoundError: [Errno 2] No such file or directory: './var/pipes/api_config.json'

Even after moving the var folder into modules, it is still not recognized.