Snes controller input display

Displays your SNES input reading directly from the console data, built in Rust with ggez.

Completely compatible with the RetroSpy Skin format for Super Nintendo controllers.

You can find great skins here: https://github.com/developwisely/squabbler-retrospy-nintendospy-skins image.png

Requirements

QUsb2Snes or SNI
Sd2Snes or FxPak Pro for original hardware

NOTE: Tested working with snes9x-emunwa, and bsnes-plus not with the Default layout.

Configuration

Requires a configuration file named "settings.toml" at this location:

Windows: %localappdata%\snes-input-display\
MacOs: $HOME/Library/Application Support/snes-input-display
Linux: $HOME/.config/snes-input-display

Paths must be in between single quotes

[skin]
# skins_path: Folder where all your Retrospy skins are stored
# skins_path = '/home/example/Documents/squabbler-retrospy-nintendospy-skins/skins'
skins_path = 'C:\Users\example\Documents\squabbler-retrospy-nintendospy-skins\skins'
# skins_name: Folder name of the skin you want to use
skin_name = "snes-super-famicom-squabbler"
# skins_theme = value of '<background name> you want to use, found in the theme's xml file'
# ex: <background name="Black" image="input-display-overlay-famicom.png" />
skin_theme = "Black"

A settings file example can be found here

For Linux and MacOS

Dont forget to set the correct permission on the file to allow it to execute

$ cd /path/to/snes_input_viewer/folder
# Linux
$ chmod +x snes_input_display_linux_amd64
# MacOS
$ chmod +x snes_input_display_mac_amd64

Game List Working with Defaults.json

You should try with Defaults.json if you're on the Sd2Snes/FxPakPro, and will not work with an emulator The F90718 address doesn't work on emulator.

If not working, you can try to figure it out with an Emulator like Bizhawk

Aladdin
Axelay
Castlevania Dracula X
Contra 3
Double Dragon V
F-Zero
Fatal Fury 1, 2, Special
Final Fight 1, 2 and Guy (Not Final Fight 3)
Illusion of Gaia
Killer Instinct
Lufia II - Rise of the Sinistrals
Lufia, The Fortress of Doom
Mortal Kombat 1, 3 (Not 2)
NBA JAM (included Tournament Edition)
NBA Live 95, 96, 97, 98
NBA Showdown
Secret of Mana
Super Castlevania IV
Super Ghouls n'Ghosts
Super Mario Kart
Super Mario World
Super Metroid
The Blues Brothers
The Legend of Zelda: A Link to the Past
The Lion King
SMZ3 Randomizers
...

This list is in no way complete. Please tell me games that also work so I can add them to the list or if you figure out other layouts

Will not work with Super FX and SA-1 games. (Star Fox, Yoshi's Island...).

Controller config file

The controller config file must be in the json format

{
    "layouts": {
        "Default": {
            "address_low": "F90718",
            "address_high": "F90719"
        },
        "Super Mario World": {
            "address_low": "F50DA4",
            "address_high": "F50DA2"
        },
        "Ninja Gaiden Trilogy": {
            "address_low": "F5127A",
            "address_high": "F5127B"
        }
    }
}

You can add addresses to the file for your game if needed.

TROUBLESHOOTING

SNI or QUSB2SNES must be up and running and connected to a powered on console.

Credits

Skarsnik

https://github.com/developwisely/squabbler-retrospy-nintendospy-skins

TODO

Configuration via GUI
Better error management
Default setup on startup

GNU GPLv3

cassidoxa/snes_input_display