Skip to main content

Signature Agnostic Binary Visualizer based on SAGMAD

Project description

SABV (Signature-Agnostic Binary Visualizer)

A PE/binary-to-image converter designed to visualize any binary file.
Optionally integrates a fuzzy-inference system (FIS) inspired by the SAGMAD methodology.

SABV allows:

  • Conversion of arbitrary binary files into structured image representations
  • Optional fuzzy-inference enhanced visualizations
  • Custom color schemes
  • Configurable sampling, resolution, and threading

Installation

git clone https://github.com/AquaCoder0010/SABV.git
pip install -r requirements.txt

Example Usage

Basic Visualization (FIS disabled)

from SABV import SABV
import cv2

# visualization without fuzzy inference
sabv = SignatureAgnosticBinaryVisualizer()
img = sabv.process_file("ENTER-FILE-PATH")

cv2.imwrite("IMAGE_PATH.png", img)

Basic Visualization with custom color scheme

from SABV import SABV
import cv2

# note that color_scheme must be a function as well as a function that returns a tuple
def custom_color_scheme(byte):
	if byte > 128:
	   return (128, 128, 128)
	return (255, 255, 255)

sabv = SignatureAgnosticBinaryVisualizer()
sabv.set_color_scheme(custom)
img = sabv.process_file("ENTER-FILE-PATH")
cv2.imwrite("IMAGE_PATH.png", img)

Visualization With Fuzzy Inference System (FIS)

from SABV import SABV
import cv2

sabv_with_fis = SABV(FIS_ENABLED=True, N=3, sample=0.05, FIS_THREADING_ENABLED=True)
img = sabv.process_file("ENTER-FILE-PATH")

cv2.imwrite("IMAGE_PATH.png", img)

Benchmark

alt text

Example Images

with FIS

alt text

without FIS

alt text

Citation

Saridou, B.; Rose, J. R.; Shiaeles, S.; Papadopoulos, B.
SAGMAD—A Signature Agnostic Malware Detection System Based on Binary Visualisation and Fuzzy Sets.
Electronics, 2022, 11, 1044.
https://doi.org/10.3390/electronics11071044

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sabv-0.1.0.tar.gz (2.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sabv-0.1.0-py3-none-any.whl (2.8 kB view details)

Uploaded Python 3

File details

Details for the file sabv-0.1.0.tar.gz.

File metadata

  • Download URL: sabv-0.1.0.tar.gz
  • Upload date:
  • Size: 2.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for sabv-0.1.0.tar.gz
Algorithm Hash digest
SHA256 35c2b813128520a5f9fc68e58e7468dcfc74a9637ed85fc3243de9d2ae2b9913
MD5 ff3028fc8c03a9a17871417855d44ea0
BLAKE2b-256 b7919f61a031f507acded3732c5a9082b990cad0ca6e2d951559144a5a8ab984

See more details on using hashes here.

File details

Details for the file sabv-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: sabv-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 2.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for sabv-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f3db7e02b6426606cfff22e9170de5eabdf6418ff880dc38d82110d0da6ef375
MD5 67099f57688d9dedf6d5c91761e81a65
BLAKE2b-256 316ee282c448fb2d5257d7208203e368f53e182bc2d6bf6fa3f997fd93f3045d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page