Repository navigation
Phantomwatch v1.0
Pre-releaseπ PhantomWatch v1.0 β Initial Release
π PhantomWatch is now live! This release marks the first official version (v1.0) of our advanced malware analysis and threat detection toolkit.
π₯ What's New in v1.0?
β Core Features:
- Static Analysis β Extract metadata, strings, and indicators of compromise (IOCs) from suspicious files.
- Dynamic Analysis β Submit malware samples to ANY.RUN for behavioral analysis.
- Threat Intelligence β Query Hybrid Analysis for additional insights on known malware hashes.
- YARA-Based Detection β Leverage VirusTotal YARA rules for signature-based detection.
- Sigma Rule Integration β Apply SigmaHQ rules for log-based threat detection.
- Database Storage β Save analysis results for future reference.
- Configurable API Support β Easily integrate with external security services.
π Folder Structure
PhantomWatch/
βββ cli/ # Command-line interface
βββ config/ # Configuration files
βββ core/ # Core library
βββ modules/ # Core analysis modules
βββ rules/ # YARA & Sigma rules
βββ output/ # Analysis results
βββ test/ # Test Folder
βββ venv/ # Virtual environment (recommended)
βββ README.md # Documentation
π Installation and Usage
Installation
Prerequisites
Ensure your system has the following installed:
- Python 3
- pip (Python package manager)
- SQLite3
Steps
-
Clone the repository:
git clone https://github.com/Phantom-Fort/phantomwatch.git cd phantomwatch -
Run the installation script:
chmod +x install.sh ./install.sh
-
Verify installation:
phantomwatch
Usage
Initiate the interactive shell
phantomwatchselecting a Module (phantomwatch>)
use <module-name>sList available Modules (phantomwatch>)
listConfiguration
Modify config/config.json for custom settings. Sensitive credentials should be stored in config/secrets.env.
Example config.json:
{
"log_level": "info",
"database_path": "database/phantomwatch.db"
}Example secrets.env:
API_KEY=your_api_key_here
SECRET_KEY=your_secret_key_hereπ οΈ Known Issues & Fixes
sudo apt install libpcre3π’ What's Next? (v1.1 Roadmap)
π‘οΈ Enhanced Heuristic Analysis
π MITRE ATT&CK Mapping
π Web Dashboard for Reports
π΄ββ οΈ Ransomware Behavior Detection
π‘ Contribute & Feedback
π Found a bug or have an idea? Open an issue or contribute via PRs!