Skip to content

AswinMathew2004/ForensX-Lab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”¬ ForensX Lab β€” Digital Forensics & Evidence Preservation

Live Demo License ACPO

An all-in-one, browser-based digital forensics toolkit for evidence acquisition, analysis, and court-admissible report generation β€” following ACPO chain of custody guidelines.

Author: Aswin Mathew


πŸš€ Features

πŸ” Acquisition Tools

  • Hash Calculator β€” MD5, SHA-1, SHA-256, SHA-512 for files & text
  • Hex Viewer β€” Binary inspection with hex dump + ASCII view
  • Metadata Extractor β€” File properties, EXIF/image data extraction
  • File Signature Analyzer β€” Magic bytes detection for true file type verification
  • String Extractor β€” ASCII string extraction with URL, email & path detection

πŸ” Analysis Tools

  • Hash Comparator β€” Evidence integrity verification through hash comparison
  • Base64 Codec β€” Encode/decode Base64 data
  • Entropy Analysis β€” Shannon entropy for encryption/compression detection
  • Steganography Detector β€” LSB analysis, appended data detection, entropy profiling

πŸ“„ Reporting & Chain of Custody

  • Case Management β€” Full case information setup
  • Chain of Custody Log β€” ACPO-compliant evidence handling records
  • Evidence Registry β€” Central evidence log with hash tracking
  • Timeline / Audit Trail β€” Automatic activity logging for all tools
  • Report Generator β€” Court-admissible HTML/Text forensic reports with signatures

πŸ“– Reference

  • ACPO Guidelines β€” Full 4-principle reference with implementation checklist

πŸ›‘οΈ Privacy & Security

100% Client-Side Processing β€” No data leaves your browser. Ever.

  • βœ… No server-side processing
  • βœ… No file uploads to external services
  • βœ… No cookies, tracking, or analytics
  • βœ… Works completely offline after first load
  • βœ… Safe for handling sensitive investigation data

πŸ“¦ Deployment (Free on GitHub Pages)

Quick Setup (5 minutes)

  1. Fork or clone this repository:

    git clone https://github.com/yourusername/forensx-lab.git
    cd forensx-lab
  2. Push to your GitHub account:

    git remote set-url origin https://github.com/yourusername/forensx-lab.git
    git push -u origin main
  3. Enable GitHub Pages:

    • Go to your repo β†’ Settings β†’ Pages
    • Source: Deploy from a branch
    • Branch: main β†’ / (root)
    • Click Save
  4. Access your live site:

    https://yourusername.github.io/forensx-lab/
    

Alternative: Download & Run Locally

Just download index.html and open it in any modern browser. That's it β€” no build tools, no dependencies, no server needed.


πŸ’» Compatibility

Browser Status
Chrome 90+ βœ… Full Support
Firefox 88+ βœ… Full Support
Edge 90+ βœ… Full Support
Safari 15+ βœ… Full Support
Mobile Chrome/Safari βœ… Responsive UI

Requirements: Modern browser with Web Crypto API support (all current browsers).


πŸ”¬ ACPO Compliance

This tool follows the Association of Chief Police Officers (ACPO) Good Practice Guide for Digital Evidence:

Principle Description How ForensX Implements It
1 No action should change evidence data All processing is read-only on forensic copies
2 Accessing original data requires competency Tool provides guidance and reference materials
3 Audit trail must be maintained Automatic timeline logging of all activities
4 Investigation lead has overall responsibility Case management with examiner designation

πŸ“‹ Use Cases

  • Digital Forensic Investigations β€” Analyze files, verify integrity, document chain of custody
  • Incident Response β€” Quick file triage, hash verification, string extraction
  • Cybersecurity Training β€” Learn forensic methodology with hands-on tools
  • Academic Projects β€” Demonstrate digital forensics concepts
  • Evidence Processing β€” Generate court-admissible documentation

πŸ—οΈ Architecture

forensx-lab/
β”œβ”€β”€ index.html          # Single-file application (HTML + CSS + JS)
β”œβ”€β”€ README.md           # This file
└── LICENSE             # MIT License

Zero dependencies. Zero build step. One file.

The entire application is contained in a single index.html file using:

  • Vanilla JavaScript (no frameworks)
  • Web Crypto API for cryptographic hashing
  • CSS Grid/Flexbox for responsive layout
  • FileReader API for local file processing

🀝 Contributing

Contributions welcome! Ideas for expansion:

  • NTFS/FAT filesystem parser
  • Registry hive viewer
  • Email header analyzer
  • Network packet parser (PCAP)
  • Memory dump analyzer
  • Disk image mounting (dd/E01)
  • PDF metadata deep extraction
  • EXIF GPS coordinate mapping
  • Multi-language support

πŸ“œ License

MIT License β€” See LICENSE for details.


πŸ‘€ Author

Aswin Mathew
🌐 aswinmathew.xyz


⚠️ Disclaimer: This tool is for educational and legitimate forensic purposes only. Always follow applicable laws and obtain proper authorization before examining digital evidence.

About

πŸ”¬ ForensX Lab β€” All-in-one browser-based digital forensics toolkit. Hash calculator, hex viewer, metadata extractor, steganography detector, chain of custody, and court-admissible report generator. ACPO compliant. Zero dependencies. 100% client-side.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages