Veto

Ein quelloffener VirusTotal-Client für Android

Kostenlos und quelloffen. Nutze deinen eigenen VirusTotal-API-Schlüssel, um Dateien, Links und installierte Apps mit über 70 Scan-Engines zu überprüfen – mit einer Material-3-Oberfläche. Keine Konten, kein Tracking, keine Werbung.

Was ist Veto?

Veto ist ein Android-Client für VirusTotal. Reiche eine Datei, einen Link oder eine installierte App ein, um Echtzeit-Analyseergebnisse anzuzeigen. Die Anwendung zeigt einen übersichtlichen Bericht – von einem einzigen zusammenfassenden Urteil bis hin zur vollständigen Menge aller vom Dienst zurückgegebenen Felder.

Das Projekt ist kostenlos und quelloffen, enthält keine Benutzerkonten, Tracking-Systeme oder Werbung. Da die Benutzer ihren eigenen VirusTotal-API-Schlüssel bereitstellen, werden alle Scans direkt unter ihrem persönlichen Konto ausgeführt, ohne über zwischengeschaltete Drittanbieter-Server geleitet zu werden.

Screenshots

Funktionsumfang

• Scan-Fähigkeit: Scanne installierte Apps, lokale Dateien oder Ziel-URLs.
• Multi-Engine-Aggregation: Kombiniert Diagnosen von über 70 Antiviren-Engines.
• Zwei Berichtsmodi: Schnellmodus für kurze Überprüfungszusammenfassungen und Detailmodus für eine tiefgehende Analyse.
• Kontextbezogene Erklärungen: Zu jedem Abschnitt sind Erklärungstexte verfügbar; diese können in den Einstellungen ausgeblendet werden.
• Detailgetreue Berichte: Zeigt Datei-Hashes, Bedrohungsklassifizierungen, Verlauf, Community-Bewertungen, Sandbox-Verhalten, YARA-Treffer, Android-App-Interna und alle weiteren API-Payload-Felder an.
• Hintergrundausführung: Echtzeit-Upload- und Analyse-Fortschrittsverfolgung, die in einem Hintergrunddienst aktiv bleibt.
• Offline-Zugriff: Speichert Berichte lokal, sodass sie später auch ohne Internetverbindung eingesehen werden können.
• Rate-Limit-Warnungen: Klare Benachrichtigungen, wenn der lokale API-Schlüssel sein Rate-Limit erreicht hat.
• Design: Volle Material-3-Unterstützung mit dynamischen Systemfarben, sowohl für helles als auch für dunkles Design.

Details zur Kernarchitektur-Implementierung

• Zustandssynchronisation: Der anwendungsweit gültige ScanManager dient als zentrale Quelle der Wahrheit für alle Scan-Zustände. Dadurch bleibt die Benutzeroberfläche synchron – unabhängig davon, ob die App im Vordergrund aktiv, im Hintergrund pausiert oder vom Betriebssystem beendet wurde.
• Widerstandsfähiges Polling: Die App fragt den Endpunkt /analyses/{id} mit einer Zeitschranke von sechs Minuten ab. Bei einer Rate-Limit-Antwort wird abgewartet, anstatt den Vorgang abzubrechen. Der Bericht wird erneut abgerufen, bis die Ergebnisse vorliegen; bei Überschreitung des Zeitlimits wird ein strukturierter Fehlerzustand zurückgegeben.
• Prozesslebenszyklus: Während der ScanState im ScanManager verbleibt, um die Zerstörung der Activity zu überleben, erhält der ScanService den Prozesslebenszyklus während aktiver Vorgänge aufrecht und verwaltet laufende sowie abschließende Benachrichtigungen.
• Originaltreue Analyse: Allgemeine Felder werden mit typisierten Modellen erfasst, während das vollständige rohe attributes-JSON durch einen benutzerdefinierten Serialisierer erhalten bleibt. So können in der Detailansicht alle zurückgegebenen Felder angezeigt werden – einschließlich neu hinzugekommener Felder der API.

Technologie-Stack

Projektstruktur

└── app/src/main/java/com/quantum_prof/vtscansuite/
    ├── data/          # Modelle, Remote-API und Repository-Implementierung
    ├── domain/        # Repository-Schnittstelle und geschäftliche Anwendungsfälle
    ├── di/            # Hilt-Abhängigkeitsinjektionsmodule
    ├── scan/          # ScanManager, ScanService und Systembenachrichtigungen
    └── ui/            # UI-Komponenten und Präsentationsschichten
        ├── intro/     # Begrüßungsbildschirm und API-Schlüssel-Konfiguration
        ├── dashboard/ # Navigationszentrale: Link-, Datei- und App-Scan-Module
        ├── results/   # Schnell- und Detailbericht-Viewer
        ├── components# Wiederverwendbare UI-Elemente und Layouts
        ├── theme/     # Farb-, Form-, Typografie- und Bewegungskonfigurationen
        └── util/      # Haptisches Feedback, Gesten und Deep-Linking-Hilfsprogramme

• Store-Listing-Assets und Textressourcen sind verfügbar unter fastlane/metadata/android/en-US/.
• Bearbeitbare Mockup-SVGs befinden sich in docs/store/svg/.
• Mockups können mit docs/store/export.html in das PNG-Format exportiert werden.

Erste Schritte

Voraussetzungen

• Android Studio (aktuelle stabile Version)
• JDK 17
• Ein kostenloser VirusTotal-API-Schlüssel, erhältlich unter: https://www.virustotal.com/gui/my-apikey

Erstellen und Ausführen

Klonen Sie das Repository und kompilieren Sie den Debug-Build über die Kommandozeile:

git clone https://github.com/ProfessorQuantumUniverse/VTScan.git
cd VTScan
./gradlew :app:assembleDebug

Alternativ öffnen Sie das Stammverzeichnis in Android Studio und wählen die Run-Konfiguration aus.

Geben Sie beim ersten Start Ihren VirusTotal-API-Schlüssel im Einrichtungsbildschirm ein. Der Schlüssel wird lokal auf Ihrem Gerät gespeichert. Kostenlose API-Schlüssel sind in der Regel auf vier Lookups pro Minute beschränkt.

Datenschutzbestimmungen

Die Anwendung kommuniziert ausschließlich mit der VirusTotal-API unter Verwendung der von Ihnen bereitgestellten Anmeldeinformationen. Hochgeladene Dateien, übermittelte URLs und dynamische Ergebnisse werden direkt an die Server von VirusTotal gesendet. Der API-Schlüssel wird lokal auf Ihrem Gerät gespeichert. Veto erhebt keine Analysedaten und enthält keine Werbe-SDKs.

Lizenz

Dieses Projekt ist unter den Bedingungen der GNU General Public License v3.0 lizenziert.

Hauptbestimmungen der GPLv3:

• Kommerzielle Nutzung: Erlaubt
• Modifikation: Erlaubt
• Verbreitung: Erlaubt
• Offenlegung des Quellcodes: Bei Verbreitung erforderlich
• Gleiche Lizenz: Modifizierter Code muss ebenfalls unter GPLv3 lizenziert werden
• Haftung & Gewährleistung: Keine, durch die Autoren

Weitere Details entnehmen Sie bitte der Datei LICENSE in diesem Repository.