Skip to content

Instantly share code, notes, and snippets.

@wolfspider
Last active September 27, 2022 10:01
Show Gist options
  • Star 2 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save wolfspider/d26644b943579e223c6291aba675a8d7 to your computer and use it in GitHub Desktop.
Save wolfspider/d26644b943579e223c6291aba675a8d7 to your computer and use it in GitHub Desktop.
Steps to get up and running with Arcan on FreeBSD

Installing Arcan on FreeBSD

Arcan from the beginning has had good FreeBSD support. This is a guide for installing it on your FreeBSD system and additional tips for getting it configured for graphical acceleration without utilizing Xorg/X11. For the most part the build instructions just work as described on the project page and Wiki for Arcan.

Disclaimer: This is a work in progress and will continue to receive updates as things are added

The first thing which needs to be considered is setting up a FreeBSD system with compatible hardware. The main site makes reference to i965 Intel and Nvidia graphics drivers being the main ones tested. AMD GPUs theoretically should work but there are no promises in that regard, your mileage may vary. The machine I have used in this case has the following specs relevant to running Arcan is a Dell Optiplex 990

FreeBSD was installed from the standard .iso image for the AMD64 platform it is FreeBSD Release 11.2

There are two components we will be looking at regarding setting up Arcan. The first is Arcan itself which can be thought of as a "Frame Server". The Frame Server runs and attaches rendering nodes through it's applications (or appls). We need to build this first and then afterward we will retrieve Durden. Durden can be thought of as the application which draws the interface on the screen and communicates with Arcan. Durden doesn't require any compilation at all amazingly and is accessed by Arcan as a parameter at run time. At the time of this writing it is more convenient to install X11/Xorg first to bootstrap the SDL backend in order to set up the keybindings before activating Arcan as a standalone system. My choice initially was to just install GNOME 3 from ports. For the sake of brevity we will assume X11/Xorg has already been set up. The important item here which needs to be added is the kernel mode settings package in order to get up to date drivers for the GPU.

Instructions for configuring this are located here.

The first thing which is needed is to install dependencies necessary to build from source.

pkg install cmake sdl openal-soft freetype libGL libosmesa lua51

Now clone the Arcan repo, create the build folder, and generate the build settings with the following commands:

git clone https://github.com/letoram/arcan.git
cd arcan
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE="Debug" -DVIDEO_PLATFORM=sdl
-DSTATIC_SQLITE3=ON -DSTATIC_OPENAL=ON -DSTATIC_FREETYPE=ON -DDISABLE-JIT=ON ../src
make -j 12

For now, Lua JIT is disabled due to stability issues on FreeBSD reportedly. Dependencies can be statically compiled as well by running the clone.sh file located in the arcan/external/git folder and then building the application.

While building Arcan you should see output in the terminal which verifies the dependencies it has successfully found. There is a CMakeCache.txt file which gets created in the build folder and if there are any questions about whether all the dependencies have been located this is the place to look.

Go back to your user's home directory and clone the Durden repo:

git clone https://github.com/letoram/durden.git

Make sure you are in X11/Xorg before starting Arcan with the SDL backend. I recommend doing this first before running it with the EGL-DRI backend to make sure it starts up fine before moving forward. To start it run this command:

./arcan -p /home/user /home/user/durden/durden -T /home/user/arcan/data/scripts

This command should start Durden for the first time and it will attempt to begin binding keys to actions. For information about configuring Durden go here. You will find an instructional video and information about how to get around.

Now that it's verified everything is working shut down X11/Xorg and rebuild Arcan with the egl-dri backend.

cd /home/user/arcan/build
cmake -DCMAKE_BUILD_TYPE="Debug" -DVIDEO_PLATFORM=egl-dri
-DSTATIC_SQLITE3=ON -DSTATIC_OPENAL=ON -DSTATIC_FREETYPE=ON -DDISABLE-JIT=ON ../src
make -j 12

Start Arcan again and now you should have a new desktop environment without X11/Xorg!

Known Issues

At this time Arcan is not detecting the mouse with the egl-dri backend. I'm using a typical logitech wireless keyboard and mouse, however I tried running the Arcan startup command with "sudo" and it did detect the mouse but the x/y axis is reversed and the sensitivity is too strong. There is code for the mouse in the arcan/src/platform/freebsd folder specific to this which will probably need to be looked at.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment