Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Hourai Launcher

Windows Build status Travis Build Status Coverage Status License Discord

A cross platform game launcher/patcher.


HouraiLauncher is meant to be built as a standalone executable via PyInstaller. It presents a cross-platform GUI via PyQt5. To use this with a game project, you'll need to configure it, and build your own copy.

NOTE: For the patching functionality to work, the install directory for both the patcher and the game (it must be the same directory) must be writable without elevated permissions. The game will launch properly, but will not patch over time. This includes Window's "Program Files" folder. For such situations, we suggest installing under "C:\Games" or something similar.


Configuration of the launcher is done via the config.json file. Below is documentation

  // The name of the project. This will be used to title the launcher window.
  "project": "Fantasy Crescendo",

  // The remote HTTP endpoint to fetch updates from.
  // Certain patterns will be replaced at runtime.
  // {project} => A URL safe version of the project name. Fantasy Crescendo
  //              becomes "fantasy-crescendo"
  // {branch}  => The target branch for deployment. See the branches information
  //              below
  "index_endpoint": "{project}/{branch}",

  // The logo image for the game
  "logo": "img/logo.png",

  // Required: Index endpoint for the game, see format below. Used to describe game
  // files
  "index_endpoint": "{project}/{branch}/{platform}/index.json",

  // HTTP Endpoint for fetching updated configurations
  "config_endpoint": "{project}/launcher/config.json",

  // HTTP Endpoint for fetching updated launchers
  // NOTE: Expects a text file at https://<endpoint>.hash with the file hash for
  // to efficiently check for updates
  "launcher_endpoint": "{project}/launcher/{platform}/{executable}",

  // Optional: RSS/Atom feed for displaying news.
  "news_rss_feed": "",

  // The platform dependent name of the game binary to launch after checking for
  // updates
  "game_binary": {
    "Windows": "fc.exe",
    "Linux": "fc.x86_64"

  // Optional custom command line arguments to pass to the executable to launch
  // the game
    "Linux": ['-screenheight', '100']

  // The respective deployment branches available. Maps from one historical
  // source control branch to a user-facing string.
  "branches" : {
    "master": "Stable",
    "develop": "Development"

Update Payloads

This patcher expects a JSON payload from the specified index_endpoint in the following format:

  // The last time the game was updated
  "last_updated": 1495329322

  // The base download URL for the game files.
  "base_url": ""

  // The name of the project
  "project": "fantasy-crescendo",

  // The source control branch to target
  "branch": "master",

  // The target platform
  "platform": "Windows",

  // The format for building the
  // {base} => base_url as described above
  // {project} => URL-safe encoded project name
  // {branch} => The source control branch associated with the build.
  // {filepath} => The path of the file relative to the root folder
  // {filehash} => The SHA-256 hash of the file
  "url_format": "{base}/{project}/{branch}/{filename}_{filehash}",

  // A set of all files
  "files": {
    // Keys are the relative path to the root folder. This file list is flat.
    "fc.exe": {
      // The file's SHA-256 hash
      "sha256": "341c76ab4124d205ea796850984d042aefae420226f5017983fab00e435d746e",

      // The size of the file in bytes.
      "size": 77723722


A cross platform launcher patching solution for video games.





No releases published


No packages published