Tips & Tricks
Contents
Command Line Options
Usage: haguichi [options]
-h, --help
|
Show command line help and exit |
-v, --version
|
Show version number and exit |
-d, --debug
|
Print debug messages |
-b, --background
|
Run in background |
--demo
|
Run in demo mode |
--list=FILE
|
Use a text file as list in demo mode |
Keyboard Shortcuts
General
| F1 | Show help (opens the FAQ on this website) |
| F2 | Show client information in sidebar |
| F10 | Open menu |
| Ctrl+O | Connect |
| Ctrl+D | Disconnect |
| Ctrl+, | Show preferences |
| Ctrl+? | Show keyboard shortcuts |
| Ctrl+Q | Quit the application |
Network List
| Ctrl+J | Join a network |
| Ctrl+N | Create a network |
| Ctrl+R or F5 | Refresh the network list |
| Ctrl+F | Search the network list |
| Ctrl+M | Toggle show/hide offline members |
| Ctrl+[ | Expand all networks |
| Ctrl+] | Collapse all networks |
| Ctrl+1 to Ctrl+9 | Execute available commands by corresponding number |
Command Variables
%ID
|
Client ID |
%N
|
Nickname |
%A
|
Address |
%TERMINAL
|
Terminal emulator |
%FILEMANAGER
|
File manager |
%REMOTEDESKTOP
|
Remote desktop viewer |
GSettings
Haguichi 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 8.8.8.8 (Google DNS) to 208.67.222.222 (OpenDNS):
gsettings set com.github.ztefn.haguichi.config check-internet-ip 208.67.222.222
For example, to change the default hostname value of www.google.com to www.amazon.com:
gsettings set com.github.ztefn.haguichi.config check-internet-hostname www.amazon.com
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 two templates, member-template and network-template. For markup you can use Pango (HTML like) syntax and for linebreaks simply use <br>. All available variables are:
Network
%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) |
Member
%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) |