mirror of
https://github.com/rn10950/RetroZilla.git
synced 2024-11-10 18:00:15 +01:00
271 lines
8.9 KiB
Plaintext
271 lines
8.9 KiB
Plaintext
==========================================================================
|
|
|
|
= = = = = = = = = = = = = RetroZilla Read Me = = = = = = = = = = = = = =
|
|
|
|
==========================================================================
|
|
|
|
RetroZilla is subject to the terms detailed in the license agreement
|
|
accompanying it.
|
|
|
|
This Read Me file contains information about system requirements and
|
|
installation instructions for the Windows builds of RetroZilla.
|
|
|
|
For more info on RetroZilla, see
|
|
|
|
https://rn10950.github.io/RetroZillaWeb/
|
|
|
|
To submit bugs or other feedback, see the Navigator QA menu and check out
|
|
GitHub at https://github.com/rn10950/RetroZilla for links to known bugs,
|
|
bug-writing guidelines, and more.
|
|
|
|
|
|
==========================================================================
|
|
|
|
Getting RetroZilla
|
|
|
|
==========================================================================
|
|
|
|
You can download the source code of RetroZilla from the RetroZilla GitHub
|
|
at
|
|
|
|
https://github.com/rn10950/RetroZilla
|
|
|
|
Keep in mind that the source code in its raw form may be buggy. If you are
|
|
looking for a more polished version of RetroZilla, the RetroZilla project
|
|
releases builds of RetroZilla regularly that you can download from
|
|
|
|
https://rn10950.github.io/RetroZillaWeb/
|
|
|
|
Be sure to read the RetroZilla release notes for information on known
|
|
problems and installation issues with RetroZilla. The release notes
|
|
can be found at the preceding URL along with the releases themselves.
|
|
|
|
|
|
==========================================================================
|
|
|
|
System Requirements
|
|
|
|
==========================================================================
|
|
|
|
* General
|
|
|
|
If you want to view and use the "Modern" theme, your display monitor
|
|
should be set to display thousands of colors. For users who cannot set
|
|
their displays to use more than 256 colors, the RetroZilla project
|
|
recommends using the "Classic" theme for RetroZilla.
|
|
|
|
To select the Modern theme after you have installed RetroZilla, from
|
|
the browser, open the View menu, then open the Apply Theme submenu and
|
|
choose Modern.
|
|
|
|
*Windows
|
|
|
|
- Windows 95, 98, Me, NT4, 2000 or XP
|
|
- Intel Pentium class processor (233 MHz or faster recommended)
|
|
- 64 MB RAM
|
|
- 26 MB free hard disk space
|
|
|
|
* We recommend that Windows XP, Vista, 7, 8.x and 10 users not use
|
|
RetroZilla, and instead use the current version of SeaMonkey or Firefox.
|
|
They are much more secure and compatible with the modern web than
|
|
RetroZilla is.
|
|
|
|
* We recommend that Windows 2000 users use Firefox 12 or SeaMonkey 2.9.
|
|
|
|
* We recommend that Windows 98 and Me users use Firefox 3.6 or SeaMonkey
|
|
2.0.14 with the KernelEx platform.
|
|
|
|
|
|
==========================================================================
|
|
|
|
Installation Instructions
|
|
|
|
==========================================================================
|
|
|
|
It is strongly recommended that you exit all programs before running the
|
|
setup program. Also, you should temporarily disable virus-detection
|
|
software.
|
|
|
|
Install into a clean (new) directory. Installing on top of previously
|
|
released builds may cause problems.
|
|
|
|
Note: These instructions do not tell you how to build RetroZilla.
|
|
For info on building RetroZilla from the mozilla.org source code, see
|
|
|
|
https://rn10950.github.io/RetroZillaWeb/
|
|
|
|
|
|
Windows Installation Instructions
|
|
---------------------------------
|
|
|
|
Note: For Windows NT/2000/XP systems, you need Administrator privileges to
|
|
install RetroZilla. If you see an "Error 5" message during installation,
|
|
make sure you're running the installation with Administrator privileges.
|
|
|
|
|
|
To install RetroZilla by downloading the RetroZilla installer,
|
|
follow these steps:
|
|
|
|
1. Click the link to seamonkey-x.xx.en-US.win32.installer.exe (or
|
|
similar file name) on the site you're downloading RetroZilla from to
|
|
download the installer file to your machine.
|
|
|
|
2. Navigate to where you downloaded the file and double-click the
|
|
installer file icon on your machine to begin the Setup program.
|
|
|
|
3. Follow the on-screen instructions in the setup program. The program
|
|
starts automatically the first time.
|
|
|
|
|
|
To install RetroZilla by downloading the .zip file and installing
|
|
manually, follow these steps:
|
|
|
|
1. Click the link to seamonkey-x.xx.en-US.win32.zip (or similar file
|
|
name) on the site you're downloading RetroZilla from to download the
|
|
.zip file to your machine.
|
|
|
|
2. Navigate to where you downloaded the file and double-click the
|
|
compressed file.
|
|
|
|
Note: This step assumes you already have a recent version of WinZip
|
|
(or a similar zip tool) installed, and that you know how to use it.
|
|
If not, you can get WinZip and information about the program at
|
|
www.winzip.com.
|
|
|
|
3. Extract the .zip file to a directory such as
|
|
C:\Program Files\mozilla.org\RetroZilla.
|
|
|
|
4. To start RetroZilla, navigate to the directory you extracted
|
|
RetroZilla to and double-click the seamonkey.exe icon.
|
|
|
|
|
|
|
|
Mac OS X Installation Instructions
|
|
----------------------------------
|
|
|
|
To install RetroZilla by downloading the RetroZilla disk image,
|
|
follow these steps:
|
|
|
|
1. Click the mozilla-mac-MachO.dmg.gz link to download
|
|
it to your machine. By default, the download file is
|
|
downloaded to your desktop.
|
|
|
|
2. Once you have downloaded the .dmg.gz file, drag it
|
|
onto Stuffit Expander to decompress it. If the disk
|
|
image doesn't mount automatically, double-click on the
|
|
.dmg file to mount it. If that fails, and the file
|
|
does not look like a disk image file, do a "Show Info"
|
|
on the file, and, in the "Open with application"
|
|
category, choose Disk Copy. In Mac OS 10.2, you can
|
|
use "Open with" from the context menu.
|
|
|
|
3. Once the disk image mounts, open it, and drag the
|
|
RetroZilla icon onto your hard disk.
|
|
|
|
4. We recommend that you copy it to the Applications
|
|
folder.
|
|
|
|
5. Now Eject the disk image.
|
|
|
|
6. If you like, you can drag RetroZilla to your dock to
|
|
have it easily accessible at all times. You might also
|
|
wish to select RetroZilla as your default browser in the
|
|
Internet system preferences pane (under the Web tab).
|
|
|
|
|
|
Linux Installation Instructions
|
|
-------------------------------
|
|
|
|
Note: If you install in the default directory (which is
|
|
usually /usr/local/mozilla), or any other directory where
|
|
only the root user normally has write-access, you must
|
|
start RetroZilla first as root before other users can start
|
|
the program. Doing so generates a set of files required
|
|
for later use by other users.
|
|
|
|
|
|
To install RetroZilla by downloading the RetroZilla installer,
|
|
follow these steps:
|
|
|
|
1. Create a directory named mozilla (mkdir mozilla)
|
|
and change to that directory (cd mozilla).
|
|
|
|
2. Click the link on the site you're downloading
|
|
RetroZilla from to download the installer file
|
|
(called mozilla-1686-pc-linux-gnu-installer.tar.gz)
|
|
to your machine.
|
|
|
|
3. Change to the mozilla directory (cd mozilla) and
|
|
decompress the archive with the following command:
|
|
|
|
tar zxvf moz*.tar.gz
|
|
|
|
The installer is now located in a subdirectory of
|
|
RetroZilla named mozilla-installer.
|
|
|
|
4. Change to the mozilla-installer directory
|
|
(cd mozilla-installer) and run the installer with the
|
|
./mozilla-installer command.
|
|
|
|
5. Follow the instructions in the install wizard for
|
|
installing RetroZilla.
|
|
|
|
Note: If you have a slower machine, be aware that the
|
|
installation may take some time. In this case, the
|
|
installation progress may appear to hang indefinitely,
|
|
even though the installation is still in process.
|
|
|
|
6. To start RetroZilla, change to the directory where you
|
|
installed it and run the ./mozilla command.
|
|
|
|
|
|
To install RetroZilla by downloading the tar.gz file:
|
|
|
|
1. Create a directory named "mozilla" (mkdir mozilla)
|
|
and change to that directory (cd mozilla).
|
|
|
|
2. Click the link on the site you're downloading
|
|
RetroZilla from to download the non-installer
|
|
(mozilla*.tar.gz) file into the mozilla directory.
|
|
|
|
3. Change to the mozilla directory (cd mozilla) and
|
|
decompress the file with the following command:
|
|
|
|
tar zxvf moz*.tar.gz
|
|
|
|
This creates a "mozilla" directory under your mozilla
|
|
directory.
|
|
|
|
4. Change to the mozilla directory (cd mozilla).
|
|
|
|
5. Run RetroZilla with the following run script:
|
|
|
|
./mozilla
|
|
|
|
|
|
To hook up RetroZilla complete with icon to the GNOME Panel,
|
|
follow these steps:
|
|
|
|
1. Click the GNOME Main Menu button, open the Panel menu,
|
|
and then open the Add to Panel submenu and choose Launcher.
|
|
|
|
2. Right-click the icon for RetroZilla on the Panel and
|
|
enter the following command:
|
|
directory_name./mozilla
|
|
|
|
where directory_name is the name of the directory
|
|
you downloaded mozilla to. For example, the default
|
|
directory that RetroZilla suggests is /usr/local/mozilla.
|
|
|
|
3. Type in a name for the icon, and type in a comment
|
|
if you wish.
|
|
|
|
4. Click the icon button and type in the following as
|
|
the icon's location:
|
|
|
|
directory_name/icons/mozicon50.xpm
|
|
|
|
where directory name is the directory where you
|
|
installed RetroZilla. For example, the default directory
|
|
is /usr/local/mozilla/icons/mozicon50.xpm.
|