FAQ - arlotalkington/Virus-Be-Gone GitHub Wiki

Virus Be Gone Wiki: FAQ (Frequently Asked Questions)

🔧 General

Q: What is Virus Be Gone?

A: It's a lightweight, command-line antivirus scanner built in Python. It supports full, quick, and custom scans, with signature-based detection, quarantine, and real-time monitoring.

Q: What platforms does it run on?

A: Currently Windows only, but a cross-platform version is planned.

Q: Is it open source?

A: Yep! You can check out the full code and contribute on GitHub.


🛡️ Scanning

Q: What types of scans are available?

A:

  • full — scans all files on your system
  • quick — scans system folders and common infection points
  • custom — scan a specific folder you choose

Q: How are threats detected?

A: It uses signature-based scanning. If a file’s hash or content matches a known virus signature, it gets flagged and quarantined.


📁 Quarantine

Q: What happens to infected files?

A: They’re moved to a safe quarantine/ folder where they can’t run or harm your system.

Q: Can I restore a file if it was wrongly flagged?

A: Yes! Use restore <file_id> to return it to its original location.


🧪 Signatures

Q: How are virus signatures stored?

A: In json files under the signatures/ folder. Each line represents one signature in the format:

  {
    "hash": "395d094ab3c1bd35e6e697c883428f8b23efe8bf4669a359ff252fdefb4b0ae6"
  }

Q: Can I make my own signatures?

A: Absolutely. You can add new signature lines or files to the signatures/ folder.


⚙️ Features

Q: Does it support real-time scanning?

A: Yes, it can watch your file system and react to changes using the watchdog module.

Q: Is there sound/alert support?

A: No. It does not play an alert sound when threats are found.


🧼 Safety

Q: Does it ever delete files automatically?

A: No. It always quarantines first so you can review before taking final action.

Q: Is it safe to run on my main system?

A: It’s designed to be non-destructive. Still, always back up important files and run scans responsibly.


🧰 Troubleshooting

Q: Quarantine folder is missing?

A: It will be auto-created during a scan or on first detection. If not, manually create a quarantine/ folder next to your script.

Q: Signature not matching anything?

A: Make sure the signature file is correctly formatted and saved in the signatures/ folder.


🤖 Future Features (Coming Soon)

  • Heuristic + fuzzy scanning
  • Cross-platform support
  • Signature updater
  • Community threat reporting

🙋‍♂️ Still have questions?

Feel free to open an issue on GitHub or reach out in the discussion board!

⚠️ **GitHub.com Fallback** ⚠️