launchercli

Manifiesta Launcher CLI

Manifiesta launcher command line tool to check / download files from manifiesta.

Behavior

Step 1. Load a metadata json file.

At minimum it requires the following:

{
    "name": "manifest_name",
    "manifiesta_url": "url to the manifest server",
    "base_path" : "pathname"
}

By default it will load "launchercli_metadata.json", however if you rename the executable it will instead load "{executable}_metadata.json. You may also supply the -metadata tag to ignore the executable name.

name: name of the manifest to retrieve.

manifiesta_url: address to the manifiesta server.

base_path: path, relative to the launcher, where files will be placed.

Step 2. Check Manifiesta Server for Updates

The launcher reaches out to the manifiesta server to retrieve the manifest version. If the version number matches with the server it will continue to Step 5. If the manifiesta server is not reachable it will prompt the user to continue to Step 5.

Step 3. Check and Download Files

The launcher pulls down the entire manifest and checks for issues (currently rejects absolute paths for files). It then begins the check and download file process. Every file is scanned to match the manifest's file size and sha256 hash. If the file does not exist or do not match, it will download the file from a random source given. It will retry failed downloads at least 3 times for every source given for the file. The downloaded file is then checked for the correct size and hash. If it is unable to ultimately check and download everything on the manifest the launcher will abort. Files downloaded are placed relative to the location of the launcher and the base path of the manifest. Files not present on the manifest are ignored.

Step 4. Update Local Metadata

Step 5. Launch the Application

The launcher will now run the executable given by the manifest's launch path with the environments variables or arguments applied. Upon successful launch, the launcher will exit.

Command Line Arguments

-metadata="{metadata file path}" (Optional)
Uses the metadata file at the path specific instead of the default.

-check (Optional)
Check flags ignores the manifest version and begins the check and download file process.