download_unix - joeyfoo/openbve-unofficial GitHub Wiki

#Installing openBVE on Linux or Mac OS X

I am not familiar with Linux. If these instructions are wrong, please help by submitting an issue or corrections

In order to install openBVE on Windows, please follow the instructions below. It is assumed that you know how to download files from the internet and how to extract ZIP files.

##1. Create the Install Directory The first thing you should do is to create the install directory. This directory can be anywhere on your hard drive and can have any name you want, for example "openBVE". It is where you will deploy the files that you are about to download.

##2. Download the Main Program Download the latest stable version of the openBVE main program and extract the ZIP file to your install directory.

##3. Download dependencies These dependencies should be be included in the latest releases. Follow these steps only if the relevant DLL files are not found alongside the openBVE.exe program.

These downloads can be found at the bottom of the Download page.

###Download Tao (Tao.OpenAl.dll, Tao.OpenGl.dll, Tao.Sdl.dll)
Download the ZIP file and extract it to your install directory.

###Download SDL (SDL.dll)
Linux users should visit the SDL homepage and download the runtime libraries matching their operating system.

Mac OS X users should download this package and then copy the SDL.framework directory to /Library/Frameworks.

###Download OpenAL (OpenAL.dll) Linux users should download OpenAL via their operating system's package manager. If OpenAL is not available this way, you can likely only get OpenAL by compiling it.

Mac OS X users should use this installer (broken link).

###Download Mono Visit the Mono homepage and download the latest stable version of Mono matching your operating system (but at least 2.8.1). If you are given any choice, make sure that System.Windows.Forms and libgdiplus are installed.

##4. Start openBVE You can now start OpenBve.exe from your install directory and start playing.

In order to do this, you have to use the terminal. Depending on your operating system and version of mono, the exact steps may vary. The following are examples of what you may need to enter in the terminal. For more information, please look up the manual of your terminal and the Mono documentation.

cd /path/where/openbve/is/installed 
mono OpenBve.exe

cd /path/where/openbve/is/installed 
/path/where/mono/is/installed/mono OpenBve.exe

cd /path/where/mono/is/installed 
mono /path/where/openbve/is/installed/OpenBve.exe

If you have run into problems during the installation process, please see the Troubleshooting section for some commonly encountered problems.

It is also highly recommended that you browse through the other Install and Play pages. You can find valuable information there such as the keyboard assignment and a general overview on how to operate trains.

If you ever want to update openBVE to the latest available version, you only need to download the main program again and extract it to your install directory. You do not have to download the other stuff again.

There are also plenty of legacy add-ons, particularly for BVE Trainsim, that can also be used but must be found and installed manually. Some authors of such add-ons make it easy for you by providing a single archive that just needs to be extracted somewhere, while others make it very complicated. You have to read the folder structure for legacy routes and trains before even considering to install such add-ons.