Captain Shell Plugin

[Dreamboxer]

================================================== =
Shell Plugin for Dreambox 7025
Version 4.0.0 by gutemine
================================================== =

Unpack the shellXX.zip on a PC (replace XX with
current versionnumber) when you have not downloaded
the plugin from Blue Pannel already.
Then simply FTP the shellXX.tar.bz2 kit to
/var/tmp of the Dreambox and then
use Manual Install in Blue Pannel of your image
and then restart enigma or reboot.

If no Blue Pannel is available in your image,
or it doesn't work to install the kit from there,
then simply type the following in a telnet session
after copying the kit file to /var/tmp via FTP:

cd /
bunzip2 /var/tmp/shellXX.tar.bz2
tar -xvf /var/tmp/shellXX.tar
killall enigma2

After this the Shell addon should show up in
Games / Plugins and can be used - menu commands
are more or less selfexplaining. If you don't know
what the commands are meaning check a Unix shell
command guide BEFORE executing them !

Usage of shell plugin
---------------------

You can pass only 1 command per shell execution
(no ; allowed) and no # allowed within the command.
But the shell plugin will remember the path
between executions !
Off course no commands are allowed which
don't terminate (like vi, more, top,...) or
need further input during execution
(ping is possible but limited by the plugin
to 10 cycles).

Execute the command exit or logout at the
end of your shell execution session or it will
remember you last working directory until
next execution. But this could be usefull to
allways start at /media/hdd for example !

Default directory is /, but the plugin
remembers the directory if you do cd.

In Gemini Image for example /usr/script is
interesting (cd /usr/script) to make an ls
and execute some of the scripts
there, or cronmanager also includes some
example scripts at /etc/cron/examples.

The current version now also contains a
lot of usefull commands grouped by subject
(Directory, System, Disk, Archive...)
in special wizzards to reduce
your typing effort !

My diskdoctor script for doing an fsck
of the harddisk is now also included.

User Commands
-------------

You can now also specify up to 14 user
specific commands (your personal favourites)
by editing a commands.lst file in the
/usr/lib/enigma2/python/Plugins/Extensions/Shell
directory.

Better do this with an unix conform editor !

Keymap switcher
---------------

You can now switch to up to 14 alternate
keymap.xml files (only 3 examples are included):

keymaps_usbkeyshell.xml

This keymap from Einsteini gives you
improved support for the USB Keyboard when
entering commands in the shell
plugin via USB keyboard.

keymaps_neutrinozapp.xml

This keymap from InsideTV and theflashor23 gives
you neutrino style zapping for the remote control
(as far as I know it works only with Gemini 15)

2x right or left = optionchannels
then right and left choose optionchannels
right/left switch trough bouquet
up/down = zapping

keymaps_usbkeyenigma.xml

This Keymap from DonHora should give you control
of enigma menus via USB keyboard instead of remote

If there are new or updated keymaps available
from the authors simply copy
them with the name keymap_*.xml to
/usr/lib/enigma2/python/Plugins/Extensions/Shell/keymaps

They should show then up in the alternate keymap
choosing menu next time you call the plugin.

Some typing tipps with remote control
-------------------------------------

You reach / and - for your shell commands by pressing 0
multiply, and delete is the speaker off button
(logically isn't it ?)

After entering the command be patient until pressing OK
(cursor has to come back blinking), otherwiese enigma
will crash (not my fault, ask DM !?)

================================================
Have Fun Executing Shell commands with your
Remote control at your DM 7025 !
================================================