MalFinder™ is a bot that can automatically scan the given links and files for malware using VirusTotal, making it easy and simple.

## Getting Started

• Scan all files and links with VirusTotal
• logs everything into whatever
• lorem ipsum

This bot uses VirusTotal's API to scan your links or files automatically inside Discord. You heard it right! No longer do you need to leave Discord. Just send a link or file anywhere the bot can read messages and it'll start getting the scanned results to you as soon as it can. The bot will log all its scanned files, links, and errors into a file named log.txt and will print them out as well.

we need to change the logging text above to our new system

You will need to host the bot as we do not provide hosting as of now. We recommend using a Linux self-hosted or cloud server. Microsoft Azure is a good way to start with 12 free months of hosting services.

Make sure you have Python >= 3.7.x installed before running this code. Copy and paste the code below in any bash-supported terminal environment. If you do not know what that is then just open your preferred terminal of choice.

git clone https://github.com/MilitaryLotus30/MalFinderTM.git
cd MalFinderTM
pip install -r requirements.txt

Then, do the following:

1. Rename "config.json.txt" to "config.json" (on Windows, make sure to have file extensions shown!) How to show file extensions on Windows 10 and 11
2. Open "config.json" and input your values.

How to get your VirusTotal API key

How to get your Discord bot Application Token/Create a bot and invite to your server. Make sure to give it administrator permissions so that it can monitor any channel

Then, you can start the bot via

python main.py

Simply send a link or file in any of the channels that the bot has access to and it will scan the files or website for malware and provide the scan results with the VirusTotal link of the scan.

If you're worried about downloading a file or clicking on a link, this bot can help you!

(placeholder of image of the bot in action)

This project is licensed under the Code Credit License - see the LICENSE.md file for details.

In short, this license allows you to do whatever you want with the code, as long as credit is given.

• This bot was created for a hackathon event held on the NTTS's Discord server.
• A team of 4 people helped on this project.
• Wish us luck!

<3