INSTALL

Linapple - crossplatfom emulator of Apple ][ (Apple2, Apple 2e) series computer for Linux or other OSes with SDL support.

[INSTALL]

You need SDL, cURL, zlib and libzip libraries development versions with -dev or -devel suffixes.

For Debian/Ubuntu their names are:
libsdl1.2-dev           - Simple Direct Media crossplatform library for video, audio, events, etc.
libsdl-image1.2-dev     - Image loading library for Simple DirectMedia Layer 1.2, development files
libcurl4-openssl-dev    - openssl-dev -  cURL net functions
zlib1g-dev              - access .gz files
libzip-dev              - access .zip files

All these libraries are available for free around the world.

For example for Debian/Ubuntu to install:
$ sudo apt-get install libsdl1.2-dev libsdl-image1.2-dev libcurl4-openssl-dev zlib1g-dev libzip-dev

After installing SDL, zlib, cURL, and libzip, you will be able to compile linapple from sources:

Untar the package (in .bz2 format):
$ tar xjf linapple_src-2b.tar.bz2

Then go to src directory and compile.
$ cd linapple_src-2b/src
$ make

If there are no errors, you may install it if you wish:
$ sudo make install

It will be installed in /usr/local/linapple folder, whre you can find linapple.conf file for changing some linapple settings,
and empty `images` and `ftp` folders, where Apple 2 images files and downloaded through FTP cached images are meant to be in. 

Of course you are free to choose any directories of your choice changing it in Makefile in src directory.
Note: you should read/write permissions for these folders, or linapple could not work properly.

For linaaple ability to unpack .zip and .gz files on the fly (either from local disks or from FTP) you also need read/write access for linapple working folder (which by default is /usr/local/linapple), for linapple unpacks these files as drive0.dsk and drive1.dsk for drive 1 and 2 respectively.

OK. If you installed it, you are able to run emulator from any place, just run it like this:
$ linapple

If you have chosen not to install it, go to the upper directory then and run the beast:
$ cd ..
$ ./linapple

If all files are on their places, you should see an X-Window with splash screen. 
Press F2 (or F3 before to choose some disk image in drive 1), and go to work.

Note: linapple needs some files in its current working directory for proper working.

These files are:
splash.bmp              - splash screen
charset40.bmp           - charset for Apple][ (Apple 2e, etc.) text modes.
font.bmp                - font for Help screen and Disk Select screens.
icon.bmp                - nice icon, logo of Apple][ computer.
linapple.conf           - configuration file.
Master.dsk              - disk image with Applesoft(tm) DOS 3.3 inside. See Apple license (on apple.com) for details.

Essential are font.bmp and charset40.bmp, others can be omitted peacefully.

P.S. You may play with some options in Makefile in src directory, if you know what you want to do.

Note: See README file for more detailed instructions on using linapple.

[UNINSTALL]

To uninstall previously installed linapple (by `sudo make install` command) you may write this:
$ sudo make uninstall

This will remove by default entire `/usr/local/linapple` folder and `/usr/local/bin/linapple` script.

Also there is possible command for cleaning compiled binaries in src directory:
$ make clean

Note: `linapple` executable in upper directory will remain intact.

[CONTACT]

I will be glad to see your comments, suggestions and so on on my email beotiger@gmail.com

Sincerely Yours,
beotiger, December 2007 AD - March 2012 AD - June 2015
http://beotiger.com beotiger@gmail.com

Let Apple 2 live forever!