Skip to content
tsujan edited this page Dec 23, 2025 · 13 revisions

Welcome to the QTerminal Wiki!

FAQ

How to set my preferred font for monospace?

Having a good default monospace is important for a good UX in some Qt apps, especially terminal emulators and code editors. With LXQt ≥ 2.4, it can be set in LXQt Appearance Configuration → Font → Monospace. But the following method can be used everywhere. It overrides LXQt settings too.

Supposing that you prefer DejaVu for monospace (replace it with another font otherwise), create ~/.config/fontconfig/conf.d/0-mono.conf as:

<?xml version='1.0'?>
<!DOCTYPE fontconfig SYSTEM 'fonts.dtd'>
<fontconfig>
 <!-- To fix monospace: -->
 <alias>
  <family>monospace</family>
  <prefer>
   <family>DejaVu Sans Mono</family>
  </prefer>
 </alias>
 <alias>
  <family>serif</family>
  <prefer>
   <family>DejaVu Serif</family>
  </prefer>
 </alias>
 <alias>
  <family>sans-serif</family>
  <prefer>
   <family>DejaVu Sans</family>
  </prefer>
 </alias>
</fontconfig>

Note that it may not be a good idea to do this inside a global place (e.g., /usr/share/fontconfig), as different users may have different preferences.

How to fix colored emojis that are in black and white?

Some fontconfig tricks might be needed to get colored emojis (→ https://github.com/lxqt/qterminal/issues/627).

Supposing that you have installed a font like noto-fonts-emoji, create ~/.config/fontconfig/conf.d/0-emoji.conf as:

<?xml version='1.0'?>
<!DOCTYPE fontconfig SYSTEM 'fonts.dtd'>
<fontconfig>
 <!-- For colored emojis: -->
 <match target="pattern">
  <test name="family">
   <string>monospace</string>
  </test>
  <edit mode="append" name="family">
   <string>Noto Color Emoji</string>
  </edit>
 </match>
 <match target="pattern">
  <test name="family">
   <string>serif</string>
  </test>
  <edit mode="append" name="family">
   <string>Noto Color Emoji</string>
  </edit>
 </match>
 <match target="pattern">
  <test name="family">
   <string>sans-serif</string>
  </test>
  <edit mode="append" name="family">
   <string>Noto Color Emoji</string>
  </edit>
 </match>
</fontconfig>

Then, colored emojis will be shown by Qt apps, QTerminal included.

How to disable a shortcut completely?

Press any modifier key in the shortcut field.

How to launch an instance to execute a command and keep its window open?

Create a script.sh like this:

#!/bin/bash
# Do your work here!
read

make it executable, and run it with qterminal -e script.sh.

To close the window after the execution is finished, press Enter in it.

How to add a custom color scheme as user?

Make the directory ~/.local/share/qterminal/color-schemes/ and put your custom color scheme inside it.

Also, make sure that the name of your color scheme is different from those of QTerminal's schemes, because the latter will take priority.

NOTE: The directory ~/.config/qterminal.org/color-schemes/ is deprecated and should not be used.