kos-ports is a package manager and repository of various useful libraries that have been ported to the Dreamcast operating system KallistiOS. These libraries include common audiovisual formats (jpg, png, mp3, ogg, mpeg), compression formats (libbz2, zlib), scripting languages (Lua, Tcl, MicroPython), gaming APIs (OpenGL, OpenAL, SDL), and more. Each port is meant to be as self-contained as possible and should build on the current version of KallistiOS. Dependency libraries will be fetched and built automatically, if necessary.
Users must have a KallistiOS environment
set up already. This means you must have an SH4 toolchain built and have already
compiled KallistiOS itself. Before attempting to build a port, make sure you have
sourced your KallistiOS environ.sh
file in your current terminal.
curl
or wget
are required to download packages. curl
is used by default,
but wget
may be set as an alternative in config.mk
.config.mk
.kos-ports was modelled after the FreeBSD ports collection, so some users may be familiar with the usage.
To build a port, simply enter its directory and type make install clean
.
The package management scripts should fetch, unpack, patch, and build the package
as well as any dependencies, then clean up files after itself. Once built, the
package's headers will be available in kos-ports/include
and the built library
in kos-ports/lib
. These paths are automatically included in your build flags if
you are using the KOS Makefile system.
There are a few available make
targets that can be used in each port directory:
The following helper scripts are provided in the utils
directory to perform
the above operations on all ports in the tree:
build-all.sh
will install all ports.uninstall-all.sh
will uninstall all ports.clean-all.sh
will clean all ports.Porting a new library is meant to be a relatively simple task. Take a look at
an existing port, such as libpng
, to get an idea how the package manager works.
If you need assistance, feel free to reach out using the usual support channels.