v2.0.1

This is a minor release that only affects the MiSTer platform.

The MiSTer GUI (when running tapto from the Scripts menu) has a new Export Log button which allows uploading the active TapTo log file from /tmp/tapto to termbin.com (exactly how the old TapTUI script did) or copying it to the root of the SD card so it can be transferred to a computer.

The games database update button and database status display has been removed to prepare for some further backend updates. Please use the TapTo Life app to update it or trigger it via an API call: tapto.sh -api media.index

v2.0.0

Version 2.0.0 of TapTo has several breaking changes compared to the previous versions:

• The TapTo Life app must be updated to the latest version available on the app stores (v1.2) before it can connect to TapTo.
• The taptui.sh script has now been deprecated and will no longer be shipped with TapTo on MiSTer. It may be updated to be compatible again in the future, but the TapTo Life app is now the primary supported way to interact with the TapTo service.
• Management of mappings is not yet integrated in the TapTo Life app. Either use the TapTo CLI and API to manage them manually or use the old nfc.csv file temporarily. This functionality will be added to the TapTo Life app soon.
• Writing to tokens using a physical NFC reader is also not implemented in the TapTo Life app yet, but will also be added soon. Either use the app itself to write or use the CLI.

New Features

Some of these features are still in process of being documented. Please ask in the Discord if you need help using them until documentation is available on the TapTo wiki.

• First release of TapTo for Windows is now available! Please be aware it's still in heavily development and more a proof of concept. It works with PN532 readers, ACR122U readers, the TapTo Life app and launchers like Steam, LaunchBox and Flashpoint. Please join the wizzo.dev Discord server if you'd like to join in development and testing!
• A new JSON-RPC over WebSocket API is now used in TapTo with the old REST-based one being completely deprecated. Please see the API wiki article for instructions how to use it. It is still in development.
• New alternate launchers have been added for Sinden cores which allow setting a token to explicitly launch a Sinden core variant, for example by adding ?launcher=SindenSNES to the end of a launch command. Sinden cores must be moved to the _Sinden menu folder to work with this feature. Sinden launchers also set the appropriate setnames as per current community usage.
• The mister.script command has a new option to run a script in the background.
• All launch commands can have their core overridden with the ?launcher=... argument.
• Initial implementation of an optical drive reader has been added which allows using CDs on MiSTer to launch games via a USB CD drive.
• Multiple PN532 reader devices can now be used at once plug and play.
• Alternate launchers for all LLAPI cores have been added.
• Alternate launchers for all PWM cores have been added.
• Alternate launchers for N64 80mhz and PSX2X cores have been added.
• AmigaVision now indexes and can be searched from TapTo Life.
• NeoGeo system now supports .zip and folder game files to be indexed and search from TapTo Life.

Bug Fixes

• The mister.script command will fallback to headless/silent running if the Linux framebuffer is not available (like on a CRT).
• Various fixes added to avoid crashes caused by NFC toy checks during scans.
• Game database will now be properly cleared out when a partial rescan is done.
• NeoGeo and NeoGeoCD systems are now correctly defined and will no longer conflict during index and in TapTo Life searching.

Other Changes

• The ao486 system has been renamed to DOS and a new PC system has been added alongside it.
• The /dev/serial path is no longer used for device detection to avoid conflicts in clone USB chips.
• API launch text is now normalized to avoid issues with UTF input and similar characters. This may be changed.
• Launches can now be run concurrently (like if a launch is long running) and individual commands are now blocking. You probably won't notice anything except that a HTTP GET or POST will now block before running the next command.

Full Changelog: v1.5.1...v2.0.0

v1.5.1

This is a minor bugfix release to address issues with TapTo and the Sinden Lightgun working together on Linux-based platforms including MiSTer and MiSTeX. Sinden Lightguns will now be explicitly ignored during scans for NFC readers attached to the host.

Full Changelog: v1.5.0...v1.5.1

v1.5.0

TapTo v1.5.0 includes many major backend changes to better support new readers and prepare for porting to new platforms. It also introduces some fun new features!

New Features

• MiSTex added as an official supported platform for TapTo
• Multiple NFC readers plugged in at once is now supported (README)
• New file based virtual reader support added (README)
• Arcade cores are now written to the /tmp/ACTIVEGAME file when started
• TapTo now verifies card writes were successful after writing
• New serial reader driver added for custom TapTo readers (README)
• PCSC driver is now included in libnfc
• New input.keyboard token command added (README)
• New launch.search token command added (README)
• The launch.random token command has been expanded game searching and folder support (README)
• New mister.script token command added to launch MiSTer scripts directly (README)
• New input.gamepad token command added (README)
• New experimental feature added to change API port and add basic auth (README)
• Added button to tapto.sh GUI to update games database

Bug Fixes

• TapTUI script now reads and writes using connected NFC readers without issues
• Version in MiSTer tapto.sh GUI is now correct
• The /media/network path is now included in games indexing
• Auto-probe should now affect other connected serial devices far less (tty2oled, MiSTer Spinner, etc.)

What's Changed

• Improve write api endpoint by @wizzomafizzo in #61
• Split all MiSTer code from TapTo core by @wizzomafizzo in #66
• WIP Create new Reader interface by @wizzomafizzo in #67
• Update mister.md by @sreuter in #69
• Stub old docs by @wizzomafizzo in #70
• Add back systems metadata by @wizzomafizzo in #71
• Bug fixes by @wizzomafizzo in #72
• Use Task for builds by @wizzomafizzo in #74
• Miscellaneous fixes by @wizzomafizzo in #75
• Add reader ini option by @wizzomafizzo in #76
• Add MiSTeX platform support by @wizzomafizzo in #77
• Add simple serial driver by @wizzomafizzo in #78
• Add pcsc support to libnfc by @wizzomafizzo in #79
• Add multikey keyboard input command by @wizzomafizzo in #80
• Launch via search by @wizzomafizzo in #81
• Improve random command by @wizzomafizzo in #82
• Add support for launching scripts on MiSTer by @wizzomafizzo in #83
• More misc features by @wizzomafizzo in #84
• Simple serial improvements by @wizzomafizzo in #85

New Contributors

• @sreuter made their first contribution in #69

Full Changelog: v1.4...v1.5.0

v1.4

What's Changed

• Add Tapto Card Reader v1.1 by @TheTrainGoes in #52
• Forget the currently loaded card when on menu by @asturur in #55
• Tapto Switch Cart PCB v3.3 by @TheTrainGoes in #57
• Just log socket creation error by @wizzomafizzo in #58
• Handle Amiibo's, with advanced matching by @sigboe in #51
• Restore ability to tap commands while game is running by @asturur in #56
• MiSTer MGL command by @wizzomafizzo in #59

Full Changelog: v1.3...v1.4

v1.3

This version of TapTo includes a major backend update that adds an HTTP REST API. It's currently undocumented until its full design is more fleshed out. Feel free to use it, but expect breaking changes until it's officially documented.

What's Changed

• Sorted file listing in TapTUI (split on tabs after sorting) by @fayep in #35
• Add PCB cards by @TheTrainGoes in #37
• Update mister.md by @spark2k06 in #41
• Added REST and WebSocket API and improved game tracker by @wizzomafizzo in #38
• Handle commas in the mappings database via TapTUI by @sigboe in #42
• Add a delay for exit game and do not exit from the menu core by @asturur in #43
• Simplified UI to work with CRT and removed logs by @wizzomafizzo in #47

New Contributors

• @fayep made their first contribution in #35
• @TheTrainGoes made their first contribution in #37
• @spark2k06 made their first contribution in #41

Full Changelog: v1.2...v1.3

v1.2

• Support for launching AmigaVision games has been added Documentation
• Support for launching ao486 and NeoGeo games has been greatly improved Documentation
• Launching Famicom Disk System, SG-1000 and WonderSwan Color has now been fixed
• TapTUI has been updated to support the http.post command (thanks @sigboe)
• The launch.random command now supports multiple systems with a comma separated list Documentation
• A -launch flag has been added to the tapto.sh binary allowing to test or manually run token strings

Breaking Changes

• The argument separator for the http.post command has been changed to a comma , instead of a pipe |. This change was made to simplify parsing of chained commands and to match the format of other commands. Going forward, commands will prefer to use a comma as separator unless impossible.
• The shorthand method of launching MiSTer cores (e.g. _Console/PSX) has been removed and a new command mister.core has been created to replace it. This was conflicting with a planned future way of writing game launch commands and is a niche feature only supported by MiSTer. Documentation

All Changes

• Add support for multiple system in launch.random by @wizzomafizzo in #32
• System launch support fixes and additional support by @wizzomafizzo in #33
• Taptui: An interactive way of making a HTTP POST request by @sigboe in #34
• Update documentation and mrext version by @wizzomafizzo in #36

New Contributors

• @sigboe made their first contribution in #34

Full Changelog: v1.1...v1.2

v1.1

What's Changed

• Readers are now hot pluggable and can be plugged in without manually restarting the service
• Add reader connection status command by @wizzomafizzo in #18
• Fix ini not loading before game launch #16 by @wizzomafizzo in #21
• exit_game block list for cores by @asturur in #17
• Add new commands http.post and delay by @wizzomafizzo in #22
• taptui script now selects an ini file by default by @sigboe
• Documentation updates by @timwilsie and @protogem2

New Contributors

• @protogem2 made their first contribution in #13

Full Changelog: v1.0...v1.1

v1.0

TapTo v1.0 is now released! This is intended as a migration release, with fairly minimal obvious changes, except to move the project to its own repository and rebrand from "NFC script" to TapTo.

It should be a straightforward change for you, just download these files to the Scripts folder on your MiSTer and run tapto from the Scripts menu. TapTo will do the rest, making any necessary changes to switch you over from the nfc script.

TapTo will replace the NFC script in the MiSTer Extensions repo on update_all and be available there. This change will automatically happen, but you'll have old NFC script files hanging around until TapTo is run for the first time.

New Features

• A new exit_game option has been added, which makes it so when a token has been removed from the reader it will quit the core back to the menu. This is disabled by default, but can be enabled by adding exit_game = yes to your tapto.ini file.

Changes From NFC Script

• Executable is renamed to tapto.sh.
• All files stored in /tmp are now stored in /tmp/tapto.
  • All /tmp files are renamed from "nfc" to "tapto" where appropriate.
  • Except for /tmp/NFCSCAN, which is now called /tmp/TOKENREAD.
• The nfc.ini file is now called tapto.ini.
  • Header of .ini file is now [tapto].
• The log file format has been changed to JSON.
• The nfcui script has been renamed to taptui and now supports TapTo.

The nfc.csv remains the same, and the Remote app has already been updated to support TapTo.

v1.0-beta4

This is a release candidate for the v1.0 release of TapTo for MiSTer.

It's generally identical to the MiSTer Extensions NFC app, except for:

• Executable name is renamed to tapto.sh
• All files stored in /tmp are now stored in /tmp/tapto
  • All temp filenames renamed from nfc to tapto where appropriate
  • Except for /tmp/NFCSCAN, which is now called /tmp/TOKENREAD
• nfc.ini file is now called tapto.ini
  • Header of .ini file is now [tapto]
• TapTo will attempt to automatically migrate nfc.ini to the new format and uninstall the NFC app
• A new exit_game option has been added to tapto.ini which will exit the current game when a card is removed
• The log file format has been changed to JSON