Syntax of channels.conf

From VDR Wiki

(Difference between revisions)
Jump to: navigation, search
(Links)
 
(27 intermediate revisions not shown)
Line 1: Line 1:
-
=Parameters of VDR channel config file=
+
==Parameters of VDR channel config file==
-
 
+
Note that older versions of VDR (e.g 1.2.x) use a slightly different format of this file, and switching between vdr 1.2.x and vdr 1.3.x with the same channel file can lead to problems, see below under Differences.
-
In this example below there are three different channels definitions: the first is an example for satellite, the second is terrestrian dvb, the third is an channel definition for the analogTV plugin.
+
In the example below there are three different channel definitions:  
-
{| border=1 cellpadding=5 cellspacing=0
+
* digital satellite TV channel
-
|- bgcolor=#efefef
+
* digital terrestrian TV channel
-
!Name
+
* digital cable TV channel
-
!Frequenz
+
* analog TV channel
-
!Parameter
+
{| width="100%" class="wikitable"
-
!Quelle
+
|-
-
!SRate
+
! [[#Name|Name]]
-
!VPID
+
! [[#Frequency|Frequency]]
-
!APID
+
! [[#Parameters|Parameters]]
-
!TPID
+
! [[#Source|Source]]
-
!CA
+
! [[#SRate|SRate]]
-
!SID
+
! [[#VPID|VPID]]
-
!NID
+
! [[#APID|APID]]
-
!TID
+
! [[#TPID|TPID]]
-
!RID
+
! [[#CA_-_Conditional_access|CA]]
 +
! [[#SID|SID]]
 +
! [[#NID|NID]]
 +
! [[#TID|TID]]
 +
! [[#RID|RID]]
 +
|-
 +
| RTL || 12188 || h || S19.2E || 27500 || 163 || 104 || 105 || 0 || 12003 || 0 || 0 || 0
 +
|-
 +
| Das Erste || 522000 || I0C23D0M16B8T8G8Y0 || T || 27500 || 1401 || 1402 || 1404 || 1 || 14 || 0 || 0 || 0
|-
|-
-
|RTL<br>Das Erste<br>VHF K10
+
| FS HH || 402000 || C0M64 || C || 6900 || 2401 || 2402 || 2404 || 0 || 28225 || 1 || 1073 || 16387
-
|12188<br>522000<br>210250
+
-
|h<br>I0C23D0M16B8T8G8Y0<br>C0D45B6
+
-
|S19.2E<br>T<br>C
+
-
|27500<br>27500<br>0
+
-
|163<br>1401<br>301
+
-
|104<br>1402<br>300
+
-
|105<br>1404<br>0
+
-
|0<br>1<br>A0
+
-
|12003<br>14<br>28106
+
-
|0<br>0<br>0
+
-
|0<br>0<br>0
+
-
|0<br>0<br>0
+
|-
|-
 +
| VHF K10 || 210250 || C0D45B6 || C || 0 || 301 || 300 || 0 || A0 || 28106 || 0 || 0 || 0
|}
|}
-
The VDR reads at startup all channel definitions from the config file ($CONFIGDIR/vdr/channels.conf) and writes any changig onto that file back.
+
The [[VDR]] reads at startup all channel definitions from the config file '''$CONFIGDIR/vdr/channels.conf''' and writes any changing back to the file.
-
''Changings on channels.conf are useless if VDR is running, VDR has to be stopped if you want to edit this file!''<BR>
+
{{Box Info|
-
The meaning of the 13 fields:
+
Changes to channels.conf while VDR is running will be overwritten. VDR has to be stopped if you want to edit this file!
 +
}}
-
==Name==
+
===Name===
-
Name of that channel. If the name enthält includs a ":" it will be automatically replaced by "|".
+
Name of that channel. If the name includes a ":" it will be automatically replaced by "|".
-
If you use VDR-1.2.x please do NOT include komma or semikolon. Starting at VDR version 1.3.12 this field also includes the service providers name(aka "bouquet"), separated by semikolon.
+
If you use VDR version 1.2.x please do NOT include commas or semicolons. Starting with VDR version 1.3.12 this field also includes the service providers name(aka "bouquet"), separated by a semikolon.
-
==Frequency==
+
===Frequency===
-
Transponder Frequency as Integer. <BR>
+
Transponder Frequency as Integer
-
DVB-S:           Frequency in MHz. <BR>
+
;DVB-S : Frequency in MHz.
-
DVB-C:           Frequency in MHz, kHz or Hz. <BR>
+
;DVB-C : Frequency in MHz, kHz or Hz.
-
DVB-T:           Frequency in MHz, kHz or Hz. <BR>
+
;DVB-T : Frequency in MHz, kHz or Hz.
-
analogue TV:     Frequency in MHz. (analogTV plugin)<BR>
+
;analogue TV : Frequency in MHz. (analogTV plugin)
-
The value here will be multiplied by 1000 until it's bigger than 1000000.
+
The values here will be multiplied by 1000 until it's bigger than 1000000.
-
==Parameters==
+
===Parameters===
-
The Parameters in this field depends on the type of DVB you use: [[DVB-S]], [[DVB-C]] ,[[DVB-T]] or analogue TV. <BR>
+
The Parameters in this field depends on the type of DVB you use: [[DVB-S]], [[DVB-C]] ,[[DVB-T]] or analogue TV.
-
Each Parameter starts with an letter, followed by an Integer which represends the value of that parameter. <BR>
+
Each Parameter starts with an letter, followed by an Integer which represends the value of that parameter.  
-
valid identifiers and their ranges:
+
-
'''Identifier  Value  Meaning''' <BR>
+
Valid identifiers and their ranges:
-
'''I'''       (0, 1)         Inversion <BR>
+
'''Identifier  (Values)    Meaning'''
-
'''C''' (0, 12, 23, 34, 45, 56, 67, 78, 89) Data rate high priority <BR>
+
'''I'''        (0, 1)        Inversion (for DVB-T should always be 0, except some cards that need 999 (auto), such as Hauppauge NOVA-T USB2)
 +
 
 +
'''C''' (0, 12, 23, 34, 45, 56, 67, 78, 89) Data rate high priority
  for analogue TV is C the capture device:
  for analogue TV is C the capture device:
  C0  = /dev/video0
  C0  = /dev/video0
Line 67: Line 66:
  C45 = /dev/video4
  C45 = /dev/video4
-
'''D''' (0, 12, 23, 34, 45, 56, 67, 78, 89) Data rate low priority <BR>
+
'''D''' (0, 12, 23, 34, 45, 56, 67, 78, 89) Data rate low priority
  for analogue TV is D the video source used:
  for analogue TV is D the video source used:
-
  D0  = Television
+
  D0  = Television       (bttv)
-
  D12 = Composite1
+
  D12 = Composite Video1 (bttv)
-
  D23 = Composite2
+
  D23 = Composite Video2 (bttv)
-
  D34 = S-Video
+
  D34 = S-Video         (bttv)
-
  D0  = S-Video ext.    (Hauppauge PVR250/350-cards only)
+
  D0  = S-Video ext.    (Hauppauge PVR150/PVR250/350-cards only)
 +
D45 = Composite Video  (Hauppauge PVR150-cards only)
  D45 = Tuner 0          (Hauppauge PVR250/350-cards only)
  D45 = Tuner 0          (Hauppauge PVR250/350-cards only)
  D56 = Composite ext.  (Hauppauge PVR250/350-cards only)
  D56 = Composite ext.  (Hauppauge PVR250/350-cards only)
 +
D67 = TV Tuner        (Hauppauge PVR150-Karten only)
 +
'''M''' (0, 16, 32, 64, 128, 256) Modulation
-
'''M''' (0, 16, 32, 64, 128, 256) Modulation <BR>
+
'''B''' (6, 7, 8) Bandwidth in MHz
-
 
+
-
'''B''' (6, 7, 8) Bandwidth in MHz <BR>
+
  for analogue TV is B the Video norm:
  for analogue TV is B the Video norm:
  B6 = PAL
  B6 = PAL
  B7 = NTSC
  B7 = NTSC
-
  B8 = SECAM </pre>
+
  B8 = SECAM
-
'''T''' (2, 8) Transmission mode <BR>
+
'''T''' (2, 8) Transmission mode
-
'''G''' (4, 8, 16, 32) Guard intervall <BR>
+
'''G''' (4, 8, 16, 32) Guard intervall
-
'''Y''' (0, 1, 2, 4) Hierarchy <BR>
+
'''Y''' (0, 1, 2, 4) Hierarchy
-
'''H''' Horizontal Polarization <BR>
+
'''H''' Horizontal Polarization
-
'''V''' Vertical Polarization <BR>
+
'''V''' Vertical Polarization
-
The Polarisation Parameter is *not* followed by an value for compatibility reasons.<BR>
+
'''R'''  Circular Polarization right
-
The values "999" is used for automatic. If possible the driver will find the best settings. <BR>
+
'''L''' Circular Polarization left
-
Example for dvb-t:
+
The Polarisation Parameter is NOT followed by an value for compatibility reasons.
-
'''I'''0'''C'''23'''D'''0'''M'''16'''B'''8'''T'''8'''G'''8'''Y'''0
+
-
Inversion off, Data Rate High=23, Data Rate High=0, QAM16, Bandwidth 8MHz,
+
-
Transmission Mode 8, Guard 1/8, Hierarchy 0
+
-
==Source==
+
The value ''999'' is used for automatic. If possible the driver will find the best settings, this is default.
-
Signal source ot that channel, as defined in [[sources.conf]].
+
 
-
Sxxxx, C, T
+
Example for DVB-T:
 +
 
 +
'''I'''0'''C'''23'''D'''0'''M'''16'''B'''8'''T'''8'''G'''8'''Y'''0
 +
Inversion off,
 +
Data Rate High=23,
 +
Data Rate Low=0,
 +
QAM16,
 +
Bandwidth 8MHz,
 +
Transmission Mode 8,
 +
Guard 1/8,
 +
Hierarchy 0
 +
 
 +
===Source===
 +
Signal source of the channel, as defined in [[sources.conf]].
 +
Sxxxx, C, T
For compatbility reasons numeric values are accepted here, but preferred are literals.
For compatbility reasons numeric values are accepted here, but preferred are literals.
-
==Symbol Rate==
+
===Symbol Rate===
Symbol Rate of the channel. Valid only for DVB-S and DVB-C, as DVB-T uses another modulation COFDM (Coded Orthogonal Frequency Division Multiplex).
Symbol Rate of the channel. Valid only for DVB-S and DVB-C, as DVB-T uses another modulation COFDM (Coded Orthogonal Frequency Division Multiplex).
-
==VPID==
+
===VPID===
-
Video PID (Program Identification). <BR>
+
Video PID (Program Identification).
-
0 for Radio channels <BR>
+
* 0 for Radio channels
-
1 for encryted channels (pay tv) <BR>
+
* 1 for encryted channels (pay tv)
-
If that channel uses an separate PCR PID this PCR PID follows the Video PID, separated by "+"<BR>
+
If that channel uses a separate PCR PID this PCR PID follows the Video PID, separated by "+" (e.g. ...:164+17:...)
-
(i.e. ...:164+17:...)
+
-
Für analogue TV: mostly 301 or 160 (older versions)
+
-
==APID==
+
For analogue TV: mostly 301(ivtv > 0.1.9) or 160(ivtv <= 0.1.9, bttv)
-
Audio PID. Either one or more numbers separated by comma. Each value stands for an language oder two-channel audio.
+
-
If that channel has AC3 ("Dolby Digital Sound"), the Dolby PIDs follows the analog audio PIDs, both lists are separated by semikolon. <BR>
+
-
(z.B.:...:101,102;103,104:...)<BR>
+
-
For analogue TV: mostly 300 or 80 (older versions)
+
-
The development VDR-1.3.x (but not VDR-1.2.x) accepts language markers like "APID=eng", "APID=deu", "APID=2ch".
+
-
==TPID==
+
===APID===
-
Teletext PID. <BR>
+
Audio PID. Either one or more numbers separated by a comma. Each value stands for a language or two-channel audio. If that channel has AC3 (''Dolby Digital Sound''), the Dolby PIDs follows the mpeg audio PIDs, both lists are separated by semicolon (e.g.:...:101,102;103,104:...).
-
==CA - Conditional access==
+
For analogue TV: mostly 301(ivtv > 0.1.9) or 160(ivtv <= 0.1.9, bttv)
-
This Integer describes how to access the encrypted channel. <BR>
+
The development VDR 1.3.x (but not VDR 1.2.x) accepts language markers like ''APID=eng'', ''APID=deu'', ''APID=2ch''.
-
'''0'''                 Free To Air <BR>
+
 
-
'''1'''..'''4'''         use DVB-Karte with that number. <BR>
+
===TPID===
-
'''5'''..'''100'''         use this method for decrypting. <BR>
+
Teletext PID.
-
'''32001'''                   analogue TV (VDR-1.2.x) <BR>
+
 
-
'''A0'''                       analogue TV (VDR-1.3.x) <BR>
+
===CA - Conditional access===
 +
This integer describes how to access the encrypted channel.
 +
* '''0'''         Free To Air
 +
* '''1'''..'''4''' use DVB-Karte with that number.
 +
* '''5'''..'''100''' use this method for decrypting.
 +
* '''32001''' analog TV (VDR-1.2.x)
 +
* '''A0''' analog TV (VDR-1.3.x)
The methods are described in ca.conf.
The methods are described in ca.conf.
-
==SID==
+
===SID===
Service ID of channel.
Service ID of channel.
-
For analogue TV: see ChannelMap.h from Analogtv-Plugin source package.
 
-
==NID==
+
For analogue TV: see ChannelMap.h from [[Analogtv-plugin]] source package.
-
Network ID. Placeholder for future development. <BR>
+
-
Currently 0. (VDR-1.2.x only)
+
-
==TID==
+
===NID===
-
Transport Stream ID. Placeholder for future development. <BR>
+
Network ID. Placeholder for future development. Currently 0. (VDR-1.2.x only)
-
Currently 0. (VDR-1.2.x only)
+
-
==RID==
+
===TID===
-
Radio ID. Typical 0. Can be used for differntiate between channels having the same SID, NID and TID.
+
Transport Stream ID. Placeholder for future development. Currently 0. (VDR-1.2.x only)
-
=Differnces=
+
===RID===
-
VDR-1.2.x: NID=0, TID=0, RID=0<BR>
+
Radio ID. Typical 0. Can be used to differentiate between channels having the same [[#SID|SID]], [[#NID|NID]] and [[#TID|TID]].
-
VDR-1.2.x with AutoPID-Patch: NID<>0, TID<>0, RID<>0 valid<BR>
+
-
VDR-1.3.x: NID<>0, TID<>0, RID<>0 valid, starting from version 1.3.12 also service provider included in Name, in Audio-PID also language marker valid.<BR>
+
-
=Links=
+
==Differences==
 +
; VDR-1.2.x : NID=0, TID=0, RID=0
 +
; VDR-1.2.x with AutoPID-Patch : NID<>0, TID<>0, RID<>0 valid
 +
; VDR-1.3.x : NID<>0, TID<>0, RID<>0 valid, starting from version 1.3.12 also service provider included in Name, in Audio-PID also language marker valid.
 +
 
 +
==Links==
{|
{|
-
| [1]
 
-
| http://www.zwez.com/sat/vdr
 
-
| Sorted Lists for VDR => www.zwez.com
 
-
|-
 
| [2]
| [2]
| http://free.pages.at/cleditor
| http://free.pages.at/cleditor
| Channel Editor
| Channel Editor
|-
|-
-
| [3]
+
| [4]
 +
| http://free.pages.at/cleditor/cle4vdr.htm
 +
| Channel List Editor for Linux
 +
|-
 +
| [5]
 +
| http://www.vdrwapmin.formativ.net/dl.php?download=vdr-channels
 +
| VDR Channel Listings for Astra 19.2East and Hotbird 13.0East - VDR 1.3 Format only
 +
|-
 +
| [6]
| [[DVB-T]]
| [[DVB-T]]
 +
|
|}
|}
 +
 +
[[Category:Configuration files]]
 +
 +
<!-- Link to german wiki page -->
 +
[[de:Syntax der channels.conf]]

Latest revision as of 21:28, 27 December 2009

Contents

Parameters of VDR channel config file

Note that older versions of VDR (e.g 1.2.x) use a slightly different format of this file, and switching between vdr 1.2.x and vdr 1.3.x with the same channel file can lead to problems, see below under Differences. In the example below there are three different channel definitions:

  • digital satellite TV channel
  • digital terrestrian TV channel
  • digital cable TV channel
  • analog TV channel
Name Frequency Parameters Source SRate VPID APID TPID CA SID NID TID RID
RTL 12188 h S19.2E 27500 163 104 105 0 12003 0 0 0
Das Erste 522000 I0C23D0M16B8T8G8Y0 T 27500 1401 1402 1404 1 14 0 0 0
FS HH 402000 C0M64 C 6900 2401 2402 2404 0 28225 1 1073 16387
VHF K10 210250 C0D45B6 C 0 301 300 0 A0 28106 0 0 0

The VDR reads at startup all channel definitions from the config file $CONFIGDIR/vdr/channels.conf and writes any changing back to the file.

Info
Info

Changes to channels.conf while VDR is running will be overwritten. VDR has to be stopped if you want to edit this file!


Name

Name of that channel. If the name includes a ":" it will be automatically replaced by "|". If you use VDR version 1.2.x please do NOT include commas or semicolons. Starting with VDR version 1.3.12 this field also includes the service providers name(aka "bouquet"), separated by a semikolon.

Frequency

Transponder Frequency as Integer

DVB-S 
Frequency in MHz.
DVB-C 
Frequency in MHz, kHz or Hz.
DVB-T 
Frequency in MHz, kHz or Hz.
analogue TV 
Frequency in MHz. (analogTV plugin)

The values here will be multiplied by 1000 until it's bigger than 1000000.


Parameters

The Parameters in this field depends on the type of DVB you use: DVB-S, DVB-C ,DVB-T or analogue TV. Each Parameter starts with an letter, followed by an Integer which represends the value of that parameter.

Valid identifiers and their ranges:

Identifier (Values) Meaning

I (0, 1) Inversion (for DVB-T should always be 0, except some cards that need 999 (auto), such as Hauppauge NOVA-T USB2)

C (0, 12, 23, 34, 45, 56, 67, 78, 89) Data rate high priority

for analogue TV is C the capture device:
C0  = /dev/video0
C12 = /dev/video1
C23 = /dev/video2
C34 = /dev/video3
C45 = /dev/video4

D (0, 12, 23, 34, 45, 56, 67, 78, 89) Data rate low priority

for analogue TV is D the video source used:
D0  = Television       (bttv)
D12 = Composite Video1 (bttv)
D23 = Composite Video2 (bttv)
D34 = S-Video          (bttv)
D0  = S-Video ext.     (Hauppauge PVR150/PVR250/350-cards only)
D45 = Composite Video  (Hauppauge PVR150-cards only)
D45 = Tuner 0          (Hauppauge PVR250/350-cards only)
D56 = Composite ext.   (Hauppauge PVR250/350-cards only)
D67 = TV Tuner         (Hauppauge PVR150-Karten only)

M (0, 16, 32, 64, 128, 256) Modulation

B (6, 7, 8) Bandwidth in MHz

for analogue TV is B the Video norm:
B6 = PAL
B7 = NTSC
B8 = SECAM

T (2, 8) Transmission mode

G (4, 8, 16, 32) Guard intervall

Y (0, 1, 2, 4) Hierarchy

H Horizontal Polarization

V Vertical Polarization

R Circular Polarization right

L Circular Polarization left

The Polarisation Parameter is NOT followed by an value for compatibility reasons.

The value 999 is used for automatic. If possible the driver will find the best settings, this is default.

Example for DVB-T:

I0C23D0M16B8T8G8Y0

Inversion off,
Data Rate High=23,
Data Rate Low=0,
QAM16,
Bandwidth 8MHz,
Transmission Mode 8,
Guard 1/8,
Hierarchy 0

Source

Signal source of the channel, as defined in sources.conf.

Sxxxx, C, T

For compatbility reasons numeric values are accepted here, but preferred are literals.

Symbol Rate

Symbol Rate of the channel. Valid only for DVB-S and DVB-C, as DVB-T uses another modulation COFDM (Coded Orthogonal Frequency Division Multiplex).

VPID

Video PID (Program Identification).

  • 0 for Radio channels
  • 1 for encryted channels (pay tv)

If that channel uses a separate PCR PID this PCR PID follows the Video PID, separated by "+" (e.g. ...:164+17:...)

For analogue TV: mostly 301(ivtv > 0.1.9) or 160(ivtv <= 0.1.9, bttv)

APID

Audio PID. Either one or more numbers separated by a comma. Each value stands for a language or two-channel audio. If that channel has AC3 (Dolby Digital Sound), the Dolby PIDs follows the mpeg audio PIDs, both lists are separated by semicolon (e.g.:...:101,102;103,104:...).

For analogue TV: mostly 301(ivtv > 0.1.9) or 160(ivtv <= 0.1.9, bttv)

The development VDR 1.3.x (but not VDR 1.2.x) accepts language markers like APID=eng, APID=deu, APID=2ch.

TPID

Teletext PID.

CA - Conditional access

This integer describes how to access the encrypted channel.

  • 0 Free To Air
  • 1..4 use DVB-Karte with that number.
  • 5..100 use this method for decrypting.
  • 32001 analog TV (VDR-1.2.x)
  • A0 analog TV (VDR-1.3.x)

The methods are described in ca.conf.

SID

Service ID of channel.

For analogue TV: see ChannelMap.h from Analogtv-plugin source package.

NID

Network ID. Placeholder for future development. Currently 0. (VDR-1.2.x only)

TID

Transport Stream ID. Placeholder for future development. Currently 0. (VDR-1.2.x only)

RID

Radio ID. Typical 0. Can be used to differentiate between channels having the same SID, NID and TID.

Differences

VDR-1.2.x 
NID=0, TID=0, RID=0
VDR-1.2.x with AutoPID-Patch 
NID<>0, TID<>0, RID<>0 valid
VDR-1.3.x 
NID<>0, TID<>0, RID<>0 valid, starting from version 1.3.12 also service provider included in Name, in Audio-PID also language marker valid.

Links

[2] http://free.pages.at/cleditor Channel Editor
[4] http://free.pages.at/cleditor/cle4vdr.htm Channel List Editor for Linux
[5] http://www.vdrwapmin.formativ.net/dl.php?download=vdr-channels VDR Channel Listings for Astra 19.2East and Hotbird 13.0East - VDR 1.3 Format only
[6] DVB-T
Personal tools
Participate
In other languages