Mythwelcome

From MythTV Official Wiki
Revision as of 13:53, 8 March 2006 by 209.123.8.145

Jump to: navigation, search

A new addition in 0.19. This utility program displays a myth themed dialog which shows a welcome/status information screen that is designed to be shown whenever the frontend is not running.

The mythWelcome Screen

This has been introduced for those people that want to use scheduled wakeup and shutdown to record scheduled shows to save on power consumption. Prior to this the Frontend would always start up which in turn meant that the backend would never shutdown when the recording had finished thus defeating the whole purpose.

The Welcome screen will show the status of the backend and wait for you to manually start the frontend with your remote

Configuration

REALLY-QUICK START

If you're in a desperate hurry:
 	
 	Run mythwelcome --setup and edit the settings to suit your setup.
 	
 	Change your system startup to run mythwelcome instead of mythfrontend.
 	
 	Change the Shutdown/Wakeup Options in mythtv-setup to call the mythshutdown
 	program.
 	
	And if you start wondering why it doesn't work, come back and read the
 	rest of the file. 8)
 	
 	WHAT IS MYTHWELCOME
 	===================
 	
 	MythWelcome is a Myth themed application that shows a welcome/status
 	information screen that will be shown whenever the frontend is not
 	running ie. when an automatic startup has occurred to record a program.
	It shows some information about what the backend is currently doing
	(idle, recording, commercial flagging, transcoding or locked by a user etc.).
	It also shows what the backend is recording, what the next scheduled recording
 	is and shows a warning if there are any schedule conflicts. There is also a
 	push button to start the frontend.
 	
	It is useful if you want to setup a dedicated MythTV system that you
 	don't want to run 24/7 but you want to automatically wake up to record
 	just like a normal video recorder and shutdown again when it is idle.
 	
 	Mythwelcome will also prevent the backend from shutting down the system
 	if it is busy commercial flagging, downloading EPG data, transcoding or
 	shutdown has been locked by a user.
 	
 	PREREQUISITES
 	=============
 	
 	You should have already installed and have a working nvram-wakeup
 	setup including modifying your bootloader menu to add a Poweroff
 	menu option if your bios requires a reboot when setting the wakeup
 	time in the bios.
 	
 	 
 	Mythwelcome/Mythshutdown Settings
 	=================================
 	
	Like most of MythTV Mythwelcome and Mythshutdown store their settings
 	in the myth database. All of the settings are settable from the GUI.
 	There are two separate settings pages. One is shown by starting
	mythwelcome with the -s/--setup parameter or by pressing the
	'SHOWSETTINGS' key (defaults to F11 key). You will probably only ever
	set these options once when you first setup Mythwelcome.
	
	nvram-wakeup command -  command to set wakeup time in bios
	                       
	                        if you are really lucky nvram-wakeup will be able
	                        to recognise your M/B automatically
	                        "/usr/sbin/nvram-wakeup"
	
	                        if you need to explicitly set the info-writer use
	                        something like this
	                        "/usr/sbin/nvram-wakeup -A -I aopen_ax37"
 	
 	                        if you need to use a custom config file use something
 	                        like this
 	                        "/usr/sbin/nvram-wakeup -A -C /etc/nvram-wakeup.conf"
 	
 	nvram-wakeup restart  - command to set which bootloader menu option to use
 	command                 after next reboot. This command is run if your bios
 	                        requires you to reboot to allow nvram-wakeup settings
 	                        to take effect.
 	
 	                        older versions of grub require something like this
 	                        "echo 'savedefault --default=1 --once quit' | /sbin/grub"
 	                       
 	                        newer versions of grub can use something like this
 	                        "grub-set-default 1"
 	                       
 	                        lilo users should use something like this
 	                        "lilo -R PowerOff"       
 	                       
 	Poweroff Command      - The command mythshutdown should use to poweroff the computer.
 	
 	Reboot Command        - The command mythshutdown should use to reboot the computer.
 	                        Used when your BIOS requires a reboot to allow nvram-wakeup
 	                        settings to take effect.
 	
 	Start XTerm Command   - This is the command to use to open an XTerm window.
 	                        Leave blank to disable this feature.
 	                        Tip: If the default font size is too small to see on your
 	                        TV change the default setting to:
 	                        'xterm -fa Courier -fs 14' to change the font style and size.   
 	
 	Start Frontend Command - This is the command mythwelcome should use to start the FE. It
 	                         is usefull if you want to change the verbose level or add a log
 	                         file to output message etc.
 	
 	The second set of settings are available by pressing 'i/INFO' key and allow you
 	to setup the daily wakeup/shutdown periods and control whether to automatically
	start the mythfrontend when mythwelcome is started and it is determined that it
	was started manually.
	
	Period 1 Start Time  - These setting determine a period of time that the master backend
	Period 1 End Time      should always wake up for. Set both times to 00:00 to
	                       disable this feature.
	
	Period 2 Start Time  - Second wakeup/shutdown period settings.                   
 	Period 2 End Time   
 	
 	Automatically Start  - Normally when mythwelcome starts up it checks to see whether
	Mythfrontend           the system was started to record something or because of a
	                       wakeup/shutdown period. If not it will automatically start the
	                       frontend. You can disable this feature by unchecking this option.   
	
	Shutdown with Master - (Frontend only machines). If set mythwelcome will shutdown this system
	Backend                when the master backend shutsdown.
 	
 	
 	MYTHBACKEND SETUP OPTIONS
	=========================
 	
 	The mythbackend needs to co-operate with mythwelcome to work
 	as intended. It does this by calling the helper program 'mythshutdown'
 	to check whether it is safe to shutdown, to set the time to wake up
	for the next scheduled recording and to do the actual shutdown.
 	
	You should run mythtv-setup and on the Shutdown/Wakeup Options page set
	the following settings: 
	
	    Block shutdown before
	    client connected:           should be checked
	    Idletimeout (secs):         any value greater that 0
	    Wakeup time format:         yyyy-MM-ddThh:mm
	    Set wakeup time command:    mythshutdown --setwakeup $time
	    Server Halt command:        mythshutdown --shutdown
	    Pre shutdown check command: mythshutdown --check 
	
	Because 'mythshutdown --shutdown' needs to run grub/lilo, reboot, poweroff
	and nvram-wakeup all of which require root privileges if you don't run the mythbackend
	as root you will have to use sudo to give mythshutdown root privileges and change the
	Server Halt command to 'sudo  mythshutdown --shutdown'.
	
	You will have to restart the backend for the new settings to take effect.
	
 	BOOTLOADER SETUP
	================
	
	If your motherboard/bios requires a reboot after changing the startup time
	in the bios with nvram-wakeup you should configure grub/lilo with a special
	menu boot option to reboot and immediately shutdown.
	
	Grub Users Only
	---------------
	Simply add the following menu boot option to your grub.conf file:
	
	    title=PowerOff
	        savedefault 0
	        halt
	
 	You should change the '0' to the menu item number you want to boot
 	normally by default. Also add 'default saved' towards the top of the file.
 	
	set the nvram-wakeup restart command to '/sbin/grub-set-default 1'
 	the 1 should be the menu item number of the PowerOff menu item you added
 	above starting from 0.
 	
	Lilo Users Only
 	---------------
 	As part of nvram-wakeup you can download some kernel images
 	that do nothing but shutdown the system. (see
	http://sourceforge.net/project/showfiles.php?group_id=35022