pandora-box/README.md

Pandora-box
============

## Introduction

As the use of USB disks are still prevalent, so has the risk of malware infection through these devices.
Malware can easily spread from one computer to another through USB disks, making it a critical threat to
information security. This is where our USB scanning device comes in.

Pandora-box is designed to detect and remove malware from USB disks. The software is based on [Pandora](https://github.com/pandora-analysis)
from [CIRCL](https://www.circl.lu) and is distributed under [GPL](https://www.gnu.org/licenses/licenses.html),
making it freely accessible to security professionals.

The software uses advanced scanning techniques to identify and remove malware from USB disks. It performs a
comprehensive scan of the disk, analyzing each file for any signs of malicious activity. If it detects any malware,
Pandora-box will quarantine the infected files and remove them from the disk.

## Featues

Pandora-Box is a USB scaning station based on [Pandora](https://github.com/pandora-analysis),
a malware analysis tool.

Pandora-box uses :

- [ClamAV](http://www.clamav.net/) : an open-source antivirus engine for detecting trojans, viruses, malware & other malicious threats.
- [Comodo Antivirus](https://antivirus.comodo.com/) : the free version of Comodo Antivirus.
- [Hashlookup](https://circl.lu/services/hashlookup/) : a public API to lookup hash values against known database of files.
- [Yara Rules](https://github.com/Neo23x0/signature-base) : the YARA signature and IOC database used by [LOKI](https://github.com/Neo23x0/Loki) and [THOR Lite](https://www.nextron-systems.com/thor-lite/) scanners.

Other tools may be used by configuring Pandora [antivirus-workers](https://github.com/pandora-analysis/pandora#antivirus-workers).

It runs on [Ubuntu 24.04 server LTS](https://releases.ubuntu.com/noble/).

## Interface

It has a graphical user interface :

[<img src="images/key1.png" width="400">](images/key1.png)
[<img src="images/wait1.png" width="400">](images/wait1.png)
[<img src="images/ok.png" width="400">](images/ok.png)
[<img src="images/bad.png" width="400">](images/bad.png)

and a text user interface for advanced users :

[<img src="images/pandora-curses.png" width="400">](images/pandora-curses.png)

## Roadmap

If you want to contribute, we have a [roadmap](ROADMAP.md).

## Installation

The [installation and configuration procedure](INSTALL.md) is documented.

## License

Pandora-box is an open source software distributed under [GPL](https://www.gnu.org/licenses/licenses.html).