README.config

!!! Backup your channels.conf !!!

The main configuration file is autosort.conf.
It normaly resist in /var/lib/vdr/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


You can add further config files under /var/lib/vdr/video/plugins/autosort/.
Each file has to be named exactly like the depending group and takes the 
same arguments like autosort.conf (one each line, closed with a ":")
Multioptions will be added, singleoptions overwrite values from autosort.conf.
You need the group to be defined in autosort.conf to search for additional files.

So the example from above could be splitted in:

/var/lib/vdr/video/plugins/autosort.conf
    FreeTV:Order=10
    
/var/lib/vdr/video/plugins/autosort/FreeTV
    HasNoCa:
    HasVpid:
    HasApid:
    Sort:
    

----------------------------
OpenGroups
In /var/lib/vdr/video/plugins/autosort/opengroups.conf you can define wich CaValues and/or Provider
are open for you, and later check for them with HasOpenCa / HasOpenProvider.

opengroups.conf takes the following options (one each line, closed with a ":")
    ClosedCa =[hex]:
    OpenCa   =[hex]:
    OpenProvider   =[text]:
    ClosedProvider =[text]:

Try createopengroups.pl to generate two templates.
----------------------------


--------------------------------------------------------------------------------
autosort.conf options
--------------------------------------------------------------------------------

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
    Checks for the CaValues set in opengroups.conf.
    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.
    
HasOpenProvider   / HasNoOpenProvider
HasClosedProvider / HasNoClosedProvider
    Checks for the [Open|Closed]Provider set in opengroups.conf.
    Open means you can see channels from this provider (FTA or you have a CAM).
    Closed means you can't see these channels.
    Default is not to care about.

ICanSee (not yet working, please don't use)
    ICanSee is the combination "HasOpenProvider OR HasOpenCa OR HasNoCa"
    It gives you every channel you can see or hear.
    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.

Delete / SaveDelete (not implemented yet)
    Delete all channels in this group and backup them to channels.deleted.
    
RealDelete (not implemented yet)
    Delete all channels in this group WITHOUT any backup.
    Do I really have to tell you that this can be dangerous?

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.