NAME
mythtv-status - Display the status of a MythTV backend
SYNOPSIS
mythtv-status [options]
DESCRIPTION
This script queries a MythTV backend and reports on the status of it,
any upcoming recordings and any which are happening right now.
The intention is to warn you if there is a program being recorded or
about to be recorded.
OPTIONS
-c, --colour
Use colour when showing the status of the encoder(s).
-d, --description
Display the description for the scheduled recordings.
--disk-space-warn
The threshold (in percent) of used disk space that we should show
the disk space in red (if using colour) or send an email if we’re
in email mode with email only on warnings.
--encoder-details
Display the input ID and channel name against the recording
details.
-e, --episode
Display the episode (subtitle) for the scheduled recordings.
--email <address>[ --email <address> ...]
Send the output to the listed email addresses. By default the
encoder status, currently recording shows and time till next
recording is surpressed from the email.
To turn the additional blocks on you can use --encoders,
--recording-now and/or --next-recording.
--email-only-on-alert
Only send an email out (if --email is present) if there is an alert
(i.e., schedule conflict or low disk space).
-?, --help
Display help.
--file <file>
Load XML from the file specified instead of querying a MythTV
backend. Handy for debugging things.
--guide-days-warn <days>
Warn if the number of days of guide data present is equal to or
below this level. Default is 2 days.
-h HOST, --host=HOST
The host to check, defaults to localhost.
--nostatus, --noencoders, --norecording-now, --noscheduled-recordings,
--noschedule-conflicts, --nonext-recording, --nototal-disk-space,
--nodisk-space, --noguide-data, --noauto-expire
Suppress displaying blocks of the output if they would normally be
displayed.
-p PORT, --port=PORT
The port to use when connecting to MythTV, defaults to 6544.
--auto-expire
Display the shows due to auto expire (output is normally
suppressed).
--auto-expire-count
How many of the auto expire shows to display, defaults to 10.
--recording-in-warn
If the "Next Recording In" time is less than this amount, display
it in red. This in seconds, and defaults to 3600 (1 hour).
--verbose
Have slightly more verbose output. This includes any warnings that
might be generated while parsing the XML.
-v, --version
Show the version of mythtv-status and then exit.
OUTPUT
The output of this script is broken up into several chunks they are:
Status
Some general info about the backend, currently just the timestamp
of when this program was run.
Guide Data
The number of days of guide data is present. By default it is only
shown if the number of days is below the warning level. To show it
regardless of the warning level use --guide-data.
Encoders
Each encoder that the backend knows about are listed, with the
hostname they are on, the encoder ID (in brackets) and the current
status.
Recording Now
Any programs which are being recorded right now.
Scheduled Recordings
Up to 10 programs which are scheduled to be recorded today and
tomorrow.
Schedule Conflicts
Any upcoming schedule conflicts (not just limited to today or
tomorrow).
Shows due to Auto Expire
The shows which will be deleted and the order they’ll be deleted if
the auto expirer kicks in.
Total Disk Space
The amount of disk space in total, and used by MythTV.
Next Recording In
If there are no recordings currently happening, then the amount of
time until the next recording is displayed.
Disk Space
Details about each storage group that MythTV knows about. By
default this only shows storage groups that are above the warning
level. Use --disk-space to turn on display of all storage groups.
RETURN CODES
mythtv-status provides some return codes.
0 Standard return code
1 A warning is generated
AUTHOR
Andrew Ruthven, andrew@etc.gen.nz
LICENSE
Copyright (c) 2007-2009 Andrew Ruthven <andrew@etc.gen.nz> This code is
hereby licensed for public consumption under the GNU GPL v3.