configs/oss.conf.sample

   1 ;
   2 ; Automatically generated from ../channels/chan_oss.c
   3 ;
   4
   5 [general]
   6     ; General config options, with default values shown.
   7     ; You should use one section per device, with [general] being used
   8     ; for the first device and also as a template for other devices.
   9     ;
  10     ; All but 'debug' can go also in the device-specific sections.
  11     ;
  12     ; debug = 0x0               ; misc debug flags, default is 0
  13
  14     ; Set the device to use for I/O
  15     ; device = /dev/dsp
  16
  17     ; Optional mixer command to run upon startup (e.g. to set
  18     ; volume levels, mutes, etc.
  19     ; mixer =
  20
  21     ; Software mic volume booster (or attenuator), useful for sound
  22     ; cards or microphones with poor sensitivity. The volume level
  23     ; is in dB, ranging from -20.0 to +20.0
  24     ; boost = n                 ; mic volume boost in dB
  25
  26     ; Set the callerid for outgoing calls
  27     ; callerid = John Doe <555-1234>
  28
  29     ; autoanswer = no           ; no autoanswer on call
  30     ; autohangup = yes          ; hangup when other party closes
  31     ; extension = s             ; default extension to call
  32     ; context = default         ; default context for outgoing calls
  33     ; language = ""             ; default language
  34
  35     ; If you set overridecontext to 'yes', then the whole dial string
  36     ; will be interpreted as an extension, which is extremely useful
  37     ; to dial SIP, IAX and other extensions which use the '@' character.
  38     ; The default is 'no' just for backward compatibility, but the
  39     ; suggestion is to change it.
  40     ; overridecontext = no      ; if 'no', the last @ will start the context
  41                                 ; if 'yes' the whole string is an extension.
  42
  43     ; low level device parameters in case you have problems with the
  44     ; device driver on your operating system. You should not touch these
  45     ; unless you know what you are doing.
  46     ; queuesize = 10            ; frames in device driver
  47     ; frags = 8                 ; argument to SETFRAGMENT
  48
  49     ;------------------------------ JITTER BUFFER CONFIGURATION --------------------------
  50     ; jbenable = yes              ; Enables the use of a jitterbuffer on the receiving side of an
  51                                   ; OSS channel. Defaults to "no". An enabled jitterbuffer will
  52                                   ; be used only if the sending side can create and the receiving
  53                                   ; side can not accept jitter. The OSS channel can't accept jitter,
  54                                   ; thus an enabled jitterbuffer on the receive OSS side will always
  55                                   ; be used if the sending side can create jitter.
  56
  57     ; jbmaxsize = 200             ; Max length of the jitterbuffer in milliseconds.
  58
  59     ; jbresyncthreshold = 1000    ; Jump in the frame timestamps over which the jitterbuffer is
  60                                   ; resynchronized. Useful to improve the quality of the voice, with
  61                                   ; big jumps in/broken timestamps, usually sent from exotic devices
  62                                   ; and programs. Defaults to 1000.
  63
  64     ; jbimpl = fixed              ; Jitterbuffer implementation, used on the receiving side of an OSS
  65                                   ; channel. Two implementations are currently available - "fixed"
  66                                   ; (with size always equals to jbmax-size) and "adaptive" (with
  67                                   ; variable size, actually the new jb of IAX2). Defaults to fixed.
  68
  69     ; jblog = no                  ; Enables jitterbuffer frame logging. Defaults to "no".
  70     ;-----------------------------------------------------------------------------------
  71
  72 ; below is an entry for a second console channel
  73 ; [card1]
  74     ; device = /dev/dsp1        ; alternate device
  75
  76 ; Below are the settings to support video. You can include them
  77 ; in your general configuration as [general](+,video)
  78 ; The parameters are all available through the CLI as "console name value"
  79 ; Section names used here are only examples.
  80
  81 [my_video](!)      ; you can just include in your config
  82     videodevice = /dev/video0   ; uses your V4L webcam as video source
  83     videodevice = X11           ; X11 grabber. Dragging on the local display moves the origin.
  84     videocodec = h263           ; also h261, h263p, h264, mpeg4, ...
  85
  86     ; video_size is the geometry used by the encoder.
  87     ; Depending on the codec your choice is restricted.
  88     video_size = 352x288        ; the format WIDTHxHEIGHT is also ok
  89     video_size = cif            ; sqcif, qcif, cif, qvga, vga, ...
  90
  91     ; You can also set the geometry used for the camera, local display and remote display.
  92     ; The local window is on the right, the remote window is on the left.
  93     ; Right clicking with the mouse on a video window increases the size,
  94     ; center-clicking reduces the size.
  95     camera_size = cif
  96     remote_size = cif
  97     local_size = qcif
  98
  99     bitrate = 60000             ; rate told to ffmpeg.
 100     fps = 5                     ; frames per second from the source.
 101     ; qmin = 3                  ; quantizer value passed to the encoder.
 102
 103 ; The keypad is made of an image (in any format supported by SDL_image)
 104 ; and some configuration entries indicating the location and function of buttons.
 105 ; These entries can also be contained in the comment field of the image,
 106 ; which is a lot more convenient to manage.
 107 ; E.g. for jpeg you can write them with wrjpgcom (part of libjpeg).
 108 ; The format to define keys is
 109 ;       region = <event> <shape> x0 y0 x1 y1 h
 110 ; where <event> is the event to be generated (a digit, pickup, hangup,...)
 111 ; <shape> is the shape of the region (currently 'rect' and 'circle' are
 112 ; supported, the latter is really an ellipse),  x0 y0 x1 y1 are the
 113 ; coordinates of the base of the rectangle or main diameter of the ellipse,
 114 ; (they can be rotated) while h is the height of the rectangle or the other
 115 ; diameter of the ellipse.
 116 ;
 117 [my_skin](!)
 118     keypad = /tmp/keypad.jpg
 119     region = 1 rect   19  18    67  18  28
 120     region = 2 rect   84  18   133  18  28
 121     region = 3 rect  152  18   201  18  28
 122     region = 4 rect   19  60    67  60  28
 123     region = 5 rect   84  60   133  60  28
 124     region = 6 rect  152  60   201  60  28
 125     region = 7 rect   19 103    67 103  28
 126     region = 8 rect   84 103   133 103  28
 127     region = 9 rect  152 103   201 103  28
 128     region = * rect   19 146    67 146  28
 129     region = 0 rect   84 146   133 146  28
 130     region = # rect  152 146   201 146  28
 131     region = pickup rect  229 15  267 15 40
 132     region = hangup rect  230 66  270 64 40
 133     region = mute circle  232 141 264 141 33
 134     region = sendvideo circle  235 185 266 185 33
 135     region = autoanswer rect 228 212 275 212 50
 136
 137 ; another skin with entries for the keypad and a small font
 138 ; to write to the message boards in the skin.
 139 [skin2](!)
 140     keypad = /tmp/kpad2.jpg
 141     keypad_font = /tmp/font.png
 142
 143 ; to add video support, uncomment this and remember to install
 144 ; the keypad and keypad_font files to the right place
 145 ; [general](+,my_video,skin2)
 146