Skip to content

Phantomwatch v1.0

Pre-release
Pre-release

Choose a tag to compare

@Phantom-Fort Phantom-Fort released this 21 Mar 11:21
· 27 commits to main since this 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

  1. Clone the repository:

    git clone https://github.com/Phantom-Fort/phantomwatch.git
    cd phantomwatch
  2. Run the installation script:

    chmod +x install.sh
    ./install.sh
  3. Verify installation:

    phantomwatch

Usage

Initiate the interactive shell

phantomwatch

selecting a Module (phantomwatch>)

use <module-name>

sList available Modules (phantomwatch>)

list

Configuration

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

⚠️ Missing Dependencies: Ensure libpcre.so.3 is installed for YARA support. Use:

sudo apt install libpcre3

⚠️ Configuration Errors: Verify API keys in config/config.py.

πŸ“’ 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!

πŸ“© Follow & Stay Updated:

Twitter
GitHub Discussions

πŸ‘οΈ PhantomWatch – Because Threats Never Sleep. πŸ•΅οΈβ€β™‚οΈπŸ’€