README.md

A mod manager

A modern mod manager and launcher for FreeSpace Open

Website

Installation instructions

Dependencies

To run this script you'll need the following:

• Python 2 or 3
• SDL2
• OpenAL
• 7zip (IMPORTANT: This script needs the full implementation, i.e. p7zip-full and p7zip-rar on Ubuntu)
• pipenv
• yarn
• ninja

To install the Python and JavaScript dependencies run the following commands:

pipenv install
yarn install

If you're on Windows, the windows_run.bat file will take care of this in addition to launching Knossos itself.

Usage

After your first checkout you will have to run the two commands above and pipenv run python configure.py once. If it aborts before displaying Writing build.ninja..., you have to fix the error before you can continue. If it complains that rcc is missing, you will need to install the developer packages for Qt5.

Now you can use ninja run to launch Knossos in release mode and ninja debug to launch it in debug mode. In debug mode you can use a chromium-based browser to access the DevTools by navigating to http://localhost:4006/.

If you add or remove files in knossos, html/templates or html/images, you need to run tools/common/update_file_list.py (or update_file_list.bat on Windows) to update file_list.json.

License

Licensed under the Apache License, Version 2.0. See the NOTICE file for information.

The icon is borrowed from Hard Light.