🚀 NFCリーダー/ライターアプリケーション

ライセンス: GPL v3 Python 3.9+ コードスタイル: black

PySide6ベースの強力なNFCタグリーダー/ライターアプリケーションで、高度な機能とユーザーフレンドリーなインターフェースを備えています。

インストール

前提条件

クイックスタート

  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を参照してください。

特徴

🚀 要件

📖 ドキュメント

英語とイタリア語で包括的なドキュメントが利用可能です:

ドキュメントをローカルでビルドするには:

# ドキュメントの要件をインストール
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ドライバーがインストールされていない場合はインストール:
  5. アプリケーションを実行:

    python main.py
    

🚀 使い方

基本操作

  1. NFCリーダーを接続
  2. タグを読み取る
  3. タグに書き込む
  4. タグをロックする

🛠️ 高度な機能

🤝 貢献

貢献は大歓迎です!バグレポート、機能リクエスト、プルリクエストは歓迎します。

  1. リポジトリをフォークします
  2. 機能ブランチを作成します(git checkout -b feature/AmazingFeature
  3. 変更をコミットします(git commit -m 'Add some AmazingFeature'
  4. ブランチにプッシュします(git push origin feature/AmazingFeature
  5. プルリクエストを開きます

📄 ライセンス

このプロジェクトはGNU General Public License v3.0でライセンスされています。詳細はLICENSEファイルを参照してください。

🙏 謝辞