Back to files

README for stellashell v0.1

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The file COPYING contains a copy of the GNU General Public License.

1 Introduction

This is a quick hack to allow easy game loading into the Stella VCS2600 emulator for Linux.

IT REQUIRES THE PACKAGE Xdialog WHICH CAN BE OBTAINED AT http://xdialog.free.fr/ .

It also requires a copy of the bash shell.

I developed this tool under SuSE Linux 6.4. It may work on non-Linux platforms, too. Perhaps you have to hack it a little bit. The script is straightforward to use and additional features are easy to implement.

2 Installation

To install it, make sure you are root and follow the following steps:

tar xvzf stellashell-0.1.tar.gz
cd stellashell-0.1
su (if you're are not root)
cp ./stellashell /usr/local/bin
chmod 755 /usr/local/bin/stellashell

The stellashell is now installed and can be used.

3 Usage

Synopsis: stellashell <dir>

<dir> is a valid directory which should contain the Stella ROM files. It must be readable by the user. The program requires X and a copy of Xdialog. Usage is easy. Just point and click to select the ROM you want to play.

Files with .BIN and .bin extension are recognized as valid Stella ROM Files.

Have a lot of fun!

4 Icon

The file vcs2600.xpm is an icon for use with your favourite windowmanager. It is a xpm file and supports tranparency.

5 Author

Matthias Arndt <matthiasarndt@gmx.net>

The project has a litle homepage: http://www.asmsoftware.de/stellashell.html