vtap100 1.0.0b5
Configuration generator for Dot Origin VTAP100 NFC reader
License: MIT
Requires Python: >=3.11
Keywords: apple-wallet, dotorigin, google-wallet, nfc, smart-tap, vas, vtap100

# VTAP100 Configuration Generator

A Python tool for generating configuration files for the **Dot Origin VTAP100** NFC Reader.

## Features

- **TUI Editor** - Visual terminal interface for configuration
- **Apple VAS** (Value Added Services) configuration
- **Google Smart Tap** configuration
- **Keyboard emulation** settings
- **NFC Tag** support (Type 2, 4, 5)
- **MIFARE DESFire** configuration
- **LED/Buzzer** feedback settings
- **Validation** of all parameters
- **Rich CLI** with colored output

## Usage

### Run directly with uvx (no installation)

```bash
# TUI Editor
uvx vtap100 editor
uvx vtap100 editor config.txt

# Generate configuration
uvx vtap100 generate --apple-vas pass.com.example.mypass --key-slot 1

# Interactive wizard
uvx vtap100 wizard
```

### Install from PyPI

```bash
# With uv
uv tool install vtap100

# With pip
pip install vtap100
```

Then use without `uvx` prefix:

```bash
vtap100 editor config.txt
```

## TUI Editor

Launch the full-featured terminal user interface:

```bash
vtap100 editor              # New configuration
vtap100 editor config.txt   # Edit existing file
```

Features:
- Visual configuration of all settings
- Live preview of generated config.txt
- Context-sensitive help
- Load/Save/Export
- Bilingual (English/German)

See [TUI Editor Documentation](https://github.com/jensens/vtap100/blob/main/docs/tui.md) for keyboard shortcuts and details.

## Documentation

Detailed documentation can be found in the [docs/](https://github.com/jensens/vtap100/tree/main/docs) directory:

### Getting Started
- [Quickstart](https://github.com/jensens/vtap100/blob/main/docs/quickstart.md)
- [Interactive Wizard](https://github.com/jensens/vtap100/blob/main/docs/wizard.md)
- [TUI Editor](https://github.com/jensens/vtap100/blob/main/docs/tui.md)

### Configuration
- [Configuration Overview](https://github.com/jensens/vtap100/blob/main/docs/configuration/overview.md)
- [Apple VAS](https://github.com/jensens/vtap100/blob/main/docs/configuration/apple_vas.md)
- [Google Smart Tap](https://github.com/jensens/vtap100/blob/main/docs/configuration/google_smarttap.md)
- [Keyboard Emulation](https://github.com/jensens/vtap100/blob/main/docs/configuration/keyboard.md)
- [NFC Tags](https://github.com/jensens/vtap100/blob/main/docs/configuration/nfc_tags.md)
- [MIFARE DESFire](https://github.com/jensens/vtap100/blob/main/docs/configuration/desfire.md)
- [LED & Buzzer](https://github.com/jensens/vtap100/blob/main/docs/configuration/led_beep.md)
- [Settings Reference](https://github.com/jensens/vtap100/blob/main/docs/configuration/settings_reference.md)

### Deployment & Reference
- [Deployment to Reader](https://github.com/jensens/vtap100/blob/main/docs/deployment/upload_to_reader.md)
- [CLI Reference](https://github.com/jensens/vtap100/blob/main/docs/references/cli.md)
- [API Reference](https://github.com/jensens/vtap100/blob/main/docs/api.md)
- [Reference Sources](https://github.com/jensens/vtap100/blob/main/docs/references/sources.md)
- [Troubleshooting](https://github.com/jensens/vtap100/blob/main/docs/troubleshooting.md)

## Development

See [docs/development.md](https://github.com/jensens/vtap100/blob/main/docs/development.md) for the full development guide (TDD, testing, TUI architecture).

## License

MIT License - see [LICENSE](https://github.com/jensens/vtap100/blob/main/LICENSE) for details.

## Links

- [Dot Origin Website](https://www.dotorigin.com/)
- [VTAP NFC Website](https://www.vtapnfc.com/)
- [VTAP Configuration Guide (PDF)](https://www.vtapnfc.com/downloads/VTAP_Configuration_Guide.pdf)