README.config

!!! Backup your channels.conf !!!

The main configuration file is autosort.conf.
It normaly resist in /video/plugins.


A configuration line looks like this:

   FreeTV:Order=10:HasNoCa:HasVpid:HasApid:Sort


The very first entry must be the name of the group delimiter you wish to create.
All other options can come in random order.

The different options are AND concatenated.
The multi-options themselfes are OR concatenated.
The 'Has'-options work as 'contains', not as 'is exactly' at the moment.

So
    HasName=viva
greps
    ViVa
    Revival
    Eviva Radio

and 
    HasName=srtl:HasName=super rtl:HasNoCa
greps
    SRTL
    Super RTL
only if they are Free to air


--------------------------------------------------------------------------------

Priority = [0..99] (99)
    The order the groups will be checked.
    Thats important in case a channel fits to more than one group.
    Little number means hight priority.    
    Default is 99 (latest).

Order = [1..999] (500)
    The order the groups are sorted into channels.conf.
    Internally the values 1010 and 1020 are used to ensure that the
    special groups "Unsorted" and "New Channels" are the very last ones.    
    Default is 500 (middle).
    Hint: number in steps by five or ten to make a later insertion of new groups more easy.
    
FixedPos = [1..?] (none)
    Gives the first channel in the group this channelnumber as known from
	:@1000 Radio
    Refer vdr.5 for details.
    Default is no fixed position.
    
StartName = [char]
    Checks if the channel name starts with "char".
    Internally this is used by SubSections and so will be overwritten by this option.
    A default is not set.

HasName / NotName = [text]
    Searches for "text" in the channel name.
    It's not case but space sensitive between "=" and ":",
    so if you write
	HasName = x :
    it will search for x or X with one space before and one behind.
    Can be given multiple.
    A default is not set.

HasProvider / NotProvider = [text]
    Searches for "text" in the provider name.
    Works like HasName.
    Can be given multiple.
    A default is not set.

AudioLang = [text]
    Searches for "text" in the audio language descriptor.
    Works like HasName.
    Can be given multiple.
    A default is not set.
    
HasSource = [source]
    Checks for the given source.
    Values have to be given exactly as in sources.conf
    Can be given multiple.
    A default is not set.
        
CaValue / NotCaValue = [hex]
    Checks for a special CaValue.
    Values have to be given as in channels.conf
    Can be given multiple.
    A default is not set.
    
HasOpenCa   / HasNoOpenCa
HasClosedCa / HasNoClosedCa
    (Not implemented yet)
    Checks for the CaValues set in the lists OpenCa / ClosedCa.
    Open means your CAM can decrypt these channel.
    Closed means you will never buy a CAM for these channels.
    Default is not to care about.
    
HasApid / HasNoApid
HasVpid / HasNoVpid
HasTpid / HasNoTpid
HasCa   / HasNoCa
    Check for the existance of any [AVT]pid or Ca value.
    Hint: A combination of HasNoCa with CaValue=freeToMe won't work.
          Use CaValue=0 instead.
    Default is not to care about.
    
Sort
    Alphabetically sort inside this group.
    Default is not to sort.
    
SubSections
    Parts the group in Subgroups like
	:Radio A
	:Radio B
	:Radio C
	...
	:Radio Z
    Usefull for big groups you just want to seperate anyway.
    Hint: SubSection-Groups internally use two order-values. If they are
          splitted, increase other groups order value by at least 2.
    Default is no.
    
KeepHere
    Prevents channels from getting sorted _out_ of this group.
    It will be overridden by groups with same or higher priority.
    Use for handsorted groups or payTV that sends FTA inbetween.
    Default is no.
    
SetCaFF
    Set the Ca value to FF and so disable this channels.
    Use together with 
        :HasName=hd:       to save your fullfeatured card
	:HasName=erotic:   to save your children/granny
        :HasName=teleshop: to save your creditcard
    If channel is sorted out of that group, Ca will be resetted to 0 ('deleteca' patch needed!)
    
SetCa0
    Set the Ca value to 0 and so force a re-check of channels ca. 
    You may need the 'deleteca'-patch for this option.
    Usefull if your scan application fills the Ca field with the card number.
    Example:
	WrongCa:CaValue=1:CaValue=2:CaValue=3:CaValue=4:SetCa0
	(please take the complete line from the example autosort.conf)
        Hint: Don't wonder that this group will stay empty.

TimeStamp = x
    Checks for a TimeStamp that is at least x days old.
    A default is not set.
    