Skip to content


Repository files navigation

A mod manager

A modern mod manager and launcher for FreeSpace Open


Installation instructions


To run this script you'll need the following:

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.

Ubuntu 18.04 Packages

Install the following packages: sudo apt install nodejs npm python3-wheel python3-setuptools pyqt5-dev pyqt5-dev-tools qttools5-dev-tools qt5-default

Then install pipenv and yarn using the install instructions at their webpages. Also note that you'll need to uninstall the package cmdtest as that also has an executable called yarn.


After your first checkout you will have to run the two commands above and pipenv run python once. If it aborts before displaying Writing, 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/ (or update_file_list.bat on Windows) to update file_list.json.

If you have changed Node.js versions you may need to remove the node_modules directory and rerun yarn install.


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

The icon is borrowed from Hard Light.