🚀 Приложение для чтения/записи NFC

Мощное приложение на базе PySide6 для чтения и записи различных типов NFC-меток с расширенными функциями и удобным интерфейсом.

Установка

Необходимые компоненты

• Python 3.9 или новее
• Аппаратный считыватель NFC (ACR122U, ACR1252U и т.д.)

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

1. Клонируйте репозиторий:

   git clone https://github.com/Nsfr750/NFC.git
   cd NFC
   

2. Создайте и активируйте виртуальное окружение:

   python -m venv venv
   .\venv\Scripts\activate  # Windows
   source venv/bin/activate  # Linux/Mac
   

3. Установите зависимости:

   pip install -r requirements.txt
   

4. Запустите приложение:

   python main.py
   

Подробные инструкции по установке см. в файле PREREQUISITES.md.

Возможности

• Поддержка множества меток: Полная поддержка различных типов NFC-меток, включая:
  • NTAG (NTAG213, NTAG215, NTAG216)
  • MIFARE Classic (1K, 4K)
  • MIFARE Ultralight
  • FeliCa (Sony)
  • Карты ISO 14443 Тип A/B

• Поддерживаемые операции: Просмотр поддерживаемых операций для всех типов меток

• Операции с NDEF:
  • Чтение и запись NDEF-записей
  • Создание и управление несколькими NDEF-записями
  • Поддержка различных типов NDEF-записей (текст, URI, смарт-постер и т.д.)
  • Шестнадцатеричное представление для просмотра необработанных данных
• Управление метками:
  • Чтение информации о метке (UID, структура памяти, возможности)
  • Запись данных на метки с проверкой
  • Блокировка меток для предотвращения несанкционированной записи
  • Форматирование меток для использования с NDEF
• Пользовательский интерфейс:
  • Современный адаптивный дизайн с темой sphinx_rtd_theme
  • Поддержка светлой/тёмной/системной темы
  • Обнаружение меток в реальном времени и обновление статуса
  • Подробная панель информации о метке
  • Просмотрщик логов с возможностью фильтрации
  • Полная документация на английском и итальянском языках
• Функции безопасности:
  • 🔒 Защита паролем для конфиденциальных операций
  • 🔑 Безопасное хеширование паролей с PBKDF2
  • 🔄 Функция смены пароля
  • ⚙️ Переключатель для включения/отключения защиты паролем
  • 🔐 Защищенные операции включают Инструменты меток, Базу данных и Клонирование
• Расширенные функции:
  • Режим эмуляции метки (экспериментальный)
  • Пакетные операции для обработки нескольких меток
  • Выполнение пользовательских команд
  • Система логирования с несколькими уровнями детализации
  • Документация по API для разработчиков
  • Руководство по устранению неполадок
  • Рекомендации по внесению вклада в открытый исходный код

🚀 Требования

• Python 3.8 или новее
• Поддерживаемое оборудование для чтения/записи NFC:
  • ACR122U
  • PN532 (через USB/UART)
  • Совместимые с PC/SC считыватели
• Windows 10/11 или Linux с поддержкой PC/SC
• Необходимые пакеты Python (см. requirements.txt)

📖 Документация

Полная документация доступна на английском и итальянском языках, включая:

• Руководство пользователя
• Справочник по API
• Руководство по устранению неполадок
• FAQ
• Рекомендации по внесению вклада

Для сборки документации локально:

# Установка зависимостей для документации
pip install -r requirements-docs.txt

# Сборка документации на английском
cd docs/ENG
make html

# Сборка документации на итальянском
cd ../ITA
make html

Документация будет доступна в каталоге _build/html для каждой языковой папки.

📦 Установка

1. Клонируйте репозиторий:

   git clone https://github.com/Nsfr750/NFC.git
   cd NFC
   

2. Создайте и активируйте виртуальное окружение (рекомендуется):

   # Windows
   python -m venv venv
   .\venv\Scripts\activate
   
   # Linux/macOS
   python3 -m venv venv
   source venv/bin/activate
   

3. Установите необходимые пакеты:

   pip install -r requirements.txt
   

4. (Опционально) Установите драйверы PC/SC, если они еще не установлены:
   • Windows: Установите драйверы CCID
   • Linux: Установите пакеты pcscd и libpcsclite-dev

5. Запустите приложение:

   python main.py
   

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

Основные операции

1. Подключите считыватель NFC
   • Приложение автоматически обнаружит поддерживаемые устройства
   • Статус подключения отображается в строке состояния
2. Прочтите метку
   • Поднесите NFC-метку к считывателю
   • Информация о метке отобразится в главном окне
   • Просмотрите детальную структуру памяти в шестнадцатеричном редакторе
3. Запись на метку
   • Перейдите на вкладку “Запись”
   • Выберите тип записи (текст, URI и т.д.)
   • Введите содержимое и нажмите “Записать на метку”
4. Заблокируйте метку
   • Используйте кнопку “Заблокировать” для предотвращения дальнейшей записи
   • Некоторые метки поддерживают постоянную блокировку (будьте осторожны!)

🛠️ Расширенные функции

• Эмуляция метки: Эмуляция NFC-метки (экспериментальная функция)
• Пакетная обработка: Обработка нескольких меток за один сеанс
• Пользовательские команды: Выполнение низкоуровневых команд
• Подробное логирование: Настройка уровня детализации логов

🔒 Безопасность

Приложение включает несколько уровней безопасности:

1. Защита паролем для конфиденциальных операций
2. Безопасное хранение хешей паролей
3. Проверка целостности данных перед записью
4. Предупреждения о потенциально опасных операциях

🤝 Вклад в проект

Мы приветствуем вклады в проект! Пожалуйста, ознакомьтесь с нашими рекомендациями по внесению вклада для получения дополнительной информации о том, как сообщать об ошибках, предлагать улучшения или отправлять исправления.

📄 Лицензия

Этот проект распространяется под лицензией GPL-3.0. Подробности смотрите в файле LICENSE.

🙏 Благодарности

• Разработчикам библиотеки nfcpy за отличную работу
• Сообществу за ценные отзывы и предложения
• Всем, кто внёс вклад в развитие проекта

📞 Контакты

По вопросам и предложениям обращайтесь:

• Электронная почта: nsfr750@yandex.com
• GitHub: https://github.com/Nsfr750

© 2023 Nsfr750. Все права защищены.