Sentinel-C v3.10 🛡️

Author: Voltsparx
Contact: voltsparx@gmail.com
Language: C/C++
Repo: https://github.com/voltsparx/Sentinel-C

Sentinel-C is an Advanced Host Defense Multi-Tool.
It provides file integrity monitoring, logging, HTML reports, and additional small security utilities — designed for cybersecurity learners, professionals, and anyone who cares about system security.

---

⚠️ Ethical Use & Disclaimer

• This tool is only for ethical monitoring of systems and directories you own or have permission to monitor.
• Do not use it to tamper with, spy on, or attack systems you do not own.
• The author is not responsible for misuse.
• Data logged by Sentinel-C is stored locally for your convenience and not shared anywhere.

---

🛠️ Installation

Linux / Unix:

git clone https://github.com/voltsparx/Sentinel-C.git
cd Sentinel-C
mkdir build
cd build
cmake ..
cmake --build .

Run from build folder:

./sentinel-c --help

Optional: Add to PATH for global use:

sudo cp sentinel-c /usr/local/bin/

Windows (CMD / PowerShell):

git clone https://github.com/voltsparx/Sentinel-C.git
cd Sentinel-C
mkdir build
cd build
cmake ..
cmake --build .

Run executable:

sentinel-c.exe --help

---

📁 Project Structure

Sentinel-C/
├── src/                # Source & headers
├── CMakeLists.txt
├── README.md
├── .gitignore
├── sentinel-c-logs/    # Logs & HTML reports
│   ├── data/
│   └── reports/

• Folders data/ and reports/ are automatically created if missing.
• .sentinel.log is stored in data/.
• HTML reports are stored in reports/.

---

⚡ Features

• Multi-tool framework for daily security and monitoring.
• File integrity monitoring (NEW, MODIFIED, DELETED files).
• SHA-256 based hashing for file verification.
• Continuous monitoring with customizable intervals.
• Logs actions in HTML reports and local log files.
• Baseline integrity verification (--doctor).
• Single file verification (--verify).
• Banner display and tool information (--banner, --about).
• Compatible with Linux and Windows.
• Beginner-friendly CLI with short (-) and long (--) commands.

---

💻 Commands & Usage

Command	Short	Description	Example
Show help	-h	Display this help menu	sentinel-c --help
Version	-v	Show tool version	sentinel-c --version
Show banner	–	Display ASCII banner	sentinel-c --banner
About	–	Tool info + author contact	sentinel-c --about
Initialize baseline	-i	Scan directory and create baseline	sentinel-c --init ./myfolder
Scan	-s	Compare current directory to baseline	sentinel-c --scan ./myfolder
Monitor	-m	Continuously scan every N seconds	sentinel-c --monitor ./myfolder 10
Verify file	-f	Check SHA-256 hash of a single file	sentinel-c --verify ./file.txt
Doctor	-d	Check baseline integrity	sentinel-c --doctor

---

📌 Multi-Option Example

# Initialize baseline and then scan directory
sentinel-c --init ./myfolder
sentinel-c --scan ./myfolder

# Monitor a directory every 15 seconds
sentinel-c --monitor ./myfolder 15

# Verify a single file
sentinel-c --verify ./myfolder/file.txt

# Check baseline integrity
sentinel-c --doctor

# Show tool info with contact
sentinel-c --about

---

🟢 Output

• Colored terminal messages:

  • Green → NEW files
  • Yellow → MODIFIED files
  • Red → DELETED files

• Logs: sentinel-c-logs/data/.sentinel.log

• HTML reports: sentinel-c-logs/reports/sentinel_report_<timestamp>.html

---

⭐ Contribution

• Fork and add features freely.
• Follow ethical security guidelines.

---

📄 License

MIT License