Help

Version 50 (Adrian Georgescu, 06/10/2015 04:47 pm)

1 30 Tijmen de Mes
h1. Help for Blink QT for Windows and Linux
2 1 Tijmen de Mes
3 46 Adrian Georgescu
To use Blink you need a SIP account from a SIP service provider. Similar to using an email program, you must configure Blink with the account you have obtained from your service provider. If things do not work the way you expect, there can be several reasons. The cause may be located by Blink software itself, the network connectivity or the SIP Service Provider.  While Blink may not be bug free, based on experience so far most of the problems are related to the network connectivity (packet loss, presence of a broken SIP ALG router) or/and the SIP Service Provider (most provider only support Voice calls). It is not the end-user who should understand the mechanics about how things work, so the main responsibility of making sure that things work correct falls into the hands of the SIP service provider who must properly setup its SIP infrastructure. To eliminate some possible causes, try to use the built-in accounts provided by Blink, all features are known to be working using these accounts. 
4 1 Tijmen de Mes
5 32 Adrian Georgescu
For help about Blink Pro/Lite  on MacOSX see {{wiki(blinkc, Help_For_Blink_Pro, "Help for Blink Pro" )}}
6 32 Adrian Georgescu
7 33 Adrian Georgescu
h2. Features
8 33 Adrian Georgescu
9 36 Adrian Georgescu
 * Multiple SIP accounts
10 37 Adrian Georgescu
 * Bonjour neighborhood discovery
11 42 Adrian Georgescu
 * SIP server discovery using DNS (NAPTR, SRV, A records lookup)
12 41 Adrian Georgescu
 * Audio calls (Opus, G.722, G.711, Speex, GSM, ilBC codecs)
13 50 Adrian Georgescu
 * Video calls (H.264 and VP8 codecs)
14 38 Adrian Georgescu
 * Chat sessions (MSRP protocol)
15 40 Adrian Georgescu
 * File Transfer (MSRP protocol)
16 39 Adrian Georgescu
 * Multiparty audio conference (both client and server)
17 39 Adrian Georgescu
 * Multiparty chat conference (MSRP switch client)
18 41 Adrian Georgescu
 * SIMPLE Presence (XCAP, Publish, RLS subscribe)
19 1 Tijmen de Mes
 * Contacts management (XCAP)
20 36 Adrian Georgescu
 * Google contacts integration
21 36 Adrian Georgescu
 * Voicemail notifications
22 41 Adrian Georgescu
 * Call history, recording, redial and hold
23 36 Adrian Georgescu
 * ICE NAT traversal
24 49 Adrian Georgescu
 * SDES and ZRTP encryption for RTP streams
25 36 Adrian Georgescu
 * Hotplug audio device detection (Windows)
26 36 Adrian Georgescu
27 31 Tijmen de Mes
28 34 Adrian Georgescu
h2. Connectivity Problems
29 1 Tijmen de Mes
30 1 Tijmen de Mes
If you encounter connectivity problems like inability to receive incoming calls or failure to make outbound calls, you should obtain the SIP trace logs and contact your SIP Service Provider and ask for the reason.
31 1 Tijmen de Mes
32 1 Tijmen de Mes
h3. SIP Trace Logs
33 1 Tijmen de Mes
34 2 Tijmen de Mes
SIP Protocol trace can be enabled in menu _Blink -> Preferences -> Logging -> SIP trace_. The location of the trace file is:
35 1 Tijmen de Mes
36 1 Tijmen de Mes
* Linux: ~/.blink/logs/sip_trace.txt
37 1 Tijmen de Mes
* Windows XP: C:\Documents and Settings\Username\Application Data\Blink\logs\sip_trace.txt
38 1 Tijmen de Mes
* Windows Vista and 7: C:\Users\Username\AppData\Roaming\Blink\logs\sip_trace.txt
39 1 Tijmen de Mes
40 45 Adrian Georgescu
h2. Reporting Problems
41 1 Tijmen de Mes
42 45 Adrian Georgescu
Go to "Blink Support Forum":http://support.icanblink.com 
43 1 Tijmen de Mes
44 2 Tijmen de Mes
Please report your OS name and version and Blink version. You can find Blink version in menu _Blink -> About_.
45 1 Tijmen de Mes
46 1 Tijmen de Mes
h3. Program Exceptions
47 1 Tijmen de Mes
48 43 Saúl Ibarra Corretgé
On Linux, Blink program exceptions are logged to standard error (if running from a terminal).
49 1 Tijmen de Mes
50 44 Saúl Ibarra Corretgé
On Windows, Blink exceptions are logged to _output.log_, which is located in different places dependin on the Windows version:
51 44 Saúl Ibarra Corretgé
* Windows XP: C:\Documents and Settings\Username\Application Data\Blink\logs\output.log
52 44 Saúl Ibarra Corretgé
* Windows Vista and 7: C:\Users\Username\AppData\Roaming\Blink\logs\output.log
53 44 Saúl Ibarra Corretgé
54 44 Saúl Ibarra Corretgé
These files can easily be accessed from the Window -> Logs menu.
55 1 Tijmen de Mes
56 1 Tijmen de Mes
h3. Crash Reports
57 1 Tijmen de Mes
58 1 Tijmen de Mes
On Linux, in case of a crash, a core file is generated in the user home directory. If no dump is generated, add to the user profile _ulimit -c unlimited_
59 1 Tijmen de Mes
60 2 Tijmen de Mes
On Windows XP, crash dump files can be found in the folowing folder: _C:\Documents and Settings\All Users\Application Data\Microsoft\Dr Watson,_ the filenames are called _drwtsn32.log_ and _user.dmp_. The dump file _user.dmp_ can be analyzed with the Windows Debugger. Load the file _user.dmp_ in "Windows Debugger":http://www.microsoft.com/whdc/devtools/debugging/default.mspx and type _!analyze -v_ to obtain a backtrace. Click "here":http://support.microsoft.com/kb/315263 for instructions on how to use the debugger.
61 1 Tijmen de Mes
62 1 Tijmen de Mes
h3. Configuration File
63 1 Tijmen de Mes
64 1 Tijmen de Mes
Blink accounts and settings are stored in a flat-text configuration file.
65 1 Tijmen de Mes
66 1 Tijmen de Mes
It is critical that you do not edit this file manually. If you did and Blink does not start you must delete the file and start all over again. The location of the configuration file is:
67 1 Tijmen de Mes
68 4 Tijmen de Mes
* Linux: _~/.blink/logs/config_
69 4 Tijmen de Mes
* Windows XP: _C:\Documents and Settings\Username\Application Data\Blink\config_
70 4 Tijmen de Mes
* Windows Vista and 7: _C:\Users\Username\AppData\Roaming\Blink\config_
71 5 Tijmen de Mes
72 1 Tijmen de Mes
If you send the configuration file to us for debugging, use a text editor to strip the passwords and Google token.
73 1 Tijmen de Mes
74 1 Tijmen de Mes
h2. SIP Accounts
75 1 Tijmen de Mes
76 1 Tijmen de Mes
!>BlinkQTScreenshot-Enrollment.jpg!
77 14 Tijmen de Mes
78 9 Tijmen de Mes
To use Blink you need a SIP Account. At first start, Blink shows the _Add Account_ wizard that helps you configure the initial SIP Account. 
79 7 Tijmen de Mes
80 1 Tijmen de Mes
If you do not have a SIP Account, Blink can create one for you using the free service provided by SIP2SIP. For more information about this service visit http://sip2sip.info
81 1 Tijmen de Mes
82 6 Tijmen de Mes
If you already have a SIP Account, select this option then enter the SIP address in the form of _user@domain_ and _password_. The SIP registrar of the domain is then automatically located in the DNS.
83 1 Tijmen de Mes
84 6 Tijmen de Mes
You may configure Blink to use multiple SIP Accounts. To configure a new SIP Account, go to menu _Blink->Accounts->Add Account_.... The Add Account window shows up and you can repeat the steps described above.
85 1 Tijmen de Mes
86 1 Tijmen de Mes
After you have configured an account, you can see the status of the registration in the account list of Main Window window. Solid color means that the account has successfully registered, gray color means that the registration has failed or is in progress.
87 1 Tijmen de Mes
88 6 Tijmen de Mes
To edit the properties of existing accounts go to menu _Blink -> Accounts -> Manage accounts_.
89 1 Tijmen de Mes
90 1 Tijmen de Mes
h2. Main Interface
91 1 Tijmen de Mes
92 28 Tijmen de Mes
93 15 Tijmen de Mes
Blink presents a _Contacts driven_ interface as the main window. The design allows to locate a Contact then to start an action for it, for example to start an audio call.
94 1 Tijmen de Mes
95 1 Tijmen de Mes
Hover the mouse over the GUI elements to see a short description of their function.
96 29 Tijmen de Mes
97 29 Tijmen de Mes
!>BlinkQTScreenshot-Contacts.jpg!
98 1 Tijmen de Mes
99 1 Tijmen de Mes
h3. SIP Account
100 1 Tijmen de Mes
101 16 Tijmen de Mes
You can select the SIP Account used as identity for outbound sessions in the _Accounts drop down box_ presented on the top of the main interface.
102 1 Tijmen de Mes
103 1 Tijmen de Mes
h4. Bonjour Account
104 1 Tijmen de Mes
105 16 Tijmen de Mes
_Bonjour Account_ is a special type of account that is designed to announce itself and discover other neighbours on the local area network. This account does not require a server or SIP service in order to operate.
106 1 Tijmen de Mes
107 16 Tijmen de Mes
Bounjour account can be enabled or disabled in menu _Blink -> Accounts_
108 1 Tijmen de Mes
109 1 Tijmen de Mes
h3. Search Bar
110 1 Tijmen de Mes
111 1 Tijmen de Mes
The Search bar is used for finding an existing contact or for entering a SIP address or telephone number.
112 1 Tijmen de Mes
113 16 Tijmen de Mes
To search for a local contact in Blink's _Contacts List_ or the syncronized _Google Contacts_, type text in the Search Bar. You may select a Contact that matched the typed text or use the typed text as the Contact for the next action.
114 1 Tijmen de Mes
115 16 Tijmen de Mes
Use the buttons presented at the bottom of the main window to start a session to the current selected Contact or press on _Add Contact_ to add the typed address to the _Contacts List_.
116 1 Tijmen de Mes
117 1 Tijmen de Mes
Pressing enter after antering text in the search bar will start an audio call to that address.
118 1 Tijmen de Mes
119 16 Tijmen de Mes
If you have registered a SIP Account with Blink, you can search for SIP addresses of other Blink users in menu _Tools -> Search for people_....
120 1 Tijmen de Mes
121 1 Tijmen de Mes
h3. Presence Bar
122 1 Tijmen de Mes
123 1 Tijmen de Mes
You can use the elements in this section of the interface to change your presence state.
124 1 Tijmen de Mes
125 1 Tijmen de Mes
h3. Panel Switcher
126 1 Tijmen de Mes
127 1 Tijmen de Mes
This button can be used to switch between the Contacts and Calls panel.
128 1 Tijmen de Mes
129 1 Tijmen de Mes
h3. Contacts List
130 1 Tijmen de Mes
131 1 Tijmen de Mes
Contacts are organized into Groups. Groups can be collapsed or expanded by clicking on their left-side triangle.
132 1 Tijmen de Mes
133 1 Tijmen de Mes
Right click on a Group or Contact to see all possible actions for each of them.
134 1 Tijmen de Mes
135 16 Tijmen de Mes
Clicking on _Return key_ or double-clicking a Contact will start the default session type depending on the preferred media configured for each Contact. The default action is to start an _audio call_.
136 1 Tijmen de Mes
137 1 Tijmen de Mes
h4. Google Contacts
138 1 Tijmen de Mes
139 27 Tijmen de Mes
!>BlinkQTScreenshot-Google.jpg!
140 27 Tijmen de Mes
141 16 Tijmen de Mes
The group named _Google Contacts_ displays addresses synced with the Google gmail service. To enable Google Contacts syncronization, go to menu_ Tools->Enable Google Contacts_. When prompted type in your Google account credentials. You can disable the Google Contacts from the same menu.
142 1 Tijmen de Mes
143 1 Tijmen de Mes
h4. Bonjour Neighbours
144 1 Tijmen de Mes
145 16 Tijmen de Mes
_Bonjour Neighbours_ appear in the _Contacts List_ as a separate Group. When selecting_ Bonjour_ as the default account,_ Bonjour Neighbours_ group is expanded and moved on top of the Contacts list. When changing back to a regular SIP Account, the groups in the Contacts list reshuffle to their previous positions.
146 1 Tijmen de Mes
147 1 Tijmen de Mes
h3. Action Buttons
148 1 Tijmen de Mes
149 1 Tijmen de Mes
Use the buttons presented at the bottom of the main window to start a session to the current selected Contact.
150 1 Tijmen de Mes
151 1 Tijmen de Mes
h4. Add Contact
152 1 Tijmen de Mes
153 26 Tijmen de Mes
!>BlinkQTScreenshot-AddContact.jpg!
154 1 Tijmen de Mes
155 19 Tijmen de Mes
You can add a _Contact_ to the _Contacts_ _List_ by clicking on the  _<notextile>+</notextile>_ button presented on the bottom left of the main interface. _Add Contact_ "window":http://icanblink.com/screenshots-qt.phtml#add_contact appears. The contacts can be stored either locally on the computer that runs Blink or the storage server for the SIP accounts that have XCAP storage feature enabled.
156 1 Tijmen de Mes
157 1 Tijmen de Mes
h4. Edit Contact
158 1 Tijmen de Mes
159 16 Tijmen de Mes
You can edit a Contact by right clicking on it and select Edit menu option. _Edit Contact_ "window":http://icanblink.com/screenshots.phtml#add_contact appears. To set the_ Icon for the Contact_, click on the Icon area, a file selection dialog appears. If Subscribe to Presence is enabled and the contact publishes its own icon, the icon is automatically retrieved from the network. If a local icon is selected, it will overwrite the network provided icon.
160 1 Tijmen de Mes
161 1 Tijmen de Mes
h4. Silent Button
162 1 Tijmen de Mes
163 1 Tijmen de Mes
Use this button to disable the audible ringtones caused by incoming session request.
164 1 Tijmen de Mes
165 1 Tijmen de Mes
h2. Alert Panel
166 1 Tijmen de Mes
167 25 Tijmen de Mes
!>BlinkQTScreenshot-AlertPanel.jpg!
168 24 Tijmen de Mes
169 20 Tijmen de Mes
Incoming session requests bring up the _Alert Panel_. Click on the _Accept Button_ to accept a session request. There are two options for rejecting an incoming session request:
170 1 Tijmen de Mes
171 20 Tijmen de Mes
 * Click on the _Reject button_. The session is rejected with SIP response code 603 and all other SIP devices registered for the same account stop ringing. Forwarding to voicemail or other destinations, when available in the SIP server is also cancelled. You must use this option to terminate all call processing associated with the request.
172 20 Tijmen de Mes
 * Click on the _Busy button_. Blink sends a 486 code back to the caller and stops ringing, other SIP devices keep ringing and forwarding to other destinations remains active as set in the SIP server. You must use this option when you want to pick up the call at a different location or allow the Server to perform other pre-configured routing decisions.
173 20 Tijmen de Mes
 * Click on the Escape key. Blink stops ringing and does nothing else with regards to SIP signaling. Use this option when you do not want to take any decission about the call but you do not want to be disturbed by the ring tone either.
174 20 Tijmen de Mes
175 1 Tijmen de Mes
The currently selected input and output audio devices are showed for incoming audio session requests.
176 1 Tijmen de Mes
177 1 Tijmen de Mes
h2. Audio Calls
178 1 Tijmen de Mes
179 23 Tijmen de Mes
!>BlinkQTScreenshot-Conference.jpg! 
180 1 Tijmen de Mes
181 1 Tijmen de Mes
Blink has no traditional telephone dialpad, nor you will need one to interact with it. As computers have physical keyboards displaying a classic 12 key dial-pad is a poor design choice for a modern graphical user interface of a rich communications SIP client.
182 1 Tijmen de Mes
183 21 Tijmen de Mes
To start an _Audio Call_, select an existing contact or enter a SIP address or telephone number in the search bar.
184 1 Tijmen de Mes
185 1 Tijmen de Mes
Once text is entered in the search bar just press enter to start and audio call to that address.
186 1 Tijmen de Mes
187 21 Tijmen de Mes
Once a Contact is selected, click on the _Green Handset_ located at the bottom of the main interface or right click and select _Start Audio call_ from the contextual menu. For each new call an entry is added to the _Calls panel_.
188 1 Tijmen de Mes
189 1 Tijmen de Mes
When starting and audio call, the main interface switches from the Contacts list to the Calls panel. You can toggle between the two panels by using the button presented on the top of the main interface. The number of active calls sessions is presented at the bottom of the Contacts list.
190 1 Tijmen de Mes
191 21 Tijmen de Mes
To switch between multiple calls just click on another call in the _Calls panel_. When switching to a particular call, the audio stream is connected to the input and output device and all other audio calls are put on hold.
192 1 Tijmen de Mes
193 1 Tijmen de Mes
To mute your microphone click on the bottom right microphone icon. To un-mute click it again.
194 1 Tijmen de Mes
195 1 Tijmen de Mes
The shortcut key for hold is Control+Space.
196 1 Tijmen de Mes
197 1 Tijmen de Mes
The shortcut key for hangup is Control+ESC (Linux only).
198 1 Tijmen de Mes
199 1 Tijmen de Mes
The shortcut key for redial is Control+R.
200 1 Tijmen de Mes
201 1 Tijmen de Mes
h3. DTMF
202 1 Tijmen de Mes
203 1 Tijmen de Mes
Dial tones are used to interact with PBX and IVR systems or legacy PSTN gateways. To send DTMF tones, focus the Audio Call by clicking on it. The current call is already focused if you just started it. What you then type on the keyboard is automatically translated into DTMF tones. Alpha-numeric keys are translated into numeric DTMF keys as they are on a numeric telephone keypad.
204 1 Tijmen de Mes
205 1 Tijmen de Mes
h3. Hangup
206 1 Tijmen de Mes
207 21 Tijmen de Mes
To hangup, click on the _Red handset_ displayed for each audio call in the right hand side of the Calls panel.
208 1 Tijmen de Mes
209 1 Tijmen de Mes
h3. Call Recording
210 1 Tijmen de Mes
211 21 Tijmen de Mes
To record an audio call click on the _Black circle_. While recording, the circle will toggle between red and black. Recordings are stored as .wav files in the following locations:
212 1 Tijmen de Mes
213 21 Tijmen de Mes
 * Linux: ~/.blink/recordings/
214 21 Tijmen de Mes
 * Windows XP: C:\Documents and Settings\Username\Application Data\Blink\recordings\
215 21 Tijmen de Mes
 * Windows Vista and 7: C:\Users\Username\AppData\Roaming\Blink\recordings\
216 1 Tijmen de Mes
217 1 Tijmen de Mes
h3. Calling to PSTN
218 1 Tijmen de Mes
219 21 Tijmen de Mes
To dial a telephone number, just enter a number in the _Search Bar_ followed by Return key.
220 1 Tijmen de Mes
221 1 Tijmen de Mes
When dialing numbers by selecting entries from the Google Contacts it is recommended that you store your numbers in international E.164 format (that is + followed by the number).
222 1 Tijmen de Mes
223 21 Tijmen de Mes
If you have created a SIP Account with Blink, you can call to PSTN numbers if you have a positive credit. You can use a Credit Card to add _Credit_ to your account in menu _Tools -> Buy prepaid credit_.... You may request the assignment of a PSTN Caller Id by sending an request to the support email address. Recognized number formats are _<notextile>+</notextile>_ or _00_ followed by the _Country Code_ and then _Subscriber Number_.
224 1 Tijmen de Mes
225 1 Tijmen de Mes
If you use another SIP Account than the one provided by Blink, access to the PSTN is subject to the support provided by your SIP service provider. The number format depends as well on the conventions imposed by the SIP service provider in question.
226 1 Tijmen de Mes
227 21 Tijmen de Mes
When dialing telephone numbers, you can replace the + prefix or add an optional prefix with your own values by editing the section _Blink -> Accounts -> Manage accounts -> Advanced_.
228 1 Tijmen de Mes
229 1 Tijmen de Mes
h3. Audio Conference
230 1 Tijmen de Mes
231 21 Tijmen de Mes
Drag and drop audio calls on top of each other to create a Conference or use the button presented at the botton at the _Calls panel_ to start a _Conference_ with all active audio calls.
232 1 Tijmen de Mes
233 21 Tijmen de Mes
Add new participants to a Conference by dragging Contacts from the _Contacts list_ onto add the green area highlighed on top of the Contacts list.
234 1 Tijmen de Mes
235 1 Tijmen de Mes
Each participant can be muted individually by pressing on the microphone symbol that appears on each conferenced session.
236 1 Tijmen de Mes
237 21 Tijmen de Mes
To end an _Audio Conference_ drag the calls out of the conference area or press the _Conference_ button again.
238 1 Tijmen de Mes
239 21 Tijmen de Mes
There can be multiple active _Audio Conferences_ at any given time, you can use drag and drop to group calls together in different conferences.
240 1 Tijmen de Mes
241 1 Tijmen de Mes
h2. Preferences
242 1 Tijmen de Mes
243 22 Tijmen de Mes
!>BlinkQTScreenshot-Preferences.jpg! 
244 1 Tijmen de Mes
245 1 Tijmen de Mes
To edit Blink general preferences and manage the SIP accounts, open menu Blink -> Preferences.
246 1 Tijmen de Mes
247 1 Tijmen de Mes
The Preferences are split in Accounts, Audio, Chat, File Transfer, Alerts, Logging and Advanced. Each SIP account has its own set of properties.