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

pip install SABV

Installation from source

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.1.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.1-py3-none-any.whl (2.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: sabv-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 a27adc953ca4baeb64686ae545eec86b998cb1133233ccdb45bb51a0fa895db8
MD5 26837f8f5c38eab1c6818c153b89d4fc
BLAKE2b-256 389b84c7d9eaf3e7a5790c4889571d602bd69b7997c3b2a163c19520aa890db7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: sabv-0.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 641a2a7d97fdd9377b33069410d9cbf3293ea9beafbe7d6b2dfb05e79a25f0f1
MD5 4484e8c589ad59388bda774227971140
BLAKE2b-256 77158002379288316ba624bd95edc83381bc8454333d48498927b78220314e20

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