XFME Desktop for Windows - testing instructions
================================================

Before you start
----------------
1. Check the download: in PowerShell, in the folder with the ZIP:
       Get-FileHash .\<name>.zip -Algorithm SHA256
   The hash must equal the one published on www.xfme.co.uk (also in <name>.zip.sha256). If it does not, do not run it.
2. Unzip to a folder of your own (README.txt "Installing").
3. Make a COPY of the MFME games you will test with, and use only the copy (README.txt).

What to test
------------
Please try as many of these as you can, on the systems you know best:
 1. Start XFME.exe with no arguments: the XFME Desktop window opens with the games library.
 2. Point the library / Game Manager at your copied games folder; pick games; PLAY; switch between games.
 3. Start a game from the command line, a desktop shortcut, a batch file and your game selector (COMMAND_LINE.txt).
    Try paths with spaces, "£", accented letters, and other languages' characters, and a network share.
 4. Play: coins, stake / jackpot keys, nudges, holds, features, gambles, payouts, refill (refill key), service door
    and test menus, as you would on the real machine.
 5. Sound: the machine's own sounds and samples; volume.
 6. Displays: reels (including band, disc and video reels), lamps, 7-segment and alpha / dot-matrix displays,
    MPU4 Video and other video games.
 7. Window sizes, full screen (F1 / F2 / F3 / Esc as MFME), Focus on Machine, multiple monitors.
 8. Configuration: stake / jackpot / percentage keys, Clear RAM (the machine must start from scratch, as on the real
    machine; your meters go to zero).
 9. Close the game and XFME and start it again: credits, meters and settings must be as you left them, and the game
    should be back almost at once.
10. Missing files: rename a ROM in a COPIED game and start it - XFME must say which file is missing and where it
    looked, and must not crash.

Version and error information (include in every report)
-------------------------------------------------------
* The quick way: Library menu (the three dots above the games list) > "Report a problem..." makes one zip with all of
  the below (version, system, the game's file names and checksums - never the ROMs - and the error log). "Send to
  XFME" sends it straight to Gary and shows a reference; or "Save the zip..." and attach it yourself.
* Or by hand - Help > About: select all the text (Ctrl+A, Ctrl+C) and paste it into the report.
* The error log: %LOCALAPPDATA%\XFME Desktop\logs\xfme_errors.log (paste the lines from the time of the problem).
  Type %LOCALAPPDATA%\XFME Desktop\logs into the Explorer address bar to open the folder.
* XFME sends nothing by itself. The only thing it can send is that report, and only when you press Send to XFME; the
  only things it fetches are the update file and, when you press Update now, the new version (Check for updates...).

Reporting
---------
Use BUG_REPORT_TEMPLATE.txt, one report per problem, and send it to Gary directly. A screenshot (F8 saves the layout
as a picture in the game's folder; or Windows+Shift+S) helps a lot. Please never attach ROM files.
