MythUtil is a command line application added in MythTV 0.25 that offers a number of utilities previously offered elsewhere as secondary functions. You can get detailed help by running
- 1 Backend Triggers
- 2 Markup Utilities
- 3 File Operations
- 4 Messaging Access
- 5 MythNotification
- 6 MPEG-TS Information
- 7 JobQueue Operations
- 8 Music Scanning Options
The options tell the master backend to perform some action
Issue an event that gets forwarded to any connected MythTV application that they should clear their database settings cache and pull new values as needed.
Force the scheduler to rerun, and update the internal list of upcoming recordings, after having made some changes to the recording rules.
Scan through all defined Videos storage directories on all available hosts for content to import into the Video Library. This is intended to allow UPnP users to update their libraries without having to run mythfrontend and trigger one through the UI.
Issue an arbitrary message through the event system that gets forwarded to any connected MythTV application.
Issue an arbitrary message as a System Event that gets forwarded once to each host running a connected MythTV application.
These allow you to manipulate the commercial skip lists and cut lists defined for recordings. All of the following require the additional use of --chanid and --starttime to define the recording to operate on.
Remove any currently defined cut points for the specified recording.
Remove any commercial detection results for the specified recording.
Move the commercial detection results into a cut list.
Return the currently defined cut list as a comma-separated list of ranges. Use -q to hide unwanted logging and return only the cut list.
Return the currently defined commercial detection results as a comma-separated list of ranges. Use -q to hide unwanted logging and return only the cut list.
Apply a provided comma-separate list of ranges to the specified recording.
Apply a provided commercial detection list of ranges to the specified recording.
Copy one file or myth:// URI to another. Requires --infile and --outfile.
Display the default MythMessage template to use. The current default template is:
<mythmessage version="1"> <text>%message_text%</text> <timeout>%timeout%</timeout> </mythmessage>
Send selected template using provided replacement text. The template will have several fields listed, that can be replaced using additional command line options of that name. In the above template, one would use --message_text and --timeout.
Select the address to send message to. The default value is 127.0.0.1 for the local host. Sending to your subnet broadcast address will display the message on any active frontend.
Select the port to send to. The default is 6548.
This provides similar features to MythMessage but has more options. Run mythutil --help to get full details.
mythutil --notification --message_text "Test message" --timeout 10
These options are used to display stream information about MPEG recordings.
Count the number of PIDs found in a recording. Requires --infile, which can be a relative or absolute file path, or a myth:// URI. Optionally accepts a --packetsize, which defaults to 188 bytes.
Apply PID filter to a recording, and output the resulting MPEG video to a new file. Requires --infile and --outfile, which can be relative or absolute file paths, or myth:// URIs. Requires --pids for the filter to apply. Optionally accepts a --packetsize, which defaults to 188 bytes.
Output the available PIDs found in a recording. Requires --infile, which can be a relative or absolute file path, or a myth:// URI. Requires --pids for the filter to select for. Optionally accepts --outfile, --xml, and --noautopts.
Schedule a job of the specified type to be run through the jobqueue. Requires the use of --chanid and --starttime.
Music Scanning Options
Scan through the "Music" Storage Group for music files and cover art. This is the same as selecting Scan for New Music from mythfrontend, but the output can be helpful when trying to understand why music is not found / updated.
Downloads an updated radio stream list from the MythTV server