1seren(1) General Commands Manual seren(1)
2
3
4
6 Seren - A simple VoIP program to create conferences from the terminal
7
9 seren [option...]
10
12 Seren is a simple VoIP program based on the Opus codec that allows you
13 to create a voice conference from the terminal, with up to 10 partici‐
14 pants, without having to register accounts, exchange emails, or add
15 people to contact lists. All you need to join an existing conference is
16 the host name or IP address of one of the participants. Seren creates
17 a dynamic peer-to-peer network of equivalent nodes which exchange text
18 and audio data using a udp connection, and offers the user the ability
19 to change the quality/bitrate on the fly, encrypt the traffic and
20 record the calls.
21
22 This manual page documents briefly the seren command. Please refer to
23 the README file to get more information on how to use Seren.
24
26 A summary of command line options is included below.
27
28 -h Print help, showing a list of available command line options.
29 The values in parentheses on the right are the default values.
30
31 -v Increment verbosity level. -v enables verbose messages and -v
32 -v enables verbose and debug messages.
33
34 -L logfile
35 Send log messages to logfile (default: $HOME/.seren/seren.log)
36
37 -N Disable ncurses interface and run Seren as a pure command line
38 application.
39
40 -t theme
41 Set ncurses theme: 0-simple, 1-dark, 2-clear (default: 1).
42
43 -n nick
44 Set nickname (default: login name).
45
46 -p port
47 Set udp listening port (default: 8110).
48
49 -b bitrate
50 Set Opus encoding bitrate in bit/s (default: 16000).
51
52 -C complexity
53 Set Opus encoding complexity. The supported range is 0-10 inclu‐
54 sive with 10 representing the highest complexity. Small values
55 will make Seren run faster, at the expense of quality. You may
56 want to lower this value if you are on a embedded system like
57 the Raspberry Pi or if you notice that Seren is using up all
58 your cpu time (default: 10).
59
60 -d audiodev
61 Set alsa playback audio device. If you get an error with the
62 device hw:0,0 try prepending plug to the device name, es.
63 plughw:0,0. If your system has pulseaudio installed, it should
64 be possible to specify 'pulse' to use it. (default: depends on
65 how Seren was configured, see the output of -h option).
66
67 -D audiodev
68 Set alsa capture audio device. Useful if you want to use two
69 different audio devices for playback and capture. (default:
70 same value specified for playback device)
71
72 -c host[:port]
73 Automatically call the specified host on startup.
74
75 -a Autoaccept calls. If this options is enabled Seren will accept
76 every incoming call without asking the user first.
77
78 -S Disable STUN to retrieve the external IP address.
79
81 $HOME/.seren/seren.log
82 Log file.
83
84 $HOME/.seren/seren.conf
85 Configuration file.
86
87 $HOME/.seren/history
88 Command history file.
89
90 $HOME/.seren/fifo_in
91 Input fifo: accepts raw audio in 48000Hz/2ch/s16_le format. When
92 fifos are enabled (using the /f command), writing to this fifo
93 will make Seren mix this pcm audio signal with the one coming
94 from the sound card. Useful if you want to transmit pre-recorded
95 audio together with your own voice.
96
97 $HOME/.seren/fifo_out
98 Output fifo: provides raw audio in 48000Hz/2ch/s16_le format.
99 When fifos are enabled (using the /f command), reading from this
100 fifo will allow you to get the pcm audio signal of the confer‐
101 ence and pipe it to another process.
102
104 Written by Giorgio Vazzana <mywing81@gmail.com>.
105
106
107
108 December 2014 seren(1)