Application:Terminal

« Go Back to the Utilities application list

Terminal - Version: Pre-Alpha 0.1.2 (7/25/2009) (second public release)

Status

This is early-alpha software. Consider yourself lucky if it works at all. Many people have put many hours of hard work in to get just this far - respect that effort when making comments and suggestions.

License

Please be aware that org.webosinternals.terminal and x-webosinternals-termplugin are licensed under the GPLv2.

They cannot be used by a closed source application. If you want to use them in a non-GPLv2 but otherwise open source application, please contact the authors.

Operating notes

Non-obvious keys:

Desired	On Pre
Control	Sym
Esc	Orange-Space
Tab	Sym-I

(Sym is Control and Control I is the standard tab code)

Rotating the pre will take the terminal to landscape mode. The keyboard will not rotate with you. Attempting to rotate the keyboard to landscape mode is known to bork a Pre.

Shell commands with lots of output will roll off the screen. To scroll the screen, flick the screen. (Hint, it's a Pre app.)

Support for both "linux" and "vt100" term types should now be supported, so an export TERM line should no longer be needed. If you find your screen filling with gibberish that looks like ANSI codes, however, make sure you're using 0.1.2 or later version, and report here or in the IRC channel what you were running in the terminal that caused the issue.

If you do see odd behavior, you can force the more compatible vt100 terminal type by typing:

export TERM=vt100

(followed by enter) Note that the case of that command is important.

Known bugs

Remember, this is early alpha software. You're lucky it works at all.

As of 0.1.2 (7/25/2009), all reported bugs have been fixed. That does not mean that there aren't plenty of bugs still around. Please find them and report them here.

Some limitations: Many keys are not implemented. We're working on it, maybe even as you read this. :)

Y and U:

If you run the terminal in the emulator provided with the Palm webOS SDK 1.1, be aware that a bug in the emulator causes the keys for U and Y to both send the raw keycode for the button Y. You can see the same result in Device Info, More Info, Preferences, Interactive Tests, Hardware Buttons. This is not a bug in the Terminal application.

Installation

Do not stray from or vary these instructions. If you don't do it all, in precisely the right order, with zero mistakes, it's not going to work. Copy & Paste will be your friend.

You need to be logged in as root with a writeable filesystem. Instructions for both those things can be found elsewhere on this wiki.

<source lang="text"> mkdir -p /var/etc/ipkg/ ln -s /etc/ipkg/arch.conf /var/etc/ipkg/ echo "src/gz all http://ipkg.preware.org/feeds/preware/all" > /var/etc/ipkg/preware.conf </source>

If you are on the Pre, type:

<source lang="text"> echo "src/gz armv7 http://ipkg.preware.org/feeds/preware/armv7" >> /var/etc/ipkg/preware.conf </source>

If you are on the Emulator, type:

<source lang="text"> echo "src/gz i686 http://ipkg.preware.org/feeds/preware/i686" >> /var/etc/ipkg/preware.conf </source>

Then type:

<source lang="text"> /usr/bin/ipkg -o /var update /usr/bin/ipkg -o /var install x-webosinternals-termplugin ln -s /var/usr/lib/BrowserPlugins/termplugin.so /usr/lib/BrowserPlugins/ /usr/bin/ipkg -o /var install org.webosinternals.terminal </source>

Then refresh the GUI to show your new app:

<source lang="text"> luna-send -n 1 palm://com.palm.applicationManager/rescan {} </source>

If you performed an upgrade and aren't seeing the changes, restart the GUI service:

<source lang="text"> initctl stop LunaSysMgr && initctl start LunaSysMgr </source>

If the above two fail to show the results you're expecting, reboot the device.

Other PreWare Applications

Note that you can use the same commands to install other applications from PreWare:

<source lang="text"> /usr/bin/ipkg -o /var update /usr/bin/ipkg -o /var list /usr/bin/ipkg -o /var install <package> # choose a package from the list /usr/bin/ipkg -o /var remove <package> </source>

Removal

You need to be logged in as root with a writeable filesystem. Instructions for both those things can be found elsewhere on this wiki.

<source lang="text"> rm /usr/lib/BrowserPlugins/termplugin.so /usr/bin/ipkg -o /var remove org.webosinternals.terminal /usr/bin/ipkg -o /var remove x-webosinternals-termplugin rm /var/etc/ipkg/preware.conf </source>

Then refresh the GUI to remove the icon: