1seren(1)                    General Commands Manual                   seren(1)
2
3
4

NAME

6       Seren - A simple VoIP program to create conferences from the terminal
7

SYNOPSIS

9       seren [option...]
10

DESCRIPTION

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

OPTIONS

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

FILES

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

AUTHOR

104       Written by Giorgio Vazzana <mywing81@gmail.com>.
105
106
107
108                                 December 2014                        seren(1)
Impressum