{"id":31745292,"url":"https://github.com/mateocallec/spoofeye","last_synced_at":"2025-10-09T12:49:13.976Z","repository":{"id":317887683,"uuid":"1069209102","full_name":"mateocallec/SpoofEye","owner":"mateocallec","description":"Network monitoring and spoofing detection tool","archived":false,"fork":false,"pushed_at":"2025-10-03T16:21:41.000Z","size":742,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-03T18:36:25.603Z","etag":null,"topics":["cybersecurity","monitoring","spoofing-attack"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mateocallec.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-03T15:11:37.000Z","updated_at":"2025-10-03T16:21:45.000Z","dependencies_parsed_at":"2025-10-03T18:36:28.086Z","dependency_job_id":"cad84f21-5075-4718-ad7e-606cfca91a3d","html_url":"https://github.com/mateocallec/SpoofEye","commit_stats":null,"previous_names":["mateocallec/spoofeye"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mateocallec/SpoofEye","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateocallec%2FSpoofEye","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateocallec%2FSpoofEye/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateocallec%2FSpoofEye/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateocallec%2FSpoofEye/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mateocallec","download_url":"https://codeload.github.com/mateocallec/SpoofEye/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateocallec%2FSpoofEye/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001422,"owners_count":26083078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","monitoring","spoofing-attack"],"created_at":"2025-10-09T12:49:12.756Z","updated_at":"2025-10-09T12:49:13.968Z","avatar_url":"https://github.com/mateocallec.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://github.com/mateocallec/SpoofEye\"\u003e\u003cimg src=\"https://github.com/mateocallec/SpoofEye/blob/main/docs/img/icon-2048x2048.png?raw=true\" alt=\"SpoofEye\" height=\"217\" /\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv\u003e\u0026nbsp;\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://github.com/mateocallec/SpoofEye/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/mateocallec/SpoofEye?label=lastest%20release\u0026color=blue\" alt=\"Latest release\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://rojo.space/docs\"\u003e\u003cimg src=\"https://img.shields.io/github/license/mateocallec/SpoofEye?label=license\u0026color=white\" alt=\"License\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/mateocallec/SpoofEye/releases\"\u003e\u003cimg src=\"https://img.shields.io/badge/platform-Debian-darkred\" alt=\"Supported platforms\" /\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003chr /\u003e\n\n**SpoofEye** is a security tool designed to protect end systems against common network spoofing attacks such as ARP spoofing, malicious DNS servers, and similar threats. It runs automatically at each user login, continuously monitoring the system for suspicious activity.\n\nWhenever a spoofing attempt is detected, **SpoofEye** immediately logs the event and can send notifications to alert the user.\n\n---\n\n## Version\n\n**SpoofEye v1.0.0**\nAuthor: Mateo Florian Callec\nLicense: GNU General Public License v3\nCopyright (c) 2025\n\nRepository: [https://github.com/mateocallec/SpoofEye.git](https://github.com/mateocallec/SpoofEye.git)\nContact: [mateo@callec.net](mailto:mateo@callec.net)\n\n---\n\n## Features\n\n* Automatic startup at each user login (no manual launch required).\n\n* Detects ARP spoofing and malicious DNS servers.\n\n* Sends real-time notifications when a spoofing attempt is detected.\n\n* Logs all detected events for later analysis.\n\n* Log file is stored at:\n\n  ```\n  ~/.spoofeye/spoofeye.log\n  ```\n\n* Configurable behavior via `.ini` configuration files.\n\n* Supports overriding default configuration paths.\n\n---\n\n## Usage\n\nAlthough **SpoofEye** runs automatically at login, you can also launch it manually or use command-line options for configuration and debugging.\n\n```bash\nspoofeye COMMAND\n```\n\n### Available Commands\n\n| Command          | Aliases              | Description                              |\n| ---------------- | -------------------- | ---------------------------------------- |\n| `--version`      | `-v`                 | Print software version (stops execution) |\n| `--print-config` | `--config`, `config` | Print software configuration             |\n| `--help`         | `-h`, `help`         | Show this help message (stops execution) |\n| `--config-path`  | N/A                  | Override configuration file path         |\n\n### Examples\n\n```bash\nspoofeye --version\nspoofeye --config-path /path/to/config.ini\nspoofeye --help\n```\n\n---\n\n## Repository Structure\n\n| File / Folder        | Description                                                                                                                                           |\n| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `CODE_OF_CONDUCT.md` | Guidelines for contributing respectfully to the project                                                                                               |\n| `CONTRIBUTING.md`    | Instructions for contributing to SpoofEye                                                                                                             |\n| `SECURITY.md`        | Guidelines for reporting security vulnerabilities                                                                                                     |\n| `DISCLAIMER.md`      | Legal disclaimers and usage warnings                                                                                                                  |\n| `LICENSE`            | GNU General Public License v3                                                                                                                         |\n| `CHANGELOG.md`       | List of changes by version                                                                                                                            |\n| `README.md`          | Project overview and instructions                                                                                                                     |\n| `Makefile`           | Build instructions and automation                                                                                                                     |\n| `include/`           | Header files (`.hpp`) and libraries                                                                                                                   |\n| `src/`               | Source code files (`.cpp`)                                                                                                                            |\n| `scripts/`           | Scripts for building, development, and testing                                                                                                        |\n| `resources/`         | Configuration files and other resources                                                                                                               |\n| `tests/`             | Test files for verifying software functionality                                                                                                       |\n| `docs/`              | Additional documentation                                                                                                                              |\n| `debian/`            | Clean build folder containing all Debian packaging files and scripts for SpoofEye. Generated/managed during the build process.                        |\n| `package/`           | Source files for SpoofEye that will be included in the Debian package (binaries, service files, configuration, desktop entry, logrotate, docs, etc.). |\n\n---\n\n## Logs\n\nBy default, all events detected by **SpoofEye** are written to:\n\n```\n~/.spoofeye/spoofeye.log\n```\n\nThis log can be monitored in real time using:\n\n```bash\ntail -f ~/.spoofeye/spoofeye.log\n```\n\n---\n\n## Credits\n\n* [nlohmann/json](https://github.com/nlohmann/json) – JSON library for C++\n* [trickest/resolvers](https://github.com/trickest/resolvers?tab=readme-ov-file) – DNS resolver resources\n\n---\n\n## License\n\nThis program is free software: you can **redistribute** it and/or **modify** it under the terms of the GNU General Public License as published by the Free Software Foundation, either **version 3 of the License, or (at your option) any later version**.\n\nThis program is distributed in the hope that it will be useful, but **WITHOUT ANY WARRANTY**; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. For details, see the [GNU General Public License](LICENSE).\n\nYou should have received a copy of the GNU General Public License along with this program. If not, see [https://www.gnu.org/licenses/](https://www.gnu.org/licenses/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmateocallec%2Fspoofeye","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmateocallec%2Fspoofeye","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmateocallec%2Fspoofeye/lists"}