Xbox Code Checker GUI

🎮 Современное Python GUI приложение для пакетной проверки валидности Xbox/Microsoft кодов

Полностью переписанная версия оригинального Xbox Code Checker с современным интерфейсом на Python и улучшенной функциональностью.

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

• 🎨 Современный GUI - Интерфейс на CustomTkinter с поддержкой темной/светлой тем
• ⚡ Пакетная обработка - Проверка множества кодов одновременно с отслеживанием прогресса
• 🔄 Многопоточность - Настраиваемое количество потоков для оптимальной производительности
• ⏯️ Полный контроль - Функции паузы, продолжения и остановки процесса
• 📊 Экспорт результатов - Сохранение в форматах TXT, CSV и JSON
• 🔧 Гибкие настройки - Настройка задержек, количества потоков и других параметров
• 🔍 Детальный просмотр - Просмотр результатов с фильтрацией и поиском
• 📦 Standalone сборка - Компиляция в исполняемый файл без зависимостей
• 🔄 Автоформатирование - Поддержка кодов с дефисами и без них
• 🛡️ Система повторов - Экспоненциальная задержка при неудачных запросах
• 📝 Логирование - Детальное отслеживание ошибок и событий

🚀 Быстрый старт

Установка из исходного кода

# Клонируйте репозиторий
git clone https://github.com/slonce70/Xbox-Code-Checker.git
cd Xbox-Code-Checker

# Установите зависимости
pip install -r requirements.txt

# Запустите приложение
python main.py

Сборка исполняемого файла

# Установите PyInstaller
pip install pyinstaller

# Соберите приложение
python build.py

Готовый исполняемый файл XboxCodeChecker.exe будет создан в папке dist/.

📖 Использование

Пошаговая инструкция

1. Запуск - Откройте приложение python main.py или запустите исполняемый файл
2. WLID токены - Загрузите файл с WLID токенами через кнопку "Загрузить WLID"
3. Коды для проверки - Загрузите файл с Xbox кодами через кнопку "Загрузить коды"
4. Настройки - При необходимости настройте параметры (задержка, количество потоков)
5. Запуск проверки - Нажмите "Начать проверку"
6. Мониторинг - Отслеживайте прогресс в реальном времени
7. Экспорт - Сохраните результаты в нужном формате

Форматы файлов

Файл WLID

Каждая строка должна содержать WLID токен:

WLID1.0="ваш_wlid_токен_здесь"

Файл кодов

Каждая строка должна содержать Xbox код в одном из форматов:

# С дефисами (стандартный формат)
XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

# Без дефисов (будет автоматически отформатирован)
XXXXXXXXXXXXXXXXXXXXXXXXX

Примеры поддерживаемых форматов:

• QHR66-3JVTV-WGTVX-JXW4Q-R767Z (с дефисами)
• QHR663JVTVWGTVXJXW4QR767Z (без дефисов - автоматически преобразуется)

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

Xbox-Code-Checker/
├── src/                     # Исходный код
│   ├── core/               # Основная логика
│   │   ├── code_checker.py    # Проверка кодов
│   │   ├── progress_manager.py # Управление прогрессом
│   │   └── retry_manager.py   # Система повторных попыток
│   ├── data/               # Модели данных и API
│   │   ├── api_client.py      # Microsoft API клиент
│   │   ├── file_manager.py    # Работа с файлами
│   │   └── models.py          # Модели данных
│   ├── gui/                # GUI компоненты
│   │   ├── components/        # UI компоненты
│   │   ├── main_window.py     # Главное окно
│   │   ├── results_viewer.py  # Просмотр результатов
│   │   └── settings_dialog.py # Настройки
│   └── app.py              # Главный класс приложения

├── input/                  # Входные файлы
├── output/                 # Выходные файлы
├── tests/                  # Тесты
├── main.py                 # Точка входа
├── build.py               # Скрипт сборки
├── config.json            # Конфигурация
└── requirements.txt       # Зависимости

🔧 Системные требования

Компонент	Версия
Python	3.9+
CustomTkinter	5.2.0+
Requests	2.31.0+
Pillow	10.0.0+
Packaging	23.0+

🧪 Тестирование

# Запуск всех тестов
python -m pytest tests/

# Запуск с подробным выводом
python -m pytest tests/ -v

# Запуск конкретного теста
python -m pytest tests/test_code_checker.py

📊 Логирование

Приложение автоматически создает файл app.log для отслеживания:

• Ошибок API запросов
• Статистики обработки
• Системных событий
• Отладочной информации

📄 Лицензия

Этот проект предназначен исключительно для образовательных целей.