MiniMyth from minimyth.org
Use Instructions
General

Control

Control using a Remote Control

The normal method for controlling MiniMyth is through a remote control. If you have not already done so, please the LIRC configuration variables' section of minimyth.conf for instructions on how to configure your specific remote.

Control using VNC

For some of the entries in the Myth setup menus, it is easier to use a keyboard than a remote control. While MiniMyth supports connecting a keyboard and mouse, it is often physically difficult to do so. Therefore, MiniMyth support controlling the MiniMyth GUI using VNC.

In general, VNC enables a client to connect to either the real X display or a virtual X display. By connecting to the real X display, a VNC client can control the X session running on the remote machine's console. By connecting to a virtual X display, a VNC client can have its own X session. Since MiniMyth uses VNC as a method for remotely controlling the MiniMyth system, MiniMyth uses a VNC server that connects the VNC client to the real X display.

When security is enabled (see 'MM_SECURITY_ENABLED'), then VNC is available on localhost but not on any other address. Therefore, when security is enabled, VNC can only be accessed by port forwarding over SSH.

Access

Access using a Virtual Console

Normally, MiniMyth does not start a virtual console. However, when MiniMyth detects an error when booting (i.e. during init), MiniMyth starts a virtual console to ease debugging. In addition, when security is disabled (see 'MM_SECURITY_ENABLED'), MiniMyth starts a virtual console. If you have a keyboard connected, then you can switch to the virtual console using the key sequence 'Ctrl+Alt+F1'.

There are two users that can connect using the virtual console: 'minimyth' and 'root'. Neither user requires a password.

The user 'minimyth' is a restricted access user that MiniMyth uses to run the X window system (i.e. xinit) and X applications (e.g. mythfrontend, mythtv, mplayer, vlc, x11vnc and xine). Since many applications look for their configuration relative to the user's home directory, and since some applications behave differently depending on user's access rights, it is important that you run the X windows system and the X applications as the correct user.

The user 'root' is the root user. You may wish to log in as the user 'root' when you need access beyond the access allowed the user 'minimyth'. For example, some files can only be written or read as the user 'root'.

Access using Telnet

Normally, MiniMyth does not start a telnet server. However, when MiniMyth detects an error when booting (i.e. during init), MiniMyth starts a telnet server to ease debugging. In addition, when security is disabled (see 'MM_SECURITY_ENABLED'), MiniMyth starts a telnet server.

There are two terminal types that MiniMyth can understand: 'linux' and 'xterm'. Therefore, be sure that the terminal you are using emulates one of those terminal types.

There are two users that can connect using telnet: 'minimyth' and 'root'. Neither user requires a password.

Access using SSH

If you have enabled the SSH server, then MiniMyth provides access using ssh. During normal operation, there is no reason to need ssh access to MiniMyth. However, ssh access can be very useful when customizing or debugging MiniMyth.

There is one user that can connect using ssh: 'root'. When connecting as user 'root', you must present a identity file authorized in the authorized_keys configuration file.

If you need to perform a task as the user 'minimyth' (e.g. restart X), then you will need to su to the user 'minimyth' using the command 'su - minimyth'.

Access using HTTP

MiniMyth provides access to the MiniMyth web pages using HTTP. The MiniMyth web pages are accessible by connecting to port 80 (the default HTTP port) using HTTP. These web pages include status information, software version information and MiniMyth documentation. Unlike the MiniMyth documentation on www.minimyth.org, the MiniMyth documentation available through the MiniMyth web pages is sure to correspond to the version of MiniMyth that is running.

When security is disabled (see 'MM_SECURITY_ENABLED'), MiniMyth provides access to the MiniMyth file system using HTTP. The MiniMyth file system is accessible by connecting to port 8080 using HTTP. This allows you to view any file using a web browser (e.g. Firefox) or download any file using a web download client (e.g. wget).