APK VirusTotal Scanner

Overview

The APK VirusTotal Scanner is a Python-based tool designed for the automated scanning of APK files using the VirusTotal API. This project facilitates the bulk scanning of APKs, providing a streamlined process for analyzing potential security threats in APK files.

Key Features

• Automated APK Scanning: Automatically scans APK files in a specified folder using the VirusTotal API.
• Multiple API Support: Can be used with multiple API keys from VirusTotal for load balancing and rate limit management.
• Integration with Mihon Extension APKs: Specifically designed to download and scan APKs from the Mihon Extension repository.
• Result Storage: Scanning results are stored in a JSON file for easy access and analysis.

How It Works

1. APK Retrieval: The git-downloader.py script clones or updates the Mihon Extension repository and transfers new APKs to the local apk folder.
2. Scanning Process: The vt-apk-scanner.py script scans each APK file using the VirusTotal API and records the results.
3. Results Handling: The scanning results are saved in virus_total_results.json, providing details such as scan date, detected threats, and file attributes.

WebPage

• keiyoushi Extension Results: A dedicated webpage is available to display scan results from keiyoushi-extensions, accessible here.

Setup and Usage

• Ensure you have Python installed on your system.

• Clone this repository and navigate to the project directory.

• Install necessary Python packages listed in requirements.txt.

• Add your VirusTotal API keys to the vt-apk-scanner.py script.

• Run starter.bat or starter.sh to initiate the downloading and scanning process.

• The vt-apk-scanner.py script first looks if the file was already scanned, if yes then it retrieves the results, if no then it uploads the file. After the script is completed, then run it again to retrieve the results that it uploaded before.

License

This project is licensed under the MIT License - see the LICENSE file for details.