DOCS/xml/en/radio.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <!-- $Revision$ -->
   3 <chapter id="radio">
   4 <title>Radio</title>
   5
   6 <sect1 id="radio-input" xreflabel="Radio input">
   7 <title>Radio input</title>
   8
   9 <para>
  10 This section is about how to enable listening to radio from
  11 a V4L-compatible radio tuner. See the man page for a
  12 description of radio options and keyboard controls.
  13 </para>
  14
  15 <!-- ********** -->
  16
  17 <sect2 id="radio-compilation">
  18 <title>Compilation</title>
  19
  20 <procedure>
  21 <step><para>
  22   First, you have to recompile <application>MPlayer</application> using
  23   <filename>./configure</filename> with <option>--enable-radio</option> and
  24   (if you want capture support) <option>--enable-radio-capture</option>.
  25 </para></step>
  26 <step><para>
  27   Make sure your tuner works with another radio software in Linux, for
  28   example <application>XawTV</application>.
  29 </para></step>
  30 </procedure>
  31 </sect2>
  32
  33 <!-- ********** -->
  34
  35 <sect2 id="radio-tips">
  36 <title>Usage tips</title>
  37
  38 <para>
  39 The full listing of the options is available in the manual page.
  40 Here are just a few tips:
  41
  42 <itemizedlist>
  43 <listitem><para>
  44   Use the <option>channels</option> option. An example:
  45   <screen>-radio channels=104.4-Sibir,103.9-Maximum</screen>
  46   Explanation: With this option, only the 104.4 and 103.9 radio stations
  47   will be usable. There will be a nice OSD text upon channel switching,
  48   displaying the channel's name. Spaces in the channel name must be
  49   replaced by the "_" character.
  50 </para></listitem>
  51 <listitem><para>
  52   There are several ways of capturing audio. You can grab the sound either using
  53   your sound card via an external cable connection between video card and
  54   line-in, or using the built-in ADC in the saa7134 chip. In the latter case,
  55   you have to load the <systemitem>saa7134-alsa</systemitem> or
  56   <systemitem>saa7134-oss</systemitem> driver.
  57 </para></listitem>
  58 <listitem><para>
  59   <application>MEncoder</application> cannot be used for audio capture,
  60   because it requires a video stream to work. So your can either use
  61   <application>arecord</application> from ALSA project or
  62   use <option>-ao pcm:file=file.wav</option>. In the latter case you
  63   will not hear any sound (unless you are using a line-in cable and
  64   have switched line-in mute off).
  65 </para></listitem>
  66 </itemizedlist>
  67 </para>
  68 </sect2>
  69
  70 <!-- ********** -->
  71
  72 <sect2 id="radio-examples">
  73 <title>Examples</title>
  74
  75 <informalexample><para>
  76 Input from standard V4L (using line-in cable, capture switched off):
  77 <screen>mplayer radio://104.4</screen>
  78 </para></informalexample>
  79
  80 <informalexample><para>
  81 Input from standard V4L (using line-in cable, capture switched off,
  82 V4Lv1 interface):
  83 <screen>mplayer -radio driver=v4l radio://104.4</screen>
  84 </para></informalexample>
  85
  86 <informalexample><para>
  87 Playing second channel from channel list:
  88 <screen>mplayer -radio channels=104.4=Sibir,103.9=Maximm radio://2</screen>
  89 </para></informalexample>
  90
  91 <informalexample>
  92 <para>
  93 Passing sound over the PCI bus from the radio card's internal ADC.
  94 In this example the tuner is used as a second sound card
  95 (ALSA device hw:1,0). For saa7134-based cards either the
  96 <systemitem>saa7134-alsa</systemitem> or <systemitem>saa7134-oss</systemitem>
  97 module must be loaded.
  98 <screen>
  99 mplayer -rawaudio rate=32000 radio://2/capture \
 100     -radio adevice=hw=1.0:arate=32000:channels=104.4=Sibir,103.9=Maximm
 101 </screen>
 102 <note><para>
 103 When using ALSA device names colons must be replaced
 104 by equal signs, commas by periods.
 105 </para></note>
 106 </para>
 107 </informalexample>
 108 </sect2>
 109 </sect1>
 110
 111 </chapter>