summaryrefslogtreecommitdiffstats
path: root/data/twinkle.1
blob: 8393089fc0b19d96ecf0775c2007a9feb9395787 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.2.
.TH TWINKLE "1" "January 2016" "Twinkle 1.10.0 - 15 July 2016" "User Commands"
.SH NAME
Twinkle \- Twinkle 1.10.0
.SH SYNOPSIS
.B twinkle
[\fI\,options\/\fR]
.SH OPTIONS
.TP
\fB\-c\fR
Run in command line interface (CLI) mode
.TP
\fB\-\-share\fR <dir>
Set the share directory.
.TP
\fB\-f\fR <profile>
Startup with a specific profile. You will not be requested
to choose a profile at startup. The profiles that you created
are the .cfg files in your .twinkle directory.
You may specify multiple profiles separated by spaces.
.TP
\fB\-\-force\fR
If a lock file is detected at startup, then override it
and startup.
.HP
\fB\-\-sip\-port\fR <port>
.IP
Port for SIP signalling.
This port overrides the port from the system settings.
.HP
\fB\-\-rtp\-port\fR <port>
.IP
Port for RTP.
This port overrides the port from the system settings.
.HP
\fB\-\-call\fR <address>
.IP
Instruct Twinkle to call the address.
When Twinkle is already running, this will instruct the running
process to call the address.
The address may be a full or partial SIP URI. A partial SIP URI
will be completed with the information from the user profile.
.IP
A subject may be passed by appending '?subject=<subject>'
to the address.
.IP
Examples:
twinkle \fB\-\-call\fR 123456
twinkle \fB\-\-call\fR sip:example@example.com?subject=hello
.HP
\fB\-\-cmd\fR <cli command>
.IP
Instruct Twinkle to execute the CLI command. You can run
all commands from the command line interface mode.
When Twinkle is already running, this will instruct the running
process to execute the CLI command.
.IP
Examples:
twinkle \fB\-\-cmd\fR answer
twinkle \fB\-\-cmd\fR mute
twinkle \fB\-\-cmd\fR 'transfer 12345'
.TP
\fB\-\-immediate\fR
This option can be used in conjunction with \fB\-\-call\fR or \fB\-\-cmd\fR
It indicates the the command or call is to be performed
immediately without asking the user for any confirmation.
.HP
\fB\-\-set\-profile\fR <profile>
.IP
Make <profile> the active profile.
When using this option in conjunction with \fB\-\-call\fR and \fB\-\-cmd\fR,
then the profile is activated before executing \fB\-\-call\fR or
\fB\-\-cmd\fR.
.TP
\fB\-\-show\fR
Instruct a running instance of Twinkle to show the main window
and take focus.
.TP
\fB\-\-hide\fR
Instruct a running instance of Twinkle to hide in the system tray.
If no system tray is used, then Twinkle will minimize.
.HP
\fB\-\-help\-cli\fR [cli command]
.IP
Without a cli command this option lists all available CLI
commands. With a CLI command this option prints help on
the CLI command.
.TP
\fB\-\-version\fR
Get version information.
.SH COPYRIGHT
Copyright \(co 2005\-2015  Michel de Boer and contributors
http://twinkle.dolezel.info
.PP
Built with support for: ALSA, Speex, iLBC, ZRTP
.PP
Contributions:
* Werner Dittmann (ZRTP/SRTP)
* Bogdan Harjoc (AKAv1\-MD5, Service\-Route)
* Roman Imankulov (command line editing)
* Ondrej Moris (codec preprocessing)
* Rickard Petzall (ALSA)
.PP
This software contains the following software from 3rd parties:
* GSM codec from Jutta Degener and Carsten Bormann, University of Berlin
* G.711/G.726 codecs from Sun Microsystems (public domain)
* iLBC implementation from RFC 3951 (www.ilbcfreeware.org)
* Parts of the STUN project at http://sourceforge.net/projects/stun
* Parts of libsrv at http://libsrv.sourceforge.net/
.PP
For RTP the following dynamic libraries are linked:
* GNU ccRTP \- http://www.gnu.org/software/ccrtp
* GNU uCommon C++ \- http://www.gnutelephony.org/index.php/Category:Software
.PP
Twinkle comes with ABSOLUTELY NO WARRANTY.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.SH "SEE ALSO"
The full documentation for
.B Twinkle
is maintained as a Texinfo manual.  If the
.B info
and
.B Twinkle
programs are properly installed at your site, the command
.IP
.B info Twinkle
.PP
should give you access to the complete manual.