vt-gui

KO | EN

gitlite — search

#tensorflow #claude-code #chatbot #nextjs #ai-agents #data-science #claude #pytorch #swift #agents

(★ 9)

⚡ GUI оболочка для VT CLI 🦠

파일 탐색기

ZIP 다운로드

- - build.yml
- - __init__.py
  - strings.json
- - donate.svg
  - dzen.svg
  - github.svg
  - icon.ico
  - info.svg
  - sber.svg
  - telegram.svg
  - vk.svg
  - youtube.svg
- main.py
- requirements.txt
- version.txt
- VirusTotal_File_Scanner_macOS.spec
.gitignore
LICENSE
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**VT GUI** — это современное кроссплатформенное графическое приложение (GUI) для сервиса **VirusTotal**, написанное на Python с использованием фреймворка **Flet** (на базе Flutter).

Приложение представляет собой удобную графическую оболочку над официальной утилитой командной строки VirusTotal (`vt-cli`), интегрируя её с прямыми HTTP-запросами к VirusTotal API v3 для максимального быстродействия и удобства работы.

![maxresdefault](https://i.ibb.co/n8wFwXjW/flet-Sg2ttwd-Mo-X.png)

# 🎦 Видео гайд по установке и использованию программы

![maxresdefault](https://i.ibb.co/39YVYSWV/1.png)

[**Смотреть на YouTube**](https://www.youtube.com/watch?v=KNdZoy6Ixxo)

[**Смотреть на Dzen**](https://dzen.ru/video/watch/6a5b77343ceaa4017d1d50f6)

[**Смотреть на Rutube**](https://rutube.ru/video/private/c402084c77dabec7cbf4e2152c7187ec/?p=ODGgUgedy78Lfdc2b74mew)

[**Смотреть в VK Video**](https://vkvideo.ru/video-234234162_456239099)

[**Смотреть в Telegram**](https://t.me/avencoreschat/558446)

</div>

---

## ✨ Основные возможности

### 🔎 Проверка файлов (File Scanner)
* **Быстрое сканирование хэша:** Вычисляет хэш SHA-256 локального файла и мгновенно проверяет его через API. Если файл уже проверялся ранее на VirusTotal, отчет загружается без необходимости повторной отправки файла.
* **Загрузка и отправка файлов:** Если файла нет в базе VirusTotal, приложение отправляет его с использованием официального CLI и запускает отслеживание анализа в реальном времени.
* **Мультивыбор и сканирование папок:** Поддержка одновременного сканирования нескольких файлов или всей директории с распределением результатов по отдельным вкладкам.
* **Drag-and-Drop & Буфер обмена:** Файлы можно перетаскивать прямо в окно приложения или нажать `Ctrl + V` для вставки путей из буфера обмена.
* **Контекстное меню ОС:** Поддержка запуска с аргументами командной строки для интеграции в системное контекстное меню «Отправить в VT GUI».
* **Повторный анализ:** Возможность отправить файл на повторную перепроверку в VirusTotal.
* **Голосование (Лайк / Дизлайк):** Просмотр и отправка голосов за безопасность файла (Harmless / Malicious) с кэшированием статуса в реальном времени.
* **Экспорт отчетов:** Сохранение подробного отчета анализа в JSON через системное диалоговое окно или в папку «Загрузки».

### 🌐 Threat Intelligence (Аналитика угроз)
* **Анализ URL:** Проверка интернет-ссылок на вредоносность и отправка неизвестных URL на сканирование.
* **Анализ доменов:** Информация о репутации домена, регистраторе, дате создания, связанных субдоменах и DNS-разрешениях.
* **Анализ IP-адресов:** Проверка репутации IP, владельца AS и страны регистрации.
* **Полнотекстовый поиск:** Поиск файлов, хэшей и отчетов по базе VirusTotal с возможностью скачивания образцов (при наличии Premium API ключа).
* **Экспорт и переанализ:** Быстрый запрос повторного анализа и экспорт результатов в JSON.

### 🛠️ Инструменты VirusTotal (VT Tools)
* **Сравнение файлов (`vt diff`):** Наглядное сравнение двух хэшей SHA-256 с выводом структурных и поведенческих различий между ними.
* **YARA-правила (Livehunt):** Просмотр и проверка списка активных наборов правил YARA для мониторинга угроз.

### 📜 История сканирований
* **Автоматическое сохранение:** Все сканирования файлов и проверки URL/доменов/IP автоматически сохраняются в локальную историю (`history.json`).
* **Поиск и фильтрация:** Быстрый поиск по историческим записям.
* **Повторный анализ и веб-отчет:** Переход к сохраненным результатам, повторное сканирование в один клик и открытие отчета на сайте VirusTotal.
* **Управление записями:** Удаление отдельных записей или полная очистка истории.

### 🎨 Темы оформления и Анимации
* **Тёмная и Светлая темы:** Полноценная поддержка тёмной (Dark Neon) и светлой (Light Clean) тем оформления для всех экранов, карточек, графиков и диалогов.
* **Быстрое переключение:** Кнопка смены темы прямо в шапке приложения рядом с настройками и селектор темы в окне настроек.
* **Сохранение настроек:** Выбранная тема сохраняется в `.env` и автоматически применяется при следующем запуске.
* **Плавная анимация:** Анимированная кнопка с вращением иконки солнца/луны на 180° с эффектом сжатия, и бесшовный плавный переход градиентов фона и элементов окна без мерцаний.

### 🔐 Безопасность и автоматизация CLI
* **Автоматическая установка:** Определение ОС (Windows, Linux, macOS) и архитектуры (x64, ARM64, x86, ARM) с автоматической загрузкой официального `vt-cli` с GitHub.
* **Контроль хэш-сумм:** Сравнение скачанных бинарных файлов и ZIP-архивов с официальным списком SHA-256 хэшей релиза.
* **Пользовательский CLI:** Возможность указать собственный бинарный файл `vt`/`vt.exe` с сохранением его хэша после подтверждения.
* **Переустановка CLI:** Кнопка быстрого обновления/переустановки CLI прямо из настроек.
* **Валидация API-ключа:** Проверка работоспособности ключа при вводе и синхронизация с `~/.vt.toml` и `.env`.

### 🌍 Локализация
* **12 языков:** Английский, русский, испанский, немецкий, французский, португальский, турецкий, украинский, китайский, японский, корейский и арабский языки с автоматическим определением языка системы.
* **Проверка обновлений:** Встроенный инструмент проверки новых версий приложения через GitHub Releases.

---

## 📂 Структура проекта

* [source/main.py](source/main.py) — Главный файл приложения, точка входа, конфигурация окна Flet, обработка аргументов командной строки, управление темами и маршрутизация экранов.
* **`source/app/`** — Модульная архитектура приложения:
  * [source/app/strings.json](source/app/strings.json) — Файл локализации со всеми текстовыми строками интерфейса (12 языков, включая переводы для тем).
  * **`core/`** — Системное ядро и конфигурация:
    * [source/app/core/constants.py](source/app/core/constants.py) — Платформенные константы, хэши официальных релизов `vt-cli`, настройки языков.
    * [source/app/core/config.py](source/app/core/config.py) — Синхронизация окружения (`.env` и `~/.vt.toml`), сохранение тем (`THEME_MODE`), автоопределение языка, загрузка `strings.json`.
    * [source/app/core/bundle_runtime.py](source/app/core/bundle_runtime.py) — Подготовка и автономная упаковка рантайма Flet Desktop для PyInstaller.
  * **`api/`** — Сетевой слой и интеграция с VirusTotal:
    * [source/app/api/vt_api.py](source/app/api/vt_api.py) — Клиент VirusTotal v3 REST API (хэши, файлы, URL, домены, IP, поиск, субдомены, DNS, комментарии, голосование, квоты).
    * [source/app/api/cli_manager.py](source/app/api/cli_manager.py) — Менеджер утилиты `vt` (скачивание с GitHub Releases, проверка SHA-256, распаковка и поиск бинарника).
  * **`services/`** — Сервисный слой бизнес-логики:
    * [source/app/services/scan_service.py](source/app/services/scan_service.py) — Пайплайн сканирования файлов (хэширование -> VT API -> отправка через CLI -> отслеживание).
    * [source/app/services/history_service.py](source/app/services/history_service.py) — Менеджер локальной истории сканирований и поисков (`scan_history.json`).
    * [source/app/services/export_service.py](source/app/services/export_service.py) — Экспорт и импорт отчетов анализа в формате JSON.
  * **`utils/`** — Утилиты общего назначения:
    * [source/app/utils/clipboard.py](source/app/utils/clipboard.py) — Безопасная работа с буфером обмена (с поддержкой Win32 API fallback).
    * [source/app/utils/hashing.py](source/app/utils/hashing.py) — Потоковое вычисление хэш-суммы SHA-256 локальных файлов.
  * **`ui/`** — Графический интерфейс на Flet:
    * **`components/`** — Переиспользуемые визуальные компоненты:
      * [source/app/ui/components/theme.py](source/app/ui/components/theme.py) — Дизайн-система и цветовые токены палитр (`dark` и `light`), карточки статистики, строки антивирусов.
      * [source/app/ui/components/header.py](source/app/ui/components/header.py) — Верхняя панель (логотип, выбор языка, анимированная кнопка темы, настройки).
      * [source/app/ui/components/footer.py](source/app/ui/components/footer.py) — Нижняя панель (версия, ссылки, диалоги «О программе», «Донат», «Обновления»).
    * **`dialogs/`** — Модальные окна:
      * [source/app/ui/dialogs/api_key_dialog.py](source/app/ui/dialogs/api_key_dialog.py) — Диалог ввода API-ключа при первом запуске с поддержкой светлой/тёмной тем.
      * [source/app/ui/dialogs/settings_dialog.py](source/app/ui/dialogs/settings_dialog.py) — Окно настроек (API-ключ, выбор темы оформления, квоты, переустановка CLI).
    * **`views/`** — Экраны и вкладки приложения:
      * [source/app/ui/views/install_view.py](source/app/ui/views/install_view.py) — Мастер установки `vt-cli` (автоматическая загрузка или ручной выбор).
      * [source/app/ui/views/scanner_view.py](source/app/ui/views/scanner_view.py) — Стартовый экран выбора файлов/папок и Drag-and-Drop.
      * [source/app/ui/views/scanning_view.py](source/app/ui/views/scanning_view.py) — Экран прогресса сканирования.
      * [source/app/ui/views/results_view.py](source/app/ui/views/results_view.py) — Панель результатов с вердиктами, поведением песочниц, комментариями и голосованием.
      * [source/app/ui/views/history_view.py](source/app/ui/views/history_view.py) — История проверок с фильтрацией, повторным анализом и удалением.
      * [source/app/ui/views/intelligence_view.py](source/app/ui/views/intelligence_view.py) — Аналитика угроз (URL, домены, IP-адреса, поиск по базе VT, DNS-резолвинг).
      * [source/app/ui/views/tools_view.py](source/app/ui/views/tools_view.py) — Инструменты: сравнение файлов (`vt diff`) и наборы правил YARA (`Livehunt`).

---

## 🚀 Установка и запуск из исходников

Для работы проекта требуется установленный **Python 3.8+**.

1. Клонируйте репозиторий:
   ```bash
   git clone https://github.com/AvenCores/vt-gui.git
   cd vt-gui
   ```

2. Установите зависимости:
   ```bash
   pip install -r source/requirements.txt
   ```

3. Запустите приложение:
   ```bash
   python source/main.py
   ```
   *Или с помощью CLI утилиты Flet:*
   ```bash
   flet run source/main.py
   ```

При первом запуске приложение попросит ввести ваш персональный API-ключ VirusTotal (его можно бесплатно получить на официальном сайте). Ключ сохранится локально и будет использоваться для всех последующих сессий.

---

## 📦 Сборка в исполняемый файл

Проект собирается в один независимый исполняемый файл с помощью **PyInstaller**. В репозитории настроен процесс автоматической компиляции для GitHub Actions ([.github/workflows/build.yml](.github/workflows/build.yml)), поддерживающий сборки для Windows (x64/ARM64), Linux (x64/ARM64) и macOS (ARM64).

Если вы хотите собрать приложение локально, выполните следующие шаги из папки `source`:

### Windows (x64 / ARM64)
```bash
cd source
pyinstaller --onefile --noconsole --icon=assets/icon.ico --add-data="assets;assets" --add-data="app/strings.json;app" --name="VirusTotal_File_Scanner_Windows_x64" --noupx --clean --version-file=version.txt main.py
```

### Linux (x64 / ARM64)
```bash
cd source
pyinstaller --onefile --icon=assets/icon.ico --add-data="assets:assets" --add-data="app/strings.json:app" --name="VirusTotal_File_Scanner_Linux_x64" --clean main.py
```

### macOS (ARM64)
Используется специальный spec-файл для исключения конфликтов nested-библиотек Flet:
```bash
cd source
pyinstaller --clean VirusTotal_File_Scanner_macOS.spec
```

---

## 📜 Лицензия

Проект распространяется под лицензией GPL-3.0. Полный текст лицензии содержится в файле [`LICENSE`](LICENSE).

---

## 💰 Поддержать автора
* **SBER**: `2202 2050 1464 4675`

vt-gui

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

vt-gui

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README