https://github.com/kero99/mftmactime

MFT and USN parser that allows direct extraction in filesystem timeline format (mactime), dump all resident files in the MFT in their original folder structure and run yara rules over them all.
https://github.com/kero99/mftmactime

forensics-tools mft ntfs ntfs-ads ntfs-journal python

Last synced: 5 months ago
JSON representation

MFT and USN parser that allows direct extraction in filesystem timeline format (mactime), dump all resident files in the MFT in their original folder structure and run yara rules over them all.

• Host: GitHub
• URL: https://github.com/kero99/mftmactime
• Owner: kero99
• Created: 2022-08-03T14:49:39.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-05-10T17:45:48.000Z (almost 2 years ago)
• Last Synced: 2024-02-14T20:39:32.145Z (about 1 year ago)
• Topics: forensics-tools, mft, ntfs, ntfs-ads, ntfs-journal, python
• Language: Python
• Homepage:
• Size: 32.2 KB
• Stars: 9
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-forensics - MFTMactime - MFT and USN parser that allows direct extraction in filesystem timeline format (mactime), dump all resident files in the MFT in their original folder structure and run yara rules over them all. (Tools / Windows Artifacts)

README

        
# Description

This is an MFT and USN parser that allows direct extraction in filesystem timeline format (mactime), dump all resident files in the MFT in their original folder structure and run yara rules over them all.

It uses Omer BenAmram's (https://github.com/omerbenamram/mft) great MFT rust parsing libraries, which allows a great speed and efficiency in the process.

The integration with the USN Journal parser allows to have in the same timeline the combined MFT and USN data. 

You can use as input files either individual files derived from a triage or a forensic image in RAW format or a mixture of both modes. In case the input is RAW the artifacts will be dumped in a selected directory.

# Requirement

pip install mft argparse tqdm pytz pytsk3 yara-python

# Use

usage: mftmactime [-h] [-V] -f FILE -o OUTPUT [-m DRIVE] [-n] [-tz TIMEZONE] [-r RESIDENT] [-u USN] [-s OFFSET] [-d DUMP_PATH] [-y YARA_RULES] [-yc YARA_COMPILED]

                        

# Example

mftmactime.py -f /mnt/comp001/\\$MFT -o comp001_fstl.csv -n

![image](https://user-images.githubusercontent.com/143736/183637088-0089c8c4-ef23-46e1-bbd5-8321422108cb.png)

# Example with dump resident files

mftmactime -f MFT -o test.csv -n -r recovery_output

![Screenshot at 2022-09-07 11-29-48](https://user-images.githubusercontent.com/143736/188844076-9eefc9b7-9801-4c23-a0df-0ef794b92dc1.png)

# Example of inode entries with USN Journal and MFT mixed data

![image](https://user-images.githubusercontent.com/143736/191730418-ba1f5a8d-2ff0-4e88-aa30-236c5169e580.png)

# Example of dump and process from RAW Evidence

mftmactime -n -f ../evidence/Testing/test-img.dd -u ../evidence/Testing/test-img.dd -o ./filesystem_tln.csv -d dump -r resindents

![image](https://user-images.githubusercontent.com/143736/191998130-097e69ea-80dc-4684-80ba-d4dfbe861452.png)

# Example of run yara rules over resident files

![mftmactime-yara](https://user-images.githubusercontent.com/143736/218285321-effe1042-9695-4e88-abe9-de9d30fbaa7f.png)