Menu
Page Index

An Otter Wiki

Blame

432b0b Matt Hughes 2026-01-16 04:54:20
add build page
1 
# Building Pointcaster
2
4ab926 Matt Hughes 2026-01-16 05:30:31
3
Source code for Pointcaster is available [on Github](https://github.com/eidetic-av/pointcaster). Start by cloning the repository.
63a237 Matt Hughes 2026-01-16 05:25:14
4
432b0b Matt Hughes 2026-01-16 04:54:20
add build page
5
## Linux
6
63a237 Matt Hughes 2026-01-16 05:25:14
7
Builds on Linux use a containerised environment created using the [Dockerfile](https://github.com/eidetic-av/pointcaster/blob/qt/Dockerfile) in the root of the repository. This handles download, installation and configuration of all dependencies.
e6e300 Matt Hughes 2026-01-16 05:14:27
8
9
The Pointcaster AppImage can be built using Docker or Podman from the repository root like so:
10
```sh
11
docker build -t pointcaster .
12
docker run --rm -it -v ./:/pointcaster:Z -w/pointcaster pointcaster ./scripts/build-linux-release.sh
13
```
14
15
The `docker run` command arguments ensure that the repository is mounted inside the container and set as the working directory.
16
17
For a development shell, invoke `bash` or `fish`, where you can configure and build using `cmake`:
18
```
19
docker run --rm -it -v ./:/pointcaster:Z -w/pointcaster pointcaster bash
77dd37 Matt Hughes 2026-01-21 03:38:38
20
e6e300 Matt Hughes 2026-01-16 05:14:27
21
# then inside the dev shell:
77dd37 Matt Hughes 2026-01-21 03:38:38
22
cmake --preset linux-release
23
cmake --build build/linux-release
24
cmake --build build/linux-release --target install
25
cmake --build build/linux-release --target package
e6e300 Matt Hughes 2026-01-16 05:14:27
26
```
27
4ab926 Matt Hughes 2026-01-16 05:30:31
28
The install target places a portable build at `build/linux-release/install/bin/pointcaster`, and the package target creates an AppImage at `build/linux-release/Pointcaster-Linux-<version>.AppImage`, both of which can be run from outside the container.
0e386a Matt Hughes 2026-01-21 03:40:30
29
> [!TIP]
30
> The docker image is used as a base for a [devcontainer](https://containers.dev/) in IDEs that support it.
e6e300 Matt Hughes 2026-01-16 05:14:27
31
77dd37 Matt Hughes 2026-01-21 03:38:38
32
432b0b Matt Hughes 2026-01-16 04:54:20
add build page
33
## Windows