Skip to content

sampolmx/IGotU

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

IGotU πŸ›‘οΈ

A lightweight Python antimalware scanner – β€œI Got You” has your back.

License
Python
CI


πŸ“– Overview

IGotU is a simple, command-line antimalware tool written in Python.
Scan files or entire directories for known malware signatures, quarantine infected items, and generate quick reportsβ€”all without heavy dependencies.


πŸš€ Features

  • πŸ” File & Directory Scanning: Target individual files or recurse through folders
  • πŸ›‘ Signature-Based Detection: Works out of the box with built-in rules (YARA support planned)
  • πŸ—„οΈ Quarantine Mode: Move infected files to a safe directory
  • πŸ“‹ Reporting: Summary output in console and optional log file
  • βš™οΈ Configurable: Command-line flags for scan depth, verbosity, and quarantine path

πŸ› οΈ Requirements

  • Python 3.6 or higher :contentReference[oaicite:0]{index=0}
  • (Optional) Virtual environment tool (venv, virtualenv)

πŸ“¦ Installation

# Clone the repo
git clone https://github.com/sampolmx/IGotU.git
cd IGotU

# (Optional) create & activate virtualenv
python3 -m venv .venv
source .venv/bin/activate

# Install dependencies (if any)
pip install -r requirements.txt

----
# Show help & available options
python Antimalware.py --help

# Scan a single file
python Antimalware.py --scan /path/to/suspicious.exe

# Scan a directory (recursive)
python Antimalware.py --scan /home/user/downloads

# Scan + quarantine infected files
python Antimalware.py --scan /path/to/dir --quarantine ./quarantine
---
IGotU/
β”œβ”€β”€ .github/               # CI workflows & actions
β”‚   └── workflows/
β”œβ”€β”€ Antimalware.py         # Main antimalware scanner script
β”œβ”€β”€ LICENSE                # Apache 2.0 license :contentReference[oaicite:1]{index=1}
└── README.md              # This document

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages