Home

Welcome to the QTerminal Wiki!

FAQ

How to set my preferred font for monospace?

Using a good font for monospace is important for a good UX in some apps, especially terminal emulators and code editors.

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.