Cross-platform game distribution, with an open source client.
C++ JavaScript Diff CMake C# PowerShell Other
Clone or download
Kenneth Yeast
Latest commit ca5401d Mar 17, 2015
Permalink
Failed to load latest commit information.
build_out Merge branch 'master' of https://github.com/desura/desura-app into li… Jan 22, 2015
cmake set XDG_CONFIG_HOME, XDG_CONFIG_CACHE Feb 3, 2015
src Alternate handling Feb 28, 2015
third_party CMAKE_CXX_FLAGS change remains Linux specific ATM Jan 23, 2015
tools/windows Updated crash dump tool to ignore dumps below 930400 as we dont have … May 15, 2014
.gitignore Updated git ignore file Apr 11, 2014
.travis.yml Turned on CTEST_OUTPUT_ON_FAILURE for travis ci Mar 20, 2014
CHANGELOG version: note #376 fix in changelog Dec 10, 2013
CMakeLists.txt CMAKE_CXX_FLAGS change remains Linux specific ATM Jan 23, 2015
CONTRIBUTING.md Official Update of License from LGPL v2.1 to GPL v3 per Bad Juju Game… Dec 12, 2014
Desura.nsi Installer now forces proxy off (for users with proxy, allows them to … Mar 17, 2015
GPL-3.0.txt Official Update of License from LGPL v2.1 to GPL v3 per Bad Juju Game… Dec 12, 2014
LICENSE.md Official Update of License from LGPL v2.1 to GPL v3 per Bad Juju Game… Dec 12, 2014
README.md Official Update of License from LGPL v2.1 to GPL v3 per Bad Juju Game… Dec 12, 2014
build_cmake.bat build_desura: fix win32 build script Dec 10, 2013
build_cmake_clean.bat some windows related stuff Dec 10, 2013
build_desura.sh curl Jan 13, 2015
build_desura_vis.bat Updated win32 to build as v120_xp for xp compatability Jan 21, 2014
build_desura_vis_Release.bat Added release batch file for Windows Dec 3, 2014
install_deps.sh Revert "Macport" Dec 15, 2014

README.md

Content

  • Desura
  • Build Desura on Linux
  • Build Desura on Windows
  • Build Desura on Mac
  • Special Notes for Advanced Users
  • Closing Remarks

Desura

What is Desura? Desura is a gaming client application that allows users single-click access to download and install games from http://www.desura.com/. For more information, visit http://github.com/desura/desura-app/wiki/

This is the OFFICIAL Desura project, which is the open source project that the commercially maintained Desura Client Application product is built and distributed from. If you have followed the history of the Desura Client App project, there is also "Desurium" which can be built for private use and experimentation with new features and/or fixes that you may want to contribute at some point.

While the Desura App has undergone many iterations presently the project is being managed by the Desura operators at Bad Juju Games, Inc. This project hasn't had as much attention as it requires on a frequent basis and therefore it is undergoing a major development overhaul. Accordingly, there are a lot of "open" issues that need to be addressed and will be notated and updated here frequently.

For more information regarding licensing of the project, please refer to the LICENSE.md file. However, if you aren't going to read the file; DesuraApp is now officially licensed under the GPL v3 license.

Build Desura on Linux (TODO: Revise Linux Build Instructions)

Note: Linux builds are HEAVILY under development, but now that the project is once again GPL v3, we are looking at various parts of the Desurium project for integration into this officially maintained release. Over time, it is expected that all the better parts of Desurium will be entirely integrated into this release and officially sunset (to avoid any continuing confusion between the projects).

Dependencies

You can install dependencies by package manager or install_deps.sh

Required dependencies:

  • GCC (4.8 or later) or Clang (3.4 or later) - compiler multilib support for 32 bit compatibility on 64 bit systems
  • cmake (2.8.5 or later)
  • Freetype
  • GLib2
  • GTK2
  • libEvent
  • libNotify (0.7 or later)
  • libX11 (with libXt)
  • Patch
  • Python

Optional dependencies (will be build by cmake if not found):

  • Boost (filesystem, system)
  • BZip2
  • Curl (7.19.1 or later)
  • Sqlite3
  • tinyxml2
  • wxWidgets (3.0.0 or later)

Optional dependencies (only in special cases):

  • Gtest (only when "WITH_GTEST" switch set to "ON")
  • OpenSSL (only for building Curl)
  • PkgConfig (for building DEB and RPM packages)

Third party bundled libraries:

  • Breakpad
  • CEF (Chromium Embedded)
  • V8

Installation

Open Terminal in Desurium source directory and run:

./build_desura.sh

or you can speed up things by running:

./build_desura.sh -j `getconf _NPROCESSORS_ONLN`

or you can build DEB package:

./build_desura.sh pack DEB

or you can build RPM package:

./build_desura.sh pack RPM

Finally run Desurium using:

./install/desura

or install created DEB or RPM package

For informations on advanced arguments of the build script, run:

./build_desura.sh help

Build Desura on Windows (TODO: Check for Accuracy)

Download and install:

Note: Make sure you add svn and python to your environment PATH

Command Line Build:

Open a 32bit cmd.exe with env vars set up by vc or other scripts (so we have a full build environment) and run:

./build_desura.bat

Wait

Visual Studio Build:

Open a 32bit cmd.exe with env vars set up by vc or other scripts (so we have a full build environment) and run:

./build_desura_vis.bat
  • Set BUILD_ALL as startup project (should already be set)
  • Confirm that you are set to build either Debug or Release
  • Select Properties for "ALL_BUILD"
  • Change to editing "All Configurations"
  • Under "Configuration Properties", select "General"
  • Set "Output Directory" to "$(SolutionDir)$(Configuration)_Out"
  • Set "Target Name" to "desura"
  • Set "Target Extension" to ".exe"
  • Select "Debugging"
  • Set "Command" to "$(SolutionDir)$(Configuration)_Out\desura.exe"
  • Set "Working Directory" to "$(SolutionDir)$(Configuration)_Out"
  • Select "OK"

To Rebuild under Visual Studio:

  • Clean Solution under ALL_BUILD
  • Build "ThirdParty/boost" FIRST and by itself.
  • Build "ThirdParty"
  • Build "ALL_BUILD"

To debug/execute under Visual Studio under Windows 7 (further details: http://msdn.microsoft.com/en-us/library/jj662724.aspx):

  • Under "Start Menu", find link that launches Visual Studio
  • Select "Properties", then "Shortcut", then "Advanced"
  • Choose "Run as administrator"
  • "OK", "OK"

Build Desura on Mac (TODO: Actually Make this Work!)

Note: Mac is currently not a supported platform for the Desura App, but is also under Heavy development. As soon as we have a viable candidate to build and share the Mac Client App Dependencies and Instructions will be posted here to

Dependencies

(Coming Soon)

Installation

(Coming Soon)

Special Notes for Advanced Users

Desura is using the cmake build system for configuration on project files for several build systems (make, VS, nmake, ...). At the top of CMakeFile.txt is a documented list of options

A "normal" way to configure cmake would be something like this:

  • UNIX-based systems:

    1. mkdir build
    2. cd build
    3. cmake ..
    4. make
    5. sudo make install (optionally)
  • win32 based systems:

    1. md build
    2. cd build
    3. cmake ..
    4. open project files and compile them

Closing Remarks

If you need help, want to give some suggestions or just want to talk, feel free to join our IRC channel #desura on irc.freenode.net. Alternatively, you can always send an email to: devsupport@desura.com