Read Me

This is the readme-file for Snes9x Rom Selector.

Contents:

- Introduction
- Installing
- Troubleshooting
- Legal notes
- Contact and contribution notes

Introduction
============

Snes9x Rom Selector is how its called, an user interface, which lets the user
select the game to play and choose some options. It only needs a running python
installation with Tkinter and of course, the super nintendo entertainment 
system emulator "snes9x". 

Installing
==========

Snes9x Rom Selector doesn't need to be installed. It can be run from any 
directory you want, but you have to change some variables in the source 
file ("snes9xromselector.pyw"). 

The first variable is called 'snes9x'.
In the source code, it is defined as follows:

snes9x = "snes9x"

This variable defines the command to be executed to start snes9x. If your 
snes9x-executable is not in your systems PATH-variable, you can specify the
whole path including the name, between the double apostrophes.


The second variable is more important because of it is probably different on 
most systems. It is called "rompath". Here is the path defined, where 
Snes9x Rom Selector should look for rom files. Don't use abbrevations like "~"!
They won't work. It is recommended, that you use the full path 
to your directory where your roms are stored.

Definition of rompath:

rompath = "~/.roms/snes/"


If you set the variables correctly, you can run Snes9x Rom Selector following these steps:

1. Change to the directory where Snes9x Rom Selector is saved.

2. Execute on a terminal the command: "python snes9xromselector.pyw"

3. Now you should see a dialog where you can choose the available games, 
   set some effects and start playing.

Troubleshooting
===============

Q: There are no rom files to select in the dialog.

A: Check if you set the rompath variable correctly. In the version 0.3,
   Snes9x Rom Selector only supports the extensions "zip" and "smc". If
   your rom files have other extensions, you can try to pack it with 
   the "zip"-program and try it again.

Q: If i type "python snes9xromselector.pyw" in a terminal window like xterm
   or konsole I get this error message: "bash: python: command not found"

A: You have no running python installation or the python executable is not
   in your PATH variable. Please check, if you installed python correctly.

If you have any question, not mentioned here, please do not hesitate to
contact me via email (mailto:mrszndl@googlemail.com).


Legal notes
===========

Snes9x Rom Selector is released under the terms of the GNU General Public
License Version 2. For details, see file "LICENSE".


Contact and contribution notes
==============================

For questions, comments and ideas to improve Snes9x Rom Selector 
you can send an email to <mrszndl@googlemail.com>.



Have fun with Snes9x Rom Selector!