The sources are in a GitHub repository. To download the sources do:
git clone https://github.com/PerBothner/DomTerm
Alternatively, it may be easier to grab one of the sporadic
A file named
domterm- is a GNU-style release;
it includes some generated files (such as the
A file named
compiled installable files for WSL (Windows Subsystem for Linux).
Please help out with instructions for other platforms, especially MacOS, *BSD, and native (non-WSL) Windows.
On Fedora, you need to first:
sudo dnf install gcc make automake autoconf texinfo patch libwebsockets libwebsockets-devel json-c json-c-devel openssl-devel file-devel libcap-devel asciidoctor zlib-devel
--with-qtwebengine (recommended), also do:
sudo dnf install gcc-c++ qt5-qtbase-devel qt5-qtwebengine-devel qt5-qtwebchannel-devel
If configuring with
xxd - only needed at build time):
sudo dnf install vim-common
For Java classes, do:
sudo dnf install java-1.8.0-openjdk-devel
(You can also use Oracle JDK, version 8 or 9.)
(Tested on Ubuntu 17.10.1)
You need to install the following prerequisites:
sudo apt-get install git gcc make automake libjson-c-dev pkg-config asciidoctor libmagic-dev zlib1g-dev
--with-qtwebengine (recommended), also do:
sudo apt-get install qt5-qmake qt5-default libqt5webengine5 libqt5webchannel5-dev qtwebengine5-dev
In the future you should be able to do
apt-get install libwebsockets-dev, but at the time of writing the available package is too old,
so you have to build libwebsockets from source - see below.
If you need to build libwebsockets from source:
sudo apt-get install cmake
For building from source on WSL (Windows Subsystem for Linux) see the instructions below.
Alternatively, you can use of the pre-compiled
Then create a directory on a Windows partition,
cd to it,
unzip the downloaded file into the partition.
For example (assuming your Windows user name is
wusermkdir DomTerm cd DomTerm unzip /mnt/c/User/wuser/Downloads/domterm-
These library dependencies are needed:
apt-get install libjson-c2 libmagic1 zlib1g
Optionally you can create a symlink for
cd ~/bin ln -s /mnt/c/
Installing Electron is highly recommended.
brew install automake brew install json-c brew install libwebsockets brew install asciidoctor
There are some issues about openssl that I’m not clear about. A reported work-around is to do:
export LDFLAGS="-L/usr/local/opt/openssl/lib -L/usr/local/lib -L/usr/local/opt/expat/lib" export CFLAGS="-I/usr/local/opt/openssl/include/ -I/usr/local/include -I/usr/local/opt/expat/include" export CPPFLAGS="-I/usr/local/opt/openssl/include/ -I/usr/local/include -I/usr/local/opt/expat/include"
A cleaner solution/fix would be welcome.
domterm server requires libwebsockets version 2.2
or newer. As of January 2018, the version in Fedora 27 in fine,
but the version in Ubuntu is too old.
If you need to build libwebsockets from source, do the following:
cd $WORKDIR git clone https://github.com/warmcat/libwebsockets cd libwebsockets mkdir build cd build cmake -DLWS_WITH_SSL=0 -DLWS_WITH_ZIP_FOPS=1 ..
-D options are suggested but not required:
-DLWS_WITH_SSL=0 avoids a dependency on OpenSSL;
-DLWS_WITH_ZIP_FOPS=1 is required if configuring
--disable-compiled-in-resources (the default).
./configure in the
The Electron framework provides a nicer domterm front-end than a regular web browser. It is similar to using qtdomterm, but it is easier to install electron on platforms that don’t have qt/qtwebengine packages easily available.
Grab a suitable package from
zip file with the plainest name (no
For example, at the time of writing the current release is 1.8.2, so
for Windows you want
Unzip into a freshly-created directory.
On Windows Subsystem for Linux (WSL), you need to unzip into a
directory on a Windows partition, not a Linux partition.
For example, assuming the Windows user name is
and Electron version number
So that the
domterm executable can find the electron executable,
you can create an entry in
or (on WSL):
command.electron = /mnt/c/User/
Alternatively, you can create a symlink in your
PATH to electron.
For example, on WSL (where
~/bin is in the default
cd ~/bin ln -s /mnt/c/User/
If building from the
git respository, first do:
This runs the GNU autotools (
Then run the
configure-options can be:
Set the root of the tree into which
will install the built domterm.
The default is
qtdomterm executables are
man pages are installed in
and other “resources” are installed
On WSL the
install-prefix should be on a Windows partition,
at least if you want to use the Electron front-end (which is recommended).
Build the C application
which uses libwebsockets.
lws-build is specified, it should be the path
build subdirectory of the libwebsockets compiled source tree.
Libwebsockets version 2.2 or newer is required, as older versions do not support flow control or paging.
This is the recommended “backend” and the default.
Build a WebSocket server, using Java WebSockets, which allows using any modern browser as a front-end. This server is no longer recommended or enabled by default.
This options adds the classes in
Generates help and man pages using AsciiDoctor.
The default is to do so if
asciidoctor is in the path.
Enable using JavaFX to run standalone applications.
does not need to be specified if using Java SE 8.
It may be needed for OpenJDK or Java SE 7,
in which case it is either a path to
or (for convenience if using Java SE 7) the
If using Java 11 or later (which is “modularized”), you might set:
export JDK_JAVA_OPTIONS='--module-path /path/to/javafx-sdk-13.0.1/lib --add-modules javafx.controls,javafx.web'
Disable building anything that depends on Java.
Use Qt and QtWebEngine
qtdomterm, an advanced front-end that
supports multiple tabs, screen re-sizing, and other nice features.
For this you need the Qt development tools including QtWebEngine installed.
For Fedora, you also need:
sudo dnf install qt5-qtbase-devel qt5-qtwebchannel-devel qt5-qtwebengine-devel
to be compiled into the executable.
Otherwise, they are served from the compressed
To test it, you can try either:
Either starts up a useable terminal emulator in a fresh window.
(The latter is equivalent to
Optionally, you can install the built files
into the configured
Microsoft Windows is now supported using Windows Subsystem for Linux (WSL). This has been tested using the Ubuntu distrubution: Follow the above Ubuntu instructions for getting prerequsities (without the optional qt packages), including (currently) building libwebsockets from source.
Other distributions should work but have not been tested.
It is also recommended that you install electron, as described above.
Electron is a Windows executable, and it needs to be able to read
the “electron application” files in
Hence, if you run
domterm in-place (without
clone’d source directory must be on a Windows partition.
Alternatively, if you run domterm as installed by
install-prefix must be on a Windows partition.
If you want want to use a web browser, Win32 versions of
both Firefox and Google Chrome work pretty well.
The default location (for Firefox
c:\Program Files (x86)\Mozilla Firefox\firefox.exe)
should work out-of-the-box. Otherwise specify
Note that the Microsft Edge browser does not work (for reason not yet known). (Internet Explorer wll probably never be supported.)
Domterm looks for the user settings file in