Important Dates

Latest Posts

Changes in Download

Editor Comment

brew cask command changed


Revision Differences of Revision 152

[TOC] ¶

This page is also available in ¶
[[ DownloadSpanish | ![flag_es.png](/wlmedia/wlimages/flag_es.png "Ver esta página en español") ]] ¶

## System Requirements ¶

Widelands will work with most any operating system, including Windows, Linux, and MacOS. All modern, vendor-supported versions of these operating systems are supported, but Widelands will run on many outdated versions as well. It does not use any fancy frameworks. ¶

At least 800 MB of RAM are recommended for fluent gameplay; less than 300 MB will likely not work. ¶

Widelands requires a graphics card that can handle OpenGL version 2.1 or higher. If your system can not meet this requirement, the last Widelands version you can run is [build-18](https://launchpad.net/widelands/build18/build-18) (released 2014). ¶

## Official Builds ¶

Downloads for Widelands 1.1 (Released 2022-10-23): ¶

Operating System | Download | MD5 Hash ¶
-------- | ---------- | -------- ¶
**Windows 64-bit** | [Installer](https://github.com/widelands/widelands/releases/download/v1.1/Widelands-1.1-x64.exe) | `ba40f4059915a0c6ee9f601655c649ee` ¶
**Windows 32-bit** | [Installer](https://github.com/widelands/widelands/releases/download/v1.1/Widelands-1.1-x86.exe) | `fcef2ca9b918db984232c3262f82cb8f` ¶
**MacOS X 11.0** and newer, 64-bit | [Disk Image](https://github.com/widelands/widelands/releases/download/v1.1/Widelands-1.1-MacOS11.dmg) | `32a6bdecd5ea51176f51c9e365c3998c` ¶
**MacOS X 12.0** and newer, ARM M1 (Apple Silicon), 64-bit| [Disk Image](https://github.com/widelands/widelands/releases/download/v1.1/Widelands-1.1-MacOS12-Arm.dmg) | `bd83c9fa95c759ceb3f098606f5bfc7b` ¶
**Linux** AppImage (64-bit) | [App Image](https://github.com/widelands/widelands/releases/download/v1.1/Widelands-1.1.AppImage) | `86289ba521de0f32b902776a9466cf3c` ¶
**Linux** Flatpak (64-bit) | [Flatpakref](https://flathub.org/repo/appstream/org.widelands.Widelands.flatpakref) | ¶
**Source code** (.tar.gz) | [Code](https://github.com/widelands/widelands/archive/refs/tags/v1.1.tar.gz) | `04d84445a479a976c6d82a032b685822` ¶
**Source code** (.zip) | [Code](https://github.com/widelands/widelands/archive/refs/tags/v1.1.zip) | `8f05d89498cd50bc35baf4a1d5d4cb18` ¶

For further Linux packages, see the instructions [below](https://www.widelands.org/wiki/Download/#linux) or search your distribution's package repository. ¶

Older versions of Widelands are available from [Launchpad](https://launchpad.net/widelands/+download) (Build 15 and newer) and [Sourceforge](https://sourceforge.net/projects/widelands/) (older builds). ¶

### Windows ¶

1. Download the Windows setup file above ¶
2. Uninstall any older versions of Widelands ¶
3. Double-click it and follow the instructions ¶
4. Afterwards simply start Widelands by clicking on one of the generated icons (desktop, start menu, ...) ¶


### MacOS ¶

1. Download the disk image above ¶
2. Open the Disk Image ¶
3. Copy the executable to your local disk ¶
4. Double click it to run ¶

In case you use [MacPorts](https://www.macports.org/) you can use: ¶

sudo port install widelands ¶


In case you use [Homebrew](https://brew.sh/) you can use: ¶

brew
--cask install widelands ¶

or: ¶

brew install widelands && brew link widelands ¶

The first command will install an App-Bundle into your `/Application` folder, while the latter one will install Widelands into `/usr/local/Cellar/widelands/` and link the executable to `/usr/local/bin`. ¶

#### Arm / Apple Silicon Builds ¶

You should not use a browser to download the Arm build from above. Instead use the command line, e.g.: ¶

``` ¶
curl --location https://github.com/widelands/widelands/releases/download/v1.1/Widelands-1.1-MacOS12-Arm.dmg --output Widelands-1.1-MacOS12-Arm.dmg ¶
``` ¶

Using a browser will set a *quarantine flag*. This can be removed using: ¶

``` ¶
xattr -d com.apple.quarantine Widelands2.app ¶
``` ¶

### Linux ¶
It is likely, that there are pre-compiled packages for your distribution. Widelands is packaged in all major Linux distributions. ¶
In case your distribution does not provide pre-compiled packages for Ubuntu and openSUSE we have special repositories in place (see next section). ¶
Another option is to compile Widelands yourself. Go to the [[ Building Widelands | BuildingWidelands ]] page for further instructions. ¶

#### All Distributions ¶
The AppImage is a standalone application which can be saved to anywhere on the computer and started by simply double-clicking it. ¶

There is also a [flatpak](https://flathub.org/apps/details/org.widelands.Widelands) with the latest build available, which should run on all distributions with flatpak support. Head over to their [setup site](https://flatpak.org/setup/) choose your distribution and follow the instructions to get flatpak running on your system. Some distributions do support flatpak out of the box (e.g. Linux Mint & Fedora). ¶

#### Debian/Ubuntu ¶
For Ubuntu, especially for older versions which will not get a backport of the latest build, we offer a [Personal Package Archive](https://code.launchpad.net/~widelands-dev/+archive/widelands). Follow the install instructions on the PPA's site to add it to your system. ¶

##### Installing ¶

* Install the Personal Package Archive for the current build ¶

~~~~ ¶
sudo add-apt-repository ppa:widelands-dev/widelands ¶
sudo apt-get update ¶
~~~~ ¶

Note that if you added the PPA for the daily builds in the past, you need to remove it with ¶
~~~~ ¶
sudo add-apt-repository --remove ppa:widelands-dev/widelands-daily ¶
~~~~ ¶

If your system doesn't have the `add-apt-repository` command installed, you can do so by calling ¶

~~~~ ¶
sudo apt-get install software-properties-common ¶
~~~~ ¶

* Install Widelands ¶

~~~~ ¶
sudo apt-get install widelands ¶
~~~~ ¶

##### Uninstalling ¶

~~~~ ¶
sudo apt-get remove widelands ¶
sudo apt-get remove widelands-data ¶
sudo apt-get autoremove ¶
~~~~ ¶


#### openSUSE ¶
On openSUSE Widelands is part of the released distributions. The installation is straitforward: ¶
~~~ ¶
sudo zypper in widelands ¶
~~~ ¶

The current development version resides in the games repository. ¶
To install it just add it to your repositories, update your package list and get Widelands: ¶
~~~ ¶
sudo zypper ar http://download.opensuse.org/repositories/games/\$releasever/games.repo ¶
sudo zypper ref ¶
sudo zypper in widelands ¶
~~~ ¶

## Unofficial development Builds ¶

There are some people providing pre-compiled (ready to run like our official releases) packages, made from our current development state. Below are the links to those builds. Installation should work similar as described in "Official builds" ¶

### Automated Daily Builds ¶
Operating System | Download | Hash ¶
-------- | ---------- | -------- ¶
**Windows 64-bit Release (MinGW)** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-mingw-Release-x64.exe) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-mingw-Release-x64.exe.md5) ¶
**Windows 32-bit Release (MinGW)** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-mingw-Release-x86.exe) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-mingw-Release-x86.exe.md5) ¶
**Windows 64-bit Debug (MinGW)** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-mingw-Debug-x64.exe) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-mingw-Debug-x64.exe.md5) ¶
**Windows 32-bit Debug (MinGW)** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-mingw-Debug-x86.exe) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-mingw-Debug-x86.exe.md5) ¶
**Windows 64-bit Release (MSVC)** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-msvc-Release-x64.exe) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-msvc-Release-x64.exe.md5) ¶
**Windows 32-bit Release (MSVC)** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-msvc-Release-x86.exe) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-msvc-Release-x86.exe.md5) ¶
**Windows 64-bit Debug (MSVC)** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-msvc-Debug-x64.exe) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-msvc-Debug-x64.exe.md5) ¶
**Windows 32-bit Debug (MSVC)** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-msvc-Debug-x86.exe) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-msvc-Debug-x86.exe.md5) ¶
**MacOS 11 Release** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-release-clang.dmg) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-release-clang.dmg.md5) ¶
**MacOS 11 Debug** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-debug-clang.dmg) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-debug-clang.dmg.md5) ¶
**Linux AppImage Release** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-Release-clang-10-x86_64.AppImage) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-Release-clang-10-x86_64.AppImage.md5) ¶
**Linux AppImage Debug** | [installer](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-Debug-clang-10-x86_64.AppImage) | [md5](https://github.com/widelands/widelands/releases/download/latest/Widelands-daily-Debug-clang-10-x86_64.AppImage.md5) ¶
**Source code** (.tar.gz) | [code](https://github.com/widelands/widelands/archive/refs/tags/latest.tar.gz)| ¶
**Source code** (.zip) | [code](https://github.com/widelands/widelands/archive/refs/tags/latest.zip)| ¶

### Windows 32 bit and 64 bit ¶
**This way of distribution has been deprecated. Use the links from the table above instead.** ¶

Windows builds are available through [appveyor](https://ci.appveyor.com/project/widelands-dev/widelands/history). On the right of the list click on one of the entries called 'master-NUMBER'. Entries called in another way are not commited into the main trunk and may does not work properly. So be sure to use only the entries called 'master-NUMBER'! On the next page choose one of the releases which fit your Platform (x64 for 64 bit operating system, x86 for 32 bit operating system). In next screen click on the button _'Artifacts'_ and then on the given file. The Download should start automatically. ¶

### macOS ¶

#### Disk Image ¶

[SirVer](https://wl.widelands.org/messages/compose/SirVer/) builds 64bit binaries for macOS fairly often. You can find them here: ¶

<http://www.widelands.org/~sirver/wl/macos_daily/> ¶

Please report any problems with those via [PM to SirVer](https://wl.widelands.org/messages/compose/SirVer/). ¶


#### MacPorts ¶
In case you use [MacPorts](https://www.macports.org/) you can use the following commands to install Widelands: ¶

To get the latest release version, do this: ¶
``` ¶
sudo port -v install widelands ¶
``` ¶
To get the last devel version that has been tested, do this: ¶
``` ¶
sudo port -v install widelands-devel ¶
``` ¶
and to build the untested tip of the bzr commit tree, do this: ¶
``` ¶
sudo port uninstall widelands-devel ¶
sudo port -v install widelands-devel +HEAD ¶
``` ¶
Note that on that last +HEAD version, the listed date of the port when you check with port info or port -v installed will not necessarily be accurate. You have to uninstall or deactivate the widelands-devel version before you install the new +HEAD version to make sure you have the latest tip of the tree, as MacPorts cannot know what the tip of the bzr tree is for a +HEAD version. ¶

He have a [discussion topic on the forum](https://wl.widelands.org/forum/topic/2627/) for MacPorts. ¶

### Linux ¶


#### All Distributions ¶
We provide flatpaks of the current development branch. These can be installed alongside your existing Widelands release builds. Follow the [setup instructions](https://flatpak.org/setup/) for your distribution to get flatpak support. ¶

Next you need to at the flatpak-beta-channel. Open a terminal and enter: ¶
``` ¶
flatpak remote-add flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo ¶
``` ¶
Now you can either install the Widelands-Beta (that's how it is called on flathub) via your distributions software-center or the command line: ¶
``` ¶
flatpak install flathub-beta org.widelands.Widelands ¶
``` ¶
Updating uses a different syntax: ¶
``` ¶
flatpak update org.widelands.Widelands//beta ¶
``` ¶
`//beta` is the branch name. The official release is `//stable`. ¶

#### ArchLinux ¶
__PKGBUILD:__ There is a widelands-git pkgbuild in the Arch User Repository: [click here](https://aur.archlinux.org/packages/widelands-git) ¶

#### Ubuntu (recent releases) and derivatives (like Linux Mint >= 17) ¶

The dev team maintains a PPA for Ubuntu on Launchpad with daily builds of the latest development version. ¶
PPA stands for personal package archive - it is essentially something you add to your apt sources.list and which will get queried when you search in the Ubuntu Software Center (or via other alternatives such as apt-get install). It will guarantee that you are using the latest version of Widelands on your system. ¶

Our PPA with daily builds is here: <https://launchpad.net/~widelands-dev/+archive/widelands-daily>. Installing from it is as simple as opening a terminal and typing: ¶

sudo add-apt-repository ppa:widelands-dev/widelands-daily ¶
sudo apt-get update ¶
sudo apt-get install widelands ¶


If your system doesn't have the `add-apt-repository` command installed, you can do so by calling ¶

~~~~ ¶
apt-get install software-properties-common ¶
~~~~ ¶


__PS.__ There are only release builds and release builds with debug info on Launchpad. To use the debug window (F6) you will need to build Widelands in debug mode, see [[ Building Widelands | BuildingWidelands ]] for a HowTo on building. ¶

## Source Code ¶

### Release ¶

See download links on top of the page. ¶

### Development version ¶
If you plan to join development or are just interested in the latest inventions ¶
you should go for this. You __need to have__ Git installed, to check-out the master branch. Type in the ¶
console: ¶

~~~ ¶
git clone https://github.com/widelands/widelands.git ¶
~~~ ¶

After downloading the source, head over to [[ Building Widelands | BuildingWidelands ]] for a HowTo on building.