1. Keyboard Shortcuts
  2. Command Line Options
  3. Command Variables
  4. GSettings
    1. Turning of the dark theme variant
    2. Changing the IP and hostname used to check your internet connectivity
    3. Setting a Dynamic Nickname
    4. Customizing the Network List


Keyboard Shortcuts

F1 Show help (opens the FAQ on this website)
F2 Show client information in sidebar
Ctrl+O Connect
Ctrl+D Disconnect
Ctrl+J Join a network
Ctrl+N Create a network
F5 or Ctrl+R Refresh the network list
Ctrl+F Search the network list
Ctrl+M Toggle show/hide offline members
Ctrl+P Show preferences
Ctrl+[ Expand all networks
Ctrl+] Collapse all networks
Ctrl+1 to Ctrl+9 Execute available commands by corresponding number
Ctrl+Q Quit


Command Line Options

Usage: haguichi [options]

-h, --help Show command line help and exit
-v, --version Show version number and exit
--license Show license and exit
-d, --debug Print debug messages
--hidden Start with hidden window
--demo Run in demo mode
--list=FILE Use a text file as list in demo mode


Command Variables

%ID Client ID
%N Nickname
%A Address (IPv4 or IPv6)
%TERMINAL Terminal emulator (gnome-terminal, mate-terminal, pantheon-terminal, xfce4-terminal, konsole, lxterminal, or xterm)
%FILEMANAGER File manager (nautilus, caja, nemo, pantheon-files, thunar, dolphin or pcmanfm)
%REMOTEDESKTOP Remote desktop viewer (vinagre, gvncviewer, krdc, vncviewer, xtightvncviewer, xvnc4viewer or rdesktop)



dconf EditorHaguichi stores your preferences (nickname, commands, etc) using GSettings. Most values can be controlled from the preferences dialog or other user interface elements. However, there are some advanced values that can only be changed using dconf Editor or via gsettings command.

Turning of the dark theme variant

If you are like Linus Torvalds (or if you are the one and only Linus Torvalds himself) and don’t like the dark theme variant, you can turn it of by unchecking prefer-dark-theme. Or via command line:
gsettings set org.haguichi.ui prefer-dark-theme false

Changing the IP and hostname used to check your internet connectivity

Affraid of Google following your each and every virtual footstep? Living behind the great firewall of China? Know a faster (yet reliable) server to ping? No problem, changing these addresses is easier than ever!

For example, to change the default IP value of (Google DNS) to (OpenDNS):
gsettings set org.haguichi.config check-internet-ip

For example, to change the default hostname value of to
gsettings set org.haguichi.config check-internet-hostname

Keep in mind that Haguichi checks internet connectivity by pinging the IP first. Only in case this fails, it will try to resolve the hostname.

Setting a Dynamic Nickname

The nickname Haguichi gives to the client can be set to a dynamic environment variable. In fact the default value is one, namely your username. These variables can be used within the “Change Nick” dialog too. But let’s keep focus on GSettings. Here’s an example to set the nickname to your real name:
gsettings set org.haguichi.config nickname %REALNAME

All available variables are:

%USERNAME Your username, for example “rms”
%REALNAME Your real name, for example “Richard M. Stallman”
%HOSTNAME Your pc’s hostname, for example “thinkpad-x60”

Customizing the Network List

The possibilities on how to display the members in your network list are endless, because it’s template based. There are four lightstemplates (member-template-large, member-template-small, network-template-large and network-template-small). For markup you can use Pango (HTML like) syntax and for linebreaks simply use <br>. All available variables are:


%ID Network ID
%N Name
%S Status (as text)
%T Total member count
%O Online member count
%CAP Capacity
%* or %_* or %*_ Adds a star for client owned networks (the underscore indicates the position of a blank space)


%ID Client ID
%N Nickname
%S Status (as text)
%A Address (both IPv4 and IPv6 if available, separated by a forward slash)
%IP4 IPv4 address
%IP6 IPv6 address
%TUN Tunnel
%CX Connection type
%* or %_* or %*_ Adds a star if the member is the owner of the network (the underscore indicates the position of a blank space)