Tips & Tricks


  1. Command Line Options
  2. Keyboard Shortcuts
  3. Command Variables
  4. GSettings
    1. Changing the IP and Hostname Used to Check Your Internet Connectivity
    2. Setting a Dynamic Nickname
    3. Customizing the Network List

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

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 Variables

%ID Client ID
%N Nickname
%A Address
%TERMINAL Terminal emulator
%FILEMANAGER File manager
%REMOTEDESKTOP Remote desktop viewer


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.

Changing the IP and Hostname Used to Check Your Internet Connectivity

Afraid 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 com.github.ztefn.haguichi.config check-internet-ip

For example, to change the default hostname value of to

gsettings set com.github.ztefn.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 com.github.ztefn.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 templates (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)