SnesGameManager

Pyqt tool to organize snes roms


License
MIT
Install
pip install SnesGameManager==1.0.0

Documentation

– Leia em português!
– Read in English!

Snes Game Manager

SGM is an application that aims to organize roms of your Super Nintendo emulator in a visual, simple and practical way.
Some of the application's functions include:

  • Detect rom files and arrange them in a ordered list.
  • Download game covers automatically, based on the name of the game.
  • Run the rom on your favorite emulator.

Installation

Executable

For now, the executable version of SGM is only compatible with linux.
Available for download here.
After unpacking the file. Provide the necessary permissions for the SGM executable located in the root directory.
For now SGM is only compatible with the zsnes emulator. So be sure to download it with:

(ubuntu)

sudo apt install zsnes

Python

For a more versatile version, use SMG direct from python.
This version has not been tested yet. But most likely works on windows and mac.
Make sure you have python 3.6 installed with "PyQt5" and "requests" libraries on your computer.
Unzip the downloaded project from the github page. Then run main.py with:

python3.6 main.py

Usage

When running the program this will be the main screen.
Click "File" and then "Open roms folder" to add your roms folder.

passo1

A window should open as the file browser, select the desired folder and click "open".

passo2

After this the files will be loaded and organized.
To download the game covers, click on "Functions" and then "Download game covers".

passo3

The download will start, after its completion close the dialog box.
Note that sometimes a cover download can fail. This is probably due to the ROM file name.
Try to modify it to be compatible with the original name of the game in capitalized letters.

passo4

To play the game, simply select it and hit the Play button. Your emulator should take care of the rest.

Future additions

In future versions SGM will bring features like:

  • Support for Windows and Mac OS.
  • Support for other emulators like higan and snes9x.
  • Function for configuring controls and shortcuts.
  • Support for Japanese game covers.
  • Carousel display function.
  • Function to better configure the game list.

Project Structure

The project is written in python 3.6, using the UI library PYQT5.
The UI was built entirely using the QT designer.
In order to "compile" the project in executable form, the pyinstaler was used.
In order to download the images, the python requests library was used.
All images are downloaded from this amazing repository.
The code is all appropriate for the English language, although the comments are written in pt-br. This should not be a big obstacle, but I will try to translate that part into the future.

Contributing

Pull requests are welcome. For big changes, please open a issue to discuss the change.
For direct contact, send me an e-mail: allanvobraun@gmail.com

License

Free Software.
MIT