Merge branch 'release-0.10' into release-0.10-debian-squeeze
[mythtv-status.git] / README
1 mythtv-status
2 =============
3
4 This script will display the current status of your MythTV system at the
5 command line.  It can optionally append it to the system message of the
6 day (MOTD) on a regular basis.
7
8 Sample output looks like:
9
10 -- Begin --
11 MythTV status for localhost
12 ===========================
13 Status...........: Wed Dec 12 2007, 12:00 PM
14 Total Disk Space.: Total space is 102,350 GB, with 73,410 GB used (71.7%)
15 Next Recording In: 5 Hours, 59 Minutes
16
17 Encoders:
18 cerberus (9) - Idle
19 cerberus (12) - Idle
20
21 Scheduled Recordings:
22 2007-12-12 18:00:00 - 3 News
23 2007-12-12 20:00:00 - Scrubs
24 2007-12-13 18:00:00 - 3 News
25 2007-12-13 20:30:00 - McLeod's Daughters
26 2007-12-13 22:05:00 - 30 Rock
27 -- End --
28
29 And when recording (and with a storage group running low on space):
30
31 -- Begin --
32 MythTV status for localhost
33 ===========================
34 Status...........: Wed Dec 12 2007, 6:30 PM
35 Total Disk Space.: Total space is 102,350 GB, with 73,410 GB used (71.7%)
36
37 Encoders:
38 cerberus (9) - Recording
39 cerberus (12) - Idle
40
41 Recording Now:
42 3 News (Ends: 2007-12-12 19:00:00)
43
44 Scheduled Recordings:
45 2007-12-12 20:00:00 - Scrubs
46 2007-12-13 18:00:00 - 3 News
47 2007-12-13 20:30:00 - McLeod's Daughters
48 2007-12-13 22:05:00 - 30 Rock
49
50 Disk Space:
51 Total space for group 2 is 20,746 GB, with 20,101 GB used (96.9%)
52 -- End --
53
54 Why this tool?
55 --------------
56 Well, as you can see above Grey's Anatomy is currently being recorded
57 at 1:30 PM.  My wife and I sat down to watch one of these episodes (yes
58 they're repeats, we've only just discovered Grey's Anatomy so repeats
59 are good) and one of them was very jumpy.  It was pretty obvious the
60 server was under load.  My wife was a little annoyed when I admitted
61 that I was probably compiling a new kernel at the time.
62
63 I wrote this script to notify me when I login about any work that MythTV
64 might be wanting to do in the next little while (or currently) so we
65 won't have any repeats of the Grey's Anatomy incident.