KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #ai #dsh-plugin #ai-agent #mcp #deepseek-harness #windows

old-knossos

★ 57 Open GitHub ↗

A mod launcher/installer for FSO

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# A mod manager

A modern mod manager and launcher for FreeSpace Open

## Website

[**Installation instructions**](https://fsnebula.org/knossos/)

## Dependencies

To run this script you'll need the following:
* [Python][py] 2 or 3
* [SDL2][sdl2]
* [OpenAL][oal]
* [7zip][7z] (IMPORTANT: This script needs the full implementation, i.e. ```p7zip-full``` _and_ ```p7zip-rar``` on Ubuntu)
* [pipenv][pipenv]
* [yarn][yarn]
* [Node.js][nodejs]
* [ninja][ninja]

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

```bash
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`.

## 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`.

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

## License

Licensed under the Apache License, Version 2.0.
See the [NOTICE](NOTICE) file for information.

The icon is borrowed from [Hard Light][hl].

[py]: http://www.python.org/
[qt]: http://www.qt.io/
[sdl2]: https://libsdl.org/download-2.0.php
[oal]: http://kcat.strangesoft.net/openal.html
[7z]: http://www.7-zip.org/
[pipenv]: https://pipenv.readthedocs.io/en/latest/
[yarn]: https://yarnpkg.com/en/
[ninja]: https://ninja-build.org/
[nodejs]: https://nodejs.org/

[hl]: https://www.hard-light.net/

old-knossos

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README