================================================================================
                    MERSAD - Cyber Attack Simulation Platform
                              Installation Guide
================================================================================

QUICK START (3 Steps):
----------------------

1. EXTRACT: Right-click the ZIP and select "Extract Here"

2. RUN: 
   - Open a terminal in the extracted folder
   - Run: python3 MERSAD.AppDir/usr/bin/mersad
   
   OR for one-click launch:
   - Make it executable: chmod +x MERSAD.AppDir/AppRun
   - Double-click AppRun

3. USE: Your browser opens automatically to http://localhost:8080


INSTALL DESKTOP SHORTCUT (Optional):
-------------------------------------

To add MERSAD to your applications menu:

   cp MERSAD.AppDir/MERSAD.desktop ~/.local/share/applications/
   
Then search "MERSAD" in your app launcher.


REQUIREMENTS:
-------------
- Kali Linux (or any Linux with Python 3)
- Python 3.8 or newer (pre-installed on Kali)


FEATURES:
---------
- 86+ attack techniques mapped to MITRE ATT&CK
- Works 100% offline
- Check for updates from within the app
- SQLite database for history persistence
- Export reports to CSV


UPDATES:
--------
The app can check for new attacks without replacing itself:
1. Run with: python3 mersad --mersad https://mersad-url
2. Go to About tab and click "Check for Updates"
3. New attacks are downloaded and saved locally


SUPPORT:
--------
Created by: Engineer Malek Shashaa
Email: malekshashaa1993@gmail.com

================================================================================
