Ticket #845: schedhowto2.diff
File schedhowto2.diff, 24.5 KB (added by , 18 years ago) |
---|
-
docs/mythtv-HOWTO.sgml
3717 3717 scheduler find which showings you would like to record. 3718 3718 3719 3719 <itemize> 3720 <item>Single Record -- record only this title at this specific 3721 time. This is the best way to be sure that a certain showing is 3722 recorded. However, if the TV listings change and the show is not 3723 broadcast at that time, the show will not be recorded. 3720 <item>Single Record -- record only this title at this specific time and 3721 this station. This is the best way to be sure that a certain showing is 3722 recorded. However, if the TV listings change and the show is not broadcast 3723 at that time, the show will not be recorded but will be marked as Not Listed 3724 to let you know that you should investigate. 3724 3725 3725 3726 <item>Find One -- this will record a title once from any of the times 3726 3727 that appear in the TV listings. This is useful for recording a movie … … 3741 3742 the showing that was selected when the rule was set. This is useful 3742 3743 for news, current events or other programs where the same episode is 3743 3744 shown several times each week but the listings may not include 3744 descriptive information. This is nota good choice if there are3745 descriptive information. This may not be a good choice if there are 3745 3746 different episodes shown during the week. 3746 3747 3747 3748 <item>Record Daily -- this records a show whenever the title is listed 3748 for the time and channelon any day of the week. Here again, a show3749 for the time and station on any day of the week. Here again, a show 3749 3750 will not be recorded if the time was altered by the station. 3750 3751 3751 3752 <item>Find Daily -- this will record a title once per day from any … … 3753 3754 the showing that was selected when the rule was set. This is useful 3754 3755 for news, current events or other programs where the same episode is 3755 3756 shown several times each day but the listings may not include 3756 descriptive information. This is nota good choice if there are3757 descriptive information. This may not be a good choice if there are 3757 3758 different episodes shown during the day. 3758 3759 3759 3760 <item>Channel Record -- records a show anytime the title is listed on 3760 this channel. This is perhaps the most common rule to use for most3761 this station. This is perhaps the most common rule to use for most 3761 3762 shows. 3762 3763 3763 3764 <item>Record All -- record this title on any channel at any time. This … … 3772 3773 <p>By default, all shows you select have equal value to the 3773 3774 scheduler. There are a set of rules to make good choices when 3774 3775 two or more shows are in conflict. However, priority values let the 3775 scheduler know what you wantso that it can set the schedule based3776 scheduler know what you prefer so that it can set the schedule based 3776 3777 on your preferences. 3777 3778 3778 3779 Initially all priority values are set to zero. You may choose to … … 3787 3788 which show you'd prefer verses any other show. The choice and style 3788 3789 are entirely up to you. However, the more information you give to 3789 3790 the scheduler, the more likely it will make the choices you would 3790 likein the first place.3791 prefer in the first place. 3791 3792 3792 3793 The scheduler choices are based on the total priority for a showing 3793 by adding up four different priority factors. By default, allof3794 by adding up four different priority factors. By default, most of 3794 3795 these factors are "0" but you may use any combination to express 3795 3796 your likes and needs. 3796 3797 … … 3801 3802 simplicity and clarity. 3802 3803 3803 3804 Per record type -- Setup->TV Settings->Recording Priorities->General 3804 allows you to add to the priority based on the type. It may make 3805 sense to increase the value for "Single" so that by default they 3806 have an extra advantage over other shows. You may want to decrease3805 allows you to add to the priority based on the type. It may make sense to 3806 increase the value for "Single" so that by default they have an extra 3807 advantage over other shows. The default is +1. You may want to decrease 3807 3808 the value for Find rules so that they will be less likely to interfere 3808 with regular shows and will be more likely to record in a 3809 non-conflicting time instead.3809 with regular shows and will be more likely to record in a non-conflicting 3810 time instead. The default is -1. 3810 3811 3811 3812 Per channel -- Setup->TV Settings->Recording Priorities->Channel 3812 3813 Priorities can be useful if you believe that you prefer any of the … … 3882 3883 schedule. 3883 3884 3884 3885 <itemize> 3885 <item>Currently recording beats not currently recording -- A recording in 3886 progress can not be moved so it "wins" it's current timeslot. 3886 <item>Currently recording beats not currently recording -- A recording 3887 in progress can not be moved to another input or time so it "wins" 3888 its current timeslot. 3887 3889 3888 <item>Higher total priority beats lower total priority -- This is the core of 3889 the scheduling process. Episodes of the highest priority show are placed 3890 on the first available card then the next highest priority and so on. 3890 <item>Single showing rules with no match are marked Not Listed -- If a 3891 Single or Override do not match the current listings because the 3892 listings have changed, they are added to the schedule and marked to 3893 indicate that they will not record. 3891 3894 3892 <item>Future start time beats passed start time -- If there is an 3895 <item>Other record statuses beat Inactive or Repeat -- If two rules 3896 match the same showing of a program, a rule marked as inactive or 3897 a showing marked as a repeat yield to the other rule. 3898 3899 <item>More specific record type is used in place of less specific -- If 3900 two rules match the same showing of a program, preference is given to 3901 Don't Record then Override, Single, Find One, Record Weekly, Find Weekly, 3902 Record Daily, Find Daily, Channel and finally All. 3903 3904 <item>Higher total priority beats lower total priority -- This is the 3905 core of the scheduling process. Episodes of the highest priority show 3906 are placed on the first available input followed by the next highest 3907 priority show and so on. 3908 3909 <item>Future start time beats past start time -- If there is an 3893 3910 episode in progress and also a later showing of the same episode, it 3894 3911 is better to record the complete episode. If there isn't another 3895 3912 showing, start recording now to record the remaining portion. … … 3906 3923 <item>If both start times have passed, later start time beats earlier start 3907 3924 time -- This attempts to miss the least amount of time. 3908 3925 3909 <item>If neither start time has passed, earlier start time beats later start3910 time -- This rule help assure that the earliest showing of an episode has 3911 the advantage.3926 <item>If neither start time has passed, earlier start time beats later 3927 start time -- This helps assure that the earliest showing of an episode 3928 has the advantage. 3912 3929 3913 <item>Lower input id beats higher input id -- The scheduler fills in open 3914 time slots on the first available card. The next cards is used when there is 3915 another show already placed for the first card. 3930 <item>Lower input id beats higher input id -- The scheduler fills in 3931 open time slots on the first available input for the video source. The 3932 next input is used when there is another show already placed for the 3933 card of the first input. 3916 3934 3917 3935 <item>Older record rule beats newer record rule -- If two shows are still 3918 3936 equal after all of these other checks, the show whose record rule was added 3919 3937 first is preferred over a more recent addition. 3920 3938 3939 <item>Postpone showings to resolve conflicts -- If Reschedule Higher 3940 Priorities is set or if a conflict has the same priority as a show 3941 that was scheduled at the same time, the scheduler will check to see 3942 if a scheduled show can be moved to another input or later matching 3943 showing without creating a new conflict so that the conflicting show 3944 can be scheduled to record. 3945 3921 3946 </itemize> 3922 3947 3923 3948 <sect2>Reschedule Higher Priorities … … 3928 3953 look for situations where a show cannot record because all inputs for the 3929 3954 channel are used for higher priority shows. It will check to see if any of 3930 3955 the other shows could be recorded at another time so that the conflicting 3931 show can be recorded in it 's place.3956 show can be recorded in its place. 3932 3957 3933 3958 Generally, this is a good strategy but there are tradeoffs. If a higher 3934 3959 priority show is postponed, you will not get to watch it until it is … … 3936 3961 may change and the later showing may go away. In this rare case the higher 3937 3962 priority show may never record. On the other hand, if you do not use this 3938 3963 option you will miss recording some lower priority shows unnecessarily 3939 unless you ma ke similar these changes manually.3964 unless you manually make similar changes. 3940 3965 3941 3966 By using Reschedule Higher Priorities, the scheduler will do a better job of 3942 3967 recording as many of your shows as possible when left unattended. It will 3943 3968 also be easy to see that shows have been marked to record at a later time. 3944 3969 You can then decide for yourself when you would prefer to record the first 3945 showing .3970 showing by clicking "Record anyway". 3946 3971 3947 3972 <sect2>Controlling Your Schedule 3948 3973 <p>The Manage Recordings->Upcoming Recordings page is your control center … … 3959 3984 will remind you when there are conflicts that would prevent one or more 3960 3985 shows from being recorded. 3961 3986 3962 The items in the list are colored white for things that will record, 3963 gray for those that do not need to record and yellow when there is a 3964 time conflict. Items at the top of the list may also be highlighted 3965 indicating that the recording is in progress. 3987 The items in the list are colored in the record color for things that 3988 will record, white for things that may need attention, gray for those 3989 that do not need to record and yellow when there is a time conflict. 3990 Items at the top of the list may also be highlighted indicating that the 3991 recording is in progress. 3966 3992 3967 Along with the channels, start times and titles, the right-hand column has a 3968 status code. Numbers indicate which card number has been assigned to record 3969 the show. Letters are used to indicate the reason that something will not be 3970 recorded. Just below the box is a short status message for the highlighted 3971 item that indicates the type of record rule that was matched and a one or 3972 two word explanation of the status code. If you press SELECT, you will see 3973 more information about the status. 3993 Along with the channels, start times and titles, the right-hand column has 3994 a status code. Numbers indicate which card number has been assigned to 3995 record the show. Letters are used to indicate the reason that something 3996 will not be recorded. Just below the box is a short status message for the 3997 highlighted item that indicates the type of record rule that was matched, 3998 the "total priority" for this showing and a one or two word explanation of 3999 the status code. If you press SELECT, you will see more information about 4000 the status. 3974 4001 3975 4002 There are a few status codes that may require your attention. "C" indicates 3976 4003 that there are more overlapping shows to record than there are TV tuners to … … 3980 4007 notice situations where you would like to modify the scheduler's initial 3981 4008 choices. 3982 4009 3983 The first thing you can do is to highlight an item and press INFO once or3984 twice to see the Recording Options page. From this page you can change the4010 The first thing you can do is to highlight an item and press INFO to 4011 see the recording options page. From this page you can change the 3985 4012 record rule type, the duplicate matching rules, or raise or lower the 3986 4013 priority to resolve whatever problem you noticed. 3987 4014 … … 4006 4033 such as raising the priority so that the show will record. These changes 4007 4034 would apply to this and all future showings that match this record rule. 4008 4035 "Add Override" will allow you to set options that apply to the specific 4009 showing without affecting the existing record rule.4036 showing without affecting the recurring record rule. 4010 4037 4011 4038 If you return to an override page after an override has already been set, 4012 you will also see a "Clear override" to undo your changes. This option makes4039 you will also see a "Clear Override" to undo your changes. This option makes 4013 4040 it very easy to try out some "what if" attempts when deciding on your best 4014 4041 strategy in a difficult situation. 4015 4042 4043 For a recording in progress, there will be a "Change Ending Time" button. 4044 This will take you to the options page for a Single or Override or create 4045 an Override if it is a recurring rule. Here you can go to the Recording 4046 Options section to change the program end time offset. If you extend the 4047 end time so that it overlaps upcoming recordings, the schedule will change 4048 to accommodate the new end time. This may cause a conflict or later showing 4049 even for a show with higher priority. Therefore, it is a good idea to 4050 check your schedule after changing the end time of a recording in 4051 progress. 4052 4016 4053 <sect1>Storage Options 4017 4054 <sect2>Recording Profile 4018 <p>Each schedule can be configured with a different recording profile. 4019 For example, important shows can be configured with a "High Quality" 4020 profile, while "filler" shows can be configured with a "Low Quality" 4021 profile. These recording profiles need to be configured first (see 4022 <ref id="Recording" name="Recording">, above). 4055 <p>Each recording rule can be configured with a different recording 4056 profile. For example, colorful cinematography can be configured with a 4057 "High Quality" profile, while 'talking heads' interviews shows can be 4058 configured with a "Low Quality" profile. These recording profiles need to 4059 be configured before using them (see <ref id="Recording" name="Recording">, 4060 above). 4023 4061 4024 4062 <sect2>Recording Group <label id="Recording Group"> 4025 4063 <p>For organization of the "Watch Recordings" screen and the MythWeb 4026 interface, recordings can be grouped into "recording groups".4064 interface, recordings can be assigned into "recording groups". 4027 4065 4028 <sect2>Time Stretch 4029 <p>A default time stretch value can be configured for each schedule; 4030 this value will automatically be applied when the recordings are 4031 played back. 4066 <sect2>Playback Group <label id="Playback Group"> 4067 <p>This selects a set of pre-configured playback parameters which can be 4068 created and edited in Setup->TV Settings->Playback Groups. When the 4069 recording is played, the values from this playback group will be 4070 used. This allows you to choose a default time stretch value, skip and 4071 jump amounts appropriate for this type of television program. 4032 4072 4033 4073 <sect2>Auto-Expire <label id="Auto-Expire"> 4034 4074 <p>MythTV will "autoexpire" old recordings to make room for new recordings 4035 4075 when disk space gets filled up. This option can be set to "Don't allow 4036 auto expire" to prevent recordings from being automatically deleted4076 auto expire" to prevent these recordings from being automatically deleted 4037 4077 when disk space fills up. 4038 4078 4039 4079 <p>The default setting is for all scheduled recordings to be eligible … … 4049 4089 <p>An episode limit can also be configured to limit the maximum number 4050 4090 of episodes recorded of a single series, to restrict that series' disk 4051 4091 usage. If this is set, you can further decide what to do when this 4052 limit is reached :either stop recording that series, or to delete the4092 limit is reached; either stop recording that series, or to delete the 4053 4093 oldest episodes in favor of the new ones. 4054 4094 4055 4095 <sect1>Post Recording Processing … … 4095 4135 </itemize> 4096 4136 4097 4137 <sect1>Advanced Recording Options 4098 < p>Creating Power Search rules with Custom Record4138 <sect2>Creating Power Search rules with Custom Record 4099 4139 4100 4140 MythTV's "Custom Record" feature gives you unlimited control for creating 4101 4141 specialized search recording rules to meet your needs. It allows you to … … 4107 4147 4108 4148 <sect2>Getting Started 4109 4149 <p> 4110 Go to Schedule Recordings->Custom Record. This page, titled "Power Search4111 Recording Rule Editor", helps you build a database search one clause at a 4112 time. Each added clause further limits which showings will be matched inthe4113 TV listings data. You can test the search at any time and when you are done, 4114 you can save your search as arecording rule.4150 Go to Schedule Recordings->Custom Record. This page, helps you build a 4151 database search one clause at a time. Each added clause further limits 4152 which showings will be matched in the TV listings. You can test the 4153 search at any time and when you are done, you can save your search as a 4154 recording rule. 4115 4155 4116 4156 To familiarize yourself with how you can create custom rules, create a 4117 4157 simple rule to record "Nova" only in primetime. 4118 4158 4119 The first item at the top of the page allows you to edit an existing rule or 4120 create a new rule. Leave it on "<New rule>". Arrow down to the third item 4121 which says "Match an exact title". Right and left arrows would allow you to 4122 select any of several prefabricated pieces or full examples but leave it on 4123 the default for now. Arrow down to "Add this example clause" and press 4124 SELECT (Enter or Space on a keyboard). The large text box should now show: 4159 The first item at the top of the page allows you to edit an existing rule 4160 or create a new rule. Leave it on "<New rule>". Arrow down to the 4161 third item which says "Match an exact title". Right and left arrows would 4162 allow you to select any of several prefabricated pieces or full examples 4163 but leave it on the default for now. Arrow down to "Add this example 4164 clause" and press SELECT (Enter or Space on a keyboard). The large text 4165 box should now show: 4125 4166 <tscreen><verb> 4126 program.title = "Nova"4167 program.title = 'Nova' 4127 4168 </verb></tscreen> 4128 4169 As you have probably guessed, this says that we want to search for all 4129 4170 programs with the title "Nova" regardless of the time, day, channel, etc. … … 4135 4176 between the quotes. With a remote control, you can do 'cell phone' style 4136 4177 text entry with the number pad. The delete key is the "X" in the grouping 4137 4178 for "1", zero is grouped with "9" and "0" acts as the "Caps Lock" key. 4179 With MythTV version 0.19 or later, you can press ENTER in the text box 4180 to popup a virtual keyboard. 4138 4181 4139 4182 Note: the text box honors many familiar Emacs control keys. It is also 4140 4183 possible to cut and paste text into the text box so you can edit with a … … 4149 4192 selector then press the right or left arrows until you find "Only in 4150 4193 primetime". Click "Add this example clause". You should now see: 4151 4194 <tscreen><verb> 4152 program.title = "Nova"4195 program.title = 'Nova' 4153 4196 AND HOUR(program.starttime) >= 19 4154 4197 AND HOUR(program.starttime) < 23 4155 4198 </verb></tscreen> … … 4163 4206 then click "Save these settings". You now have a special rule to record 4164 4207 "Nova" but only when it is shown in primetime. 4165 4208 4209 You can make further modifications to this rule by returning to the Custom 4210 Record page then press the right or left arrow keys on "Edit Rule:" until 4211 you find "Nova". You can experiment and test but the saved rule will not 4212 be updated until you click "Record" then "Save these settings". 4213 4166 4214 To remove this, or any other rule, you can go to the "Recording Priorities" 4167 4215 page, arrow down to the title, press Enter and change the the recording type 4168 4216 to "Do not record this program" then "Save these settings". … … 4174 4222 is stored in the 'program' table and information about each TV station you 4175 4223 receive is stored in 'channel'. These two tables are used in the scheduler 4176 4224 queries and their fields are available to be used in your rules. The rules 4177 you create are stored in 'record'. Normal rules in MythTV simply match the 4178 title in the rule with the titles in the 'program' table. 4225 you create are stored in 'record'. 4179 4226 4180 MythTV also has search rules for "Titles", "Keywords" and "People". These 4181 store the key phrase in the description field of the rule and includes them 4182 in specialized SQL replacements for the normal title check. There is also a 4183 type called "Power Search" which takes the raw SQL in the description as the 4184 replacement for title matching. 4227 Normal rules in MythTV simply match the title in the rule with the titles 4228 in the 'program' table. MythTV also has search rules for "Titles", 4229 "Keywords" and "People". These store the key phrase in the description 4230 field of the rule and includes them in specialized SQL replacements for 4231 the normal title check. There is also a type called "Power Search" which 4232 takes the raw SQL in the description as the replacement for title 4233 matching. 4185 4234 4186 4235 Custom Record is a tool to help you build valid SQL for Power Search rules. 4187 4236 You do not need to be a SQL expert to use Custom Record because the … … 4235 4284 Notice the word "LIKE" and the "%" at the end. This does wildcard matching 4236 4285 so that this would match even if the title ended with "2". "III" or 4237 4286 ":Revenge of the Snapple Lady". This can be useful where the title may 4238 change from one season to the next like "Survivor %", "Big Brother%" or4287 change from one season to the next like "Survivor: %", "Big Brother%" or 4239 4288 "The Amazing Race%". 4240 4289 4241 4290 <sect2>Working with SQL 4242 4291 <p> 4243 As you experiment, it is possible that you may misplace a quote or mistype a4244 word. If there is a mistake when you press "Test" or "Record" you will see 4245 an error message returned from the database. This will usually give you a 4246 good idea about what needs to be fixed. However, for more subtle MySQL 4247 syntax errors, you can find more information in the documentation at<url4248 url="http://dev.mysql.com/doc/mysql/en/" 4249 name="http://dev.mysql.com/doc/mysql/en/">. This contains a lot of 4250 information that can be useful for Power Search rules such as the "Date and 4251 Time Functions". There are many othergood resources for SQL on the Web.4292 As you experiment, it is possible that you may misplace a quote or mistype 4293 a word. If there is a mistake when you press "Test" or "Record" you will 4294 see an error message returned from the database. This will usually give 4295 you a good idea about what needs to be fixed. However, for more subtle 4296 MySQL syntax errors, you can find more information in the <url 4297 url="http://dev.mysql.com/doc/mysql/en/" name="documentation for 4298 MySQL">. This contains a lot of information that can be useful for Power 4299 Search rules such as the "Date and Time Functions". There are many other 4300 good resources for SQL on the Web. 4252 4301 4253 While the example clauses demonstrate how many of the data fields may be4254 used, you can get a more complete list of all the fields that are available 4255 byusing a MySQL client program:4302 While the example clauses demonstrate how to use many of the data fields, 4303 you can get a more complete list of all the fields that are available by 4304 using a MySQL client program: 4256 4305 <tscreen><verb> 4257 4306 $ mysql -u mythtv -pmythtv mythconverg 4258 4307 mysql> describe program; … … 4265 4314 <item>"program.category_type" holds one of these exact four strings: "movie", 4266 4315 "series", "sports" or "tvshow". 4267 4316 4268 <item>"program.airdate" is a string representing the year of release for movies4269 and may have no meaning for other types of shows.4317 <item>"program.airdate" is a string representing the year of release for 4318 movies and may have no meaning for other types of shows. 4270 4319 4271 <item>"program.stars" is a floating point number from 0.0 to 1.0. On a four star 4272 scale, 1.0 would be four stars, 0.75 would be three stars and so on. 4320 <item>"program.stars" is a floating point number from 0.0 to 1.0. On a 4321 four star scale, 1.0 would be four stars, 0.75 would be three stars and so 4322 on. 4273 4323 4274 4324 <item>"program.originalairdate" if provided is the date when a show 4275 4325 was, or will be, first televised. This may be useful for finding … … 4282 4332 airing. If this is "0" it usually means that this is a brand new show or a 4283 4333 rebroadcast within the first two weeks. 4284 4334 4285 <item>"program.programid" is the Tribune Media Service database record identifier 4286 for each program description. In general, these start with a two letter 4287 prefix, MV, EP, SP or SH that correspond to the "program.category_type". 4288 For most, the last four digits are "0000" except EP where the last four 4289 digits are the episode number in the series. Note that these are generated 4290 by TMS and not the show's producers but they are usually in the same order as 4291 the original air dates for the episodes. Detailed information can be found 4292 in the Data Direct documentation at <url url="http://labs.zap2it.com/" 4335 <item>"program.programid" is the Tribune Media Service database record 4336 identifier for each program description. In general, these start with a 4337 two letter prefix, MV, EP, SP or SH that correspond to the 4338 "program.category_type". For most, the last four digits are "0000" except 4339 EP where the last four digits are the episode number in the series. Note 4340 that these are generated by TMS and not the show's producers but they are 4341 usually in the same order as the original air dates for the 4342 episodes. Detailed information can be found in the Data Direct 4343 documentation at <url url="http://labs.zap2it.com/" 4293 4344 name="http://labs.zap2it.com/"> . 4294 4345 </itemize> 4346 4295 4347 Finally, if you are doing something very experimental and a field is not 4296 4348 giving you the results you had anticipated, you can always check the MythTV 4297 4349 source code to see exactly how a field is used. The open source for MythTV