https://github.com/gusdcoder/leitor_contactless
Leitor Contactless is a high-performance system designed for handling large volumes of data with robust, contactless technology. Optimized for scalability and real-time processing, this project is ideal for applications requiring rapid data throughput and seamless user interactions in environments such as access control, ticketing,
https://github.com/gusdcoder/leitor_contactless
authentication contactless iot mobile-payments nfc relay-attack replay-attack security vulnerability
Last synced: 5 months ago
JSON representation
Leitor Contactless is a high-performance system designed for handling large volumes of data with robust, contactless technology. Optimized for scalability and real-time processing, this project is ideal for applications requiring rapid data throughput and seamless user interactions in environments such as access control, ticketing,
- Host: GitHub
- URL: https://github.com/gusdcoder/leitor_contactless
- Owner: gusdcoder
- License: mit
- Created: 2025-04-12T17:41:39.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-05T19:59:04.000Z (8 months ago)
- Last Synced: 2025-11-05T21:32:11.560Z (8 months ago)
- Topics: authentication, contactless, iot, mobile-payments, nfc, relay-attack, replay-attack, security, vulnerability
- Language: Python
- Homepage:
- Size: 92.8 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Leitor Script
This repository contains a Python script for extracting and processing NFC card data using a smart card reader. The script interacts with NFC cards, parses TLV data, and generates outputs in JSON format.
## Features
- Connects to NFC card readers.
- Extracts AIDs and application data from NFC cards.
- Processes AFL and generates ARQC.
- Parses TLV data and extracts specific tags.
- Saves extracted data to JSON files.
- Interactive CLI built with [Rich](https://rich.readthedocs.io/) featuring animations and selection menus.
## Requirements
- Python 3.7 or higher
- `pyscard` library for smart card communication
- A compatible NFC card reader
## Installation
1. Clone the repository:
```bash
git clone https://github.com/gusdnide/leitor_contactless.git
cd leitor_script
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
## Usage
1. Connect your NFC card reader to your computer.
2. Run the script:
```bash
python extrair_nfc.py
```
3. Follow the on-screen instructions in the interactive CLI to select applications and dump data.
## Configuration
Runtime options such as output directory and default country/currency codes are stored in `config.json`. The file is created automatically on first run:
```json
{
"currency_code": "0076",
"country_code": "0076",
"output_dir": "dumps"
}
```
Edit this file to adjust settings for your environment.
## Output
The script saves the extracted data in the `dumps` directory as JSON files. Each file is named based on the card's track2 data and AID.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Disclaimer
This script is for educational purposes only. Ensure you have permission to access and process NFC card data.