mpv/DOCS/xml/en/radio.xml

112 lines
3.4 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<chapter id="radio">
<title>Radio</title>
<sect1 id="radio-input" xreflabel="Radio input">
<title>Radio input</title>
<para>
This section is about how to enable listening to radio from
a V4L-compatible radio tuner. See the man page for a
description of radio options and keyboard controls.
</para>
<!-- ********** -->
<sect2 id="radio-compilation">
<title>Compilation</title>
<procedure>
<step><para>
First, you have to recompile <application>MPlayer</application> using
<filename>./configure</filename> with <option>--enable-radio</option> and
(if you want capture support) <option>--enable-radio-capture</option>.
</para></step>
<step><para>
Make sure your tuner works with another radio software in Linux, for
example <application>XawTV</application>.
</para></step>
</procedure>
</sect2>
<!-- ********** -->
<sect2 id="radio-tips">
<title>Usage tips</title>
<para>
The full listing of the options is available in the manual page.
Here are just a few tips:
<itemizedlist>
<listitem><para>
Use the <option>channels</option> option. An example:
<screen>-radio channels=104.4-Sibir,103.9-Maximum</screen>
Explanation: With this option, only the 104.4 and 103.9 radio stations
will be usable. There will be a nice OSD text upon channel switching,
displaying the channel's name. Spaces in the channel name must be
replaced by the "_" character.
</para></listitem>
<listitem><para>
There are several ways of capturing audio. You can grab the sound either using
your sound card via an external cable connection between video card and
line-in, or using the built-in ADC in the saa7134 chip. In the latter case,
you have to load the <systemitem>saa7134-alsa</systemitem> or
<systemitem>saa7134-oss</systemitem> driver.
</para></listitem>
<listitem><para>
<application>MEncoder</application> cannot be used for audio capture,
because it requires a video stream to work. So your can either use
<application>arecord</application> from ALSA project or
use <option>-ao pcm:file=file.wav</option>. In the latter case you
will not hear any sound (unless you are using a line-in cable and
have switched line-in mute off).
</para></listitem>
</itemizedlist>
</para>
</sect2>
<!-- ********** -->
<sect2 id="radio-examples">
<title>Examples</title>
<informalexample><para>
Input from standard V4L (using line-in cable, capture switched off):
<screen>mplayer radio://104.4</screen>
</para></informalexample>
<informalexample><para>
Input from standard V4L (using line-in cable, capture switched off,
V4Lv1 interface):
<screen>mplayer -radio driver=v4l radio://104.4</screen>
</para></informalexample>
<informalexample><para>
Playing second channel from channel list:
<screen>mplayer -radio channels=104.4=Sibir,103.9=Maximm radio://2</screen>
</para></informalexample>
<informalexample>
<para>
Passing sound over the PCI bus from the radio card's internal ADC.
In this example the tuner is used as a second sound card
(ALSA device hw:1,0). For saa7134-based cards either the
<systemitem>saa7134-alsa</systemitem> or <systemitem>saa7134-oss</systemitem>
module must be loaded.
<screen>
mplayer -rawaudio rate=32000 radio://2/capture \
-radio adevice=hw=1.0:arate=32000:channels=104.4=Sibir,103.9=Maximm
</screen>
<note><para>
When using ALSA device names colons must be replaced
by equal signs, commas by periods.
</para></note>
</para>
</informalexample>
</sect2>
</sect1>
</chapter>