~ubuntu-branches/ubuntu/wily/smplayer/wily

1.2.3 by Maia Kozheva
Import upstream version 0.6.8
1
Since 0.6.8 it's possible to watch the TV in smplayer (dvb:// and tv://).
2
3
This document provides some info about how to do it.
4
5
INTRO:
6
7
smplayer doesn't include any option to scan for channels, so mplayer must be 
8
configured to tune to TV channels.
9
10
That means that the following:
11
12
mplayer dvb://
13
or
14
mplayer tv://
15
16
should work (should display a TV channel).
17
18
And the following should tune to the specified channel:
19
20
mplayer dvb://Channel_name
21
or
22
mplayer tv://Channel_name
23
24
25
DVB:
26
27
The support for dvb in smplayer is intented for dvb-t (terrestrial). It can 
28
work with dvb-c and dvb-s (cable and satellite) but it hasn't been tested.
29
30
smplayer will look for the file ~/.mplayer/channels.conf.ter (or 
31
~/.mplayer/channels.conf if that doesn't exist), and the menus Open->TV and 
32
Open->Radio will be populated with the channels there (the menu Open->Radio 
33
will show the channels without video pid. Notice that for dvb-s and dvb-c the 
34
check for audio and video pids will probably fail and all channels will end up 
35
in the TV menu).
36
37
If you don't have a ~/.mplayer/channels.conf you can create with scan (in
38
ubuntu is in the dvb-apps package):
39
40
scan initial_file > ~/.mplayer/channels.conf 
41
42
The initial_file contains info about the frequencies that have to be scanned,
43
you'll find a lot in /usr/share/dvb/dvb-t/ (use the one for your town).
44
45
You can also use w_scan, which doesn't require any initial file.
46
47
48
TV:
49
50
The support for analog TV (tv://) in smplayer is very basic  (it can recognize
51
a tv:// stream as being a TV channel, but that's all) and configuration
52
has to be done manually.
53
54
First you need some lines in your ~/.mplayer/config with the TV configuration
55
(driver, norms, frequencies...). Example:
56
57
tv=driver=v4l:input=0:width=768:height=576:device=/dev/video0:audiorate=48000:n
58
orm=PAL:chanlist=europe-west:channels=46-TV_1,43-TV_2,50-TV_3,53-TV_4
59
60
For more info take a look at the mplayer manpage.
61
62
After that you have to introduce all channels in smplayer (Open->TV->Edit).
63
64
65
THE CHANNEL EDITOR:
66
67
The channel editor allows you to add, modify and remove TV channels. You'll
68
see a table with all channels. Each channel contains 3 fields: icon, name
69
and stream. The name will appear in the menu, the stream is what mplayer will
70
open to tune the channel. Examples:
71
72
ICON   NAME          STREAM
73
       CNN           dvb://CNN
74
       BBC           tv://TV_1
75
       Webcam        tv://
76
77
The list of TV channels is saved to ~/.config/smplayer/tv.m3u8, while the
78
list of radio is saved to ~/.config/smplayer/radio.m3u8.
79
80
Note 1: by default smplayer will scan the file ~/.mplayer/channels.conf on every
81
startup and will add the new channels it finds there. That means that if you
82
delete dvb channels from the editor they will appear again in the next session
83
(smplayer will think they are new). To avoid that, there's an option in 
84
Preferences->TV to disable the scanning of the channels.conf file.
85
86
Note 2: it's possible to set an icon for each channel. The icon will be 
87
displayed in the menus. Currently it's possible to set an icon, change it
88
but there's now way to remove it... (unless you edit manually the *.m3u8 files)
89
90
Note 3: the tv and radio lists can be "misused" as favorite lists, you can
91
enter any other kind of media (internet streams, local files...) not only tv
92
channels.
93
94
95
OPTIONS FOR TV
96
97
Some options have been added for TV:
98
99
 * there's a new section for TV in Preferences, which allows for instance to
100
   set the default deinterlacer to be use with TV channels.
101
 * it's possible to set a cache for TV in Preferences -> Performance -> Cache
102
103
104
REMEMBERING THE TV SETTINGS
105
106
One nice thing: the settings of TV channels are remembered. That means that
107
filters, options (like zoom) and so on will be remembered when you tune that
108
channel again.
109
110
111
(ADVANCED) ADDITIONAL AUDIO TRACKS IN DVB CHANNELS
112
113
You'll notice that when you tune a dvb channel only the first audio track is
114
available. To fix the problem you need to add manually the additional audio pids
115
to channels.conf.
116
117
For instance, take a look at this line taken from ~/.mplayer/channels.conf:
118
119
ANTENA.NEOX:858000000:INVERSION_AUTO:BANDWIDTH_8_MHZ:FEC_2_3:FEC_2_3:QAM_64:TRANSMISSION_MODE_8K:GUARD_INTERVAL_1_4:HIERARCHY_NONE:501:503:141
120
121
Let's see the 3 last fields:
122
501:503:141
123
124
501 is the video pid, 503 is the audio pid (and 141 I think is the teletext pid)
125
Several audio pids can be added separated by "+". For instance:
126
127
501:503+504:141
128
129
This way the 2nd audio track (504) will be available when you watch that channel
130
in smplayer. Notice that to be able to actually switch audio tracks in dvb 
131
channels you need a recent version of mplayer (r29381).