Difference between revisions of "Application:Terminal"

Revision as of 06:09, 25 July 2009

« Go Back to the Utilities application list

Terminal - Version: Pre-Alpha

A terminal program in mojo that runs on the Pre

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

To enable full screen apps, type export TERM=vt100 and press enter. This will be included in a later release. Note that the case of that command is important. Note also that if you try to run something like vi without it, you will get a screen full of gibberish.

To send an esc type orange-space. To send a tab use SYM-I -- tab is just a control-i the sym key is the control key. There is not yet a keymap for.

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.)

Known bugs

The , (comma) key does not work. orange-command is _ underscore - also broken as is typing the @ sign.

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

I can't get the u key to work it replace it with a y. I have only tried on emulator.

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: