LinApple is an emulator for Apple ][, Apple ][+, Apple //e, and Enhanced Apple //e computers.

LinApple started as a fork of AppleWin, ported to run on Linux. The source code was downloaded from SourceForge and uploaded to Github by maxolasersquad. As the SourceForge version lay abandoned several users forked the maxolasersquad repository and added several features. Work was done to bring these back into maxolasersquad repository. This repository was eventually moved under the linappleii namespace where development currently resides.

This fork is a fork of a fork of the main project. The prior fork implemented a CMake Build system and I just fixed some weird compiler problem that noone else seemed to have.

LinApple now uses CMake to build:

mkdir build
cd build
cmake ..
make

• -h|--help: Print command-line options and exit.
• --conf path/to/file.conf: Use only the specified configuration file. (The standard configuration file search is not done.)
• -1|--d1 path/to/image1.dsk: Specifies a disk image to load into FDD1 (drive 0)
• -2|--d2 path/to/image2.dsk: Specifies a disk image to load into FDD1 (drive 1)
• -b|--autoboot: Boots the system automatically, rather than displaying the splash screen
• -f: Specifies that the emulator should run in fullscreen mode
• -l: Logs output to a file called AppleWin.log (untested)
• --benchmark: Specifies that benchmark should be loaded (untested)

Note: some command-line options have not been fully tested.

To have LinApple start in fullscreen mode and automatically boot the disk example.dsk, you can open a shell and run:

$ linapple --d1 example.dsk -f --autoboot

This command could also be placed in a shell script, which could be started from an icon or menu on the desktop.

Clicking in the LinApple window will capture the mouse. It may be released by pressing any function key.

Warning: Fullscreen mode does not properly exit in multi-monitor setups. (This is a bug in SDL 1.2.)

When you first start the emulator, press the F3 key and select a disk image file. Press Ctrl+F2 to restart the emulator with the disk "inserted" if the application doesn't automatically load.

Many disk images will boot straight into the application. Some disk images only have files and you must find the correct application to run. In this case you will need to execute BASIC commands to list the files on the disk and run programs.

This is a brief guide to get you started. For more information see Apple II: The DOS Manual (for DOS 3.3) and the ProDOS 8 Technical Reference Manual.

• CATALOG: List the files on a disk. The first column in the list identifies the file type: A for Applesoft BASIC, B for binary. I for Integer BASIC. T for text.
• RUN file: Load and run an Applesoft or Integer BASIC file.
• BRUN file: Load and run a binary file. (Not all binary files can be run.)
• EXEC file: Read commands from a text file and execute them as if they were typed at the keyboard.
• LOAD file: Load an Applesoft or Integer BASIC file into memory.
• LIST: List the current program in memory.

LinApple has several configuration options. Most values are loaded from INI files and linapple.conf.sample has all possible configuration options along with documentation on each. There are also command-line switches and environment variables that change the behavior of LinApple.

1. Default values are initially set by the program.
2. If the command-line switch --conf is used, values are read from the specified file.
3. Otherwise, values are:
   1. read from the system-wide configuration files.
      • These are found in the $XDG_CONFIG_DIRS path. On Linux, the file is typically found at /etc/xdg/linapple/linapple.conf.
   2. read from user-specific configuration files.
      • These are found in the $XDG_CONFIG_HOME path. On Linux, the file is typically found at ~/.config/linapple/linapple.conf.

LinApple partially conforms to the XDG Base Directory Specification.

XDG_CONFIG_HOME specifies the location of "a single base directory relative to which user-specific configuration files should be written". Defaults to $HOME/.config.

XDG_CONFIG_DIRS specifies the location of "a set of preference ordered base directories relative to which configuration files should be searched". Each directory is separated by a colon (:). Defaults to /etc/xdg.