remote_advanced_search

Advanced Search

This dialog window is initiated from kmttg Remote tab, Search sub-tab and pressing Search++ button.

• This provides advanced wishlist capabilities similar to but beyond what is possible via TiVos, using simple or complex boolean search criteria. Complex searches can include OR, AND, NOT booleans and wildcards.
• Unlike on the TiVo the search results from the wishlist are categorized into folders making it much easier to view - the TiVo "Upcoming" view of wishlists is a flat structure.
• Also adds capability of restricting matches to a given list of channels or favorite channels only which is not possible via TiVo wishlists.
• Search criteria can be saved with given names and can be recalled at a later time akin to search bookmarks.
• i.e. This capability is in essence portable wishlists or search bookmarks independent of any TiVo that you can save via kmttg.
• Below is a summary of each of the fields in the Advanced Search dialog window.

Saved entries

• Contains a list of previously saved wishlists.
• If you have never saved a wishlist this simply shows Default entry which when selected resets all dialog entries to default/empty configuration
• If you have previously saved 1 or more wishlists then the list of saved entries will be displayed here. You can select an entry to automatically set all dialog entries to that saved configuration.

Save...

• Use this button to save current search configuration as a wishlist.
• You will prompted to give a name to use for the wishlist.
• If you give the same name as an existing saved wishlist then it will be updated with current settings.
• NOTE: Wishlists are saved to wishlists.ini file in kmttg installation folder.

Delete

• Removes currently selected wishlist entry if a previously saved wishlist is currently selected.
• The Default entry cannot be deleted.

Title

• Match this show title exactly when performing a search.
• Only the program main title is matched here, not a subtitle if one exists.
• NOTE: Case insensitive.

Title keyword

• Match given keyword in show title only when performing a search.
• Only the program title is matched here, not the subtitle.
• NOTE that you can use * wildcard character as part of a keyword, but it must contain at least one alphanumeric character to go with the wildcard.
• NOTE: Case insensitive.

Subtitle

• Match this show subtitle exactly when performing a search.
• Only the program main subtitle is matched here, not main title.
• NOTE: Case insensitive.

Subtitle keyword

• Match given keyword in show subtitle only when performing a search.
• Only the program subtitle is matched here, not the main title.
• This field can be used in conjunction with Title field, but cannot be used with Keywords field. Doing so will result in an error response.
• NOTE that you can use * wildcard character as part of a keyword, but it must contain at least one alphanumeric character to go with the wildcard.
• NOTE: Case insensitive.

Keywords

• Keywords can be in 2 different forms:
• 1. A simple keyword or phrase that is matched to title, subtitle, or descriptions of shows.
• 2. A complex list of space separated keywords with special operators much like advanced keywords are constructed via TiVo wishlists:
  • You can have multiple keywords each separated by a space in the forms listed below.
  • +keyword: Indicates a required keyword that must be present in title, subtitle, or description (AND)
  • -keyword: Indicates keyword must not be present in title, subtitle, or description (NOT)
  • (keyword): Keyword inside parenthesis indicates this optional keyword should be present in title, subtitle, or description. 1 of the optional keywords provided must be present for a match to occur.
• NOTE that you can use * wildcard character as part of a keyword, but it must contain at least one alphanumeric character to go with the wildcard.
• NOTE: Keywords are case insensitive.
• See examples provided at end of this Wiki.

Description keyword

• Match given keyword in show description only when performing a search.
• The program description or subtitle is matched with this keyword but not the main title.
• NOTE that you can use * wildcard character as part of a keyword, but it must contain at least one alphanumeric character to go with the wildcard.
• NOTE: Case insensitive.

Restrict channels

• A list of 1 or more space separated channel numbers to restrict the search to.
• Only channels in this list will be matched. If left empty then all channels are allowed.

Year

• Match only shows whose original air date happened in given year.
• For movie searches the movie release date is used rather than original air date.
• NOTE: You can only provide a single year in this field. (Multiple years not supported).

Other filter

• You can choose to match additional specific criteria: 1 of actor, director, producer, executiveProducer, writer
• Specify 1 or more names in FirstName LastName syntax to match as part of the search. Example: clint eastwood
• If only 1 string is given then it's assumed to be LastName.
• Multiple names can be specified comma separated and signify logical OR operation. Example: clint eastwood, tommy jones

Genre

• Indicates to restrict matches to shows of this genre. Selecting movie is the equivalent of selecting Movies Category.
• NOTE: Selecting Genre=movie is equivalent to selecting Category=Movies and has same tivo.com username and password requirement in order for Category searching to work (see below).

Recording types

• Indicates to restrict recordings to HD (high definition), SD (standard definition), or both.

Category

• NOTE: For this field to be available you must provide kmttg with your tivo.com login and password in the configuration->Tivos tab. kmttg needs to be able to login into middlemind.tivo.com to obtain a list of category IDs to be used as part of the search which is why this is necessary.
• If you select a category other than ALL then that specific category will be matched against.
• If ALL is selected (default choice) then category filtering is disabled.
• When selecting a category it is not necessary to provide any keywords, titles or subtitles to search for.

Minimum rating

• Choose minimum star rating to match when searching for movies.
• Applicable only when Genre=movie or Category not set to ALL.

Received channels only

• When this option is disabled, then channels you have disabled in Channel List are also included in the search.

Favorite channels only

• When this option is enabled, then only channels in Favorites List are included in the search.

Search

• Initiate advanced search based on the criteria currently specified in the dialog.
• For series 4 and later TiVos you can include streaming and web videos as part of search if you wish by enabling one or more of the following check boxes:
  • Streaming content
  • Paid streaming content
  • Note that the streaming sources used are not able to be filtered based on what you have enabled in "My Video Providers" setting on the corresponding TiVo, and therefore all streaming sources are displayed regardless of whether you have access to them or not.
  • NOTE: Streaming only titles from Search table can now be added as bookmarks to TiVo My Shows using the Record button. Titles can be any type of streaming content: movies, episodic shows or even currently unavailable shows. For unavailable titles they will end up in "Currently Unavailable" folder on the TiVo.
• Note that search runs as a background Remote task and depending on search criteria can take a long time to complete.
• The kmttg title is updated during the search indicating how many shows have been processed that match the basic search criteria.
• The kmttg job table STATUS field indicates how many full matches have been found so far during the search with all filters applied. Specifically, when channel or category filters are supplied then the number of matches shown here are a subset of those shown in the title.

Close

• Closes the Advanced Search dialog window
• NOTE: It's OK to close this window while a search is under way.

EXAMPLES

1 Search for all movies released in year 2012 with a minimum of a 3 star rating.

Year=2012
Category=Movies
Minimum rating=three

2 Search for all shows with main title "NBA Basketball", restrict to Lakers or Clippers games only, and only HD recordings.

Title=NBA Basketball
Keywords=(lakers) (clippers)
Recording types=HD

3 Search for all shows with main title "NBA Basketball", restrict to all games except Lakers and Clippers games and allow both HD and SD recordings.

Title=NBA Basketball
Keywords=-lakers -clippers
Recording types=both

4 Search for all shows in "Sci-Fi and Fantasy" category that have keyword "space" in subtitle, or description. Match episodic and non-episodic shows and both SD and HD recordings.

Description keyword=space
Category=Sci-Fi and Fantasy
Show types=both
Recording types=both