WebOS Internals - User contributions [en]

HitchhikersGuide

2009-09-12T00:02:05Z

K4p741nkrunch: /* Installing WebOS Quick Install */

== Palm Pre Hitchhikers Guide ==
=== Making it Hackable ===
==== Enable Developer Mode ====
# From the Pre home screen, without any apps open, simply start typing and type: upupdowndownleftrightleftrightbastart
# Click on "Developer Mode Enabler"
# Slide "Developer Mode" to ON
# Click "Reset the Device." This just reboots the device. Why they chose the word "Reset" is a mystery.
==== Installing WebOS Quick Install ====
You will need Preware which is an application management suite. To install Preware (as well as other applications), you will need WebOS Quick Install, which is a Java application that talks to the Pre.

# Go to http://forums.precentral.net/homebrew-apps/194832-webos-quick-install.html
# At the bottom of the first post, there is an "Attached Files" section. Click on the WebOSQuickInstall.jar link. You will need to register for the forum system (Ugh! But oh well).
# Once you're registered, save the file WebOSQuickInstall.jar to some directory on your computer.
# Download http://palm.cdnetworks.net/rom/pre_p100eww/webosdoctorp100ewwsprint.jar
# Place this file in the same directory as WebOSQuickInstall.jar
# Rename webosdoctorp100ewwsprint.jar to WebOSDoctor.jar
# For Windows 7:
## Follow the instructions here: http://www.webos-internals.org/wiki/Novacom_with_Windows_7
## When you run NovacomInstaller*.msi, it won't really say "finished installing" or anything like that, but novacomd.exe is running.

==== Installing Preware ====
(See also http://www.webos-internals.org/wiki/Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method)
# Attach your Pre with a USB cable to your computer. Choose "Just Charge." Even though it's "just charging," the computer has access to the device.
# Double click on WebOSQuickInstall.jar
# On first launch, there will be a first-time setup popup asking which device you want to use. Choose "USB Device" which is the Pre.
# On the right, there are 3 buttons, a plus, a minus, and harddrive with a green arrow. The harddrive button is a "Download Apps" button. Click this.
# From the drop down at the top, choose "WebOS-Internals Feed (all)"
# Check "Package Manager Service" and click Download
# Click Close
# Click Install
# Click the download button again
# Check "Preware" and click Download
# Click Close
# Click Install
=== Hacking ===
You must first install the terminal application before doing anything else.
==== Install a Terminal Application ====
# Open WebOSQuickInstall.jar
# Click the download button
# From the drop down, select "WebOS-Internals Feed (Pre)"
# Check "Terminal Service Plugin"
# Click Download
# Click Close
# Click Install
# Click the download button
# From the drop down, select "WebOS-Internals Feed (all)"
# Check "Terminal"
# Click Download
# Click Close
# Click Install
# See [[Application:Terminal]] for information and key combos.

==== First Steps ====
Summarized from [[Next steps]]
# Open Terminal
# cd /tmp
# wget http://tinyurl.com/n8q2vy
## (Alternatively http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/optware-bootstrap.sh)
# mv n8q2vy optware-bootstrap.sh
# sh optware-bootstrap.sh
## Choose a user name which you will later use to be able to ssh into your Pre.
## You may get a "bad password" warning if you typed in a weak password. This is not a critical error, you can continue re-typing your password the second time to confirm it. You can always change it later with passwd $USER
# source /etc/profile.d/optware

==== Install Bash ====
Summarized from [[Setup Bash]]
# ipkg-opt install bash
# There is no way at this time to type the backslash (\), so it's best to use vi to edit /etc/shells
# Put this into /etc/shells:
<code>
/bin/ash<br />
/bin/sh<br />
/opt/bin/bash<br />
</code>
# Change your default shell to /opt/bin/bash by editing the last portion for your user (and for root) in /etc/passwd

==== SSH into your Pre ====
# ssh -p 222 $USER@$IP
## Note that it is port 222, not the normal 22
## Use putty on Windows: http://www.chiark.greenend.org.uk/~sgtatham/putty/
## You can find your IP on your Pre with: ifconfig | grep addr:

=== Searching for applications to install ===
* sudo ipkg-opt list | grep ftp

=== Installing applications ===
* sudo ipkg-opt install $APP

=== Tweaking the UI ===
* Run WebOS Quick Install
* Click Tools -> Tweaks
* Any time you check or uncheck something, the Pre UI will reload. This takes some time, and when it comes back you have to re-click "Just Charge."
* Suggestions
** Squarify the screen (for the Terminal)

=== Tips ===
* Copy one or more files to the Pre
<code>
scp -P 222 $LOCALFILE $USER@$IP:/var/home/$USER
</code>
* If you're SSHed into your Pre and you want to watch its CPU or memory as you do things, on your pre type:
<code>
watch vmstat 2 5
</code>

Packaging Standards

2009-08-31T08:55:01Z

K4p741nkrunch:

This page will document the agreed packaging standards for webOS homebrew ipkg files and open standard ipkg feeds.

{|class="wikitable" height:200px" border="1"
! width="140" | Name
! width="350" | Definition
|-
| Size || Package size (in KB)
|-
| Status || Installed/Not-installed (and other stuff we don't use)
|-
| Architecture || All, armv7, or i686
|-
| Section || The category when there is no source data
|-
| Package || Package name in reverse-dns style
|-
| Filename || Actual name of .ipk file
|-
| Depends || Actual package names of dependencies (comma-space separated, ignore contents of () at the end)
|-
| Maintainer || Group or individual responsible for maintenance
|-
| Version || In x.y.z or w.x.y.z format
|-
| Description || Title of the package
|-
| MD5Sum || MD5 checksum of package to verify downloaded file
|-
| Installed-Time || Timestamp of installation
|-
| Installed-Size || Size of installed package
|-
| Source || *See lower table*
|}

{| class="wikitable" border="1"
| valign="top" | Source
{| class="wikitable" width="200"; border="1"
| Title || Actual title of application
|-
| Source || Where to obtain source code
|-
| LastUpdated || Timestamp of last update
|-
| Feed || Package source feed
|-
| Type || Application, service, or plugin
|-
| Category || Package category
|-
| Homepage || URL to package homepage
|-
| Icon || URL to icon image (assumed to be 64x64)
|-
| FullDescription || Actual description of package (includes html?)
|-
| Screenshots || Array of URLs
|-
| License || Package license conditions
|-
|}

Packaging Standards

2009-08-31T08:44:28Z

K4p741nkrunch:

This page will document the agreed packaging standards for webOS homebrew ipkg files and open standard ipkg feeds.

{|class="wikitable" height:200px" border="1"
! width="140" | Name
! width="350" | Definition
|-
| Size || Package size (in KB)
|-
| Status || Installed/Not-installed (and other stuff we don't use)
|-
| Architecture || **
|-
| Section || The category when there is no source data
|-
| Package || Package name in reverse-dns style
|-
| Filename || Actual name of .ipk file
|-
| Depends || Actual package names of dependencies (comma-space separated, ignore contents of () at the end)
|-
| Maintainer || Group or individual responsible for maintenance
|-
| Version || In x.y.z or w.x.y.z format
|-
| Description || Title of the package
|-
| MD5Sum || MD5 checksum of package to verify downloaded file
|-
| Installed-Time || Timestamp of installation
|-
| Installed-Size || Size of installed package
|-
|}

{| class="wikitable" border="1"
| valign="top" | Source
{| class="wikitable" width="200"; border="1"
| Title || Actual title of application
|-
| Source || Where to obtain source code
|-
| LastUpdated || Timestamp of last update
|-
| Feed || Package source feed
|-
| Type || Application, service, or plugin
|-
| Category || Package category
|-
| Homepage || URL to package homepage
|-
| Icon || URL to icon image (assumed to be 64x64)
|-
| FullDescription || Actual description of package (includes html?)
|-
| Screenshots || Array of URLs
|-
| License || Package license conditions
|-
|}

Packaging Standards

2009-08-31T08:35:32Z

K4p741nkrunch:

This page will document the agreed packaging standards for webOS homebrew ipkg files and open standard ipkg feeds.

{|class="wikitable" height:200px" border="1"
! width="140" | Name
! width="350" | Definition
|-
| Size || Package size (in KB)
|-
| Status || Installed/Not-installed (and other stuff we don't use)
|-
| Architecture || **
|-
| Section || The category when there is no source data
|-
| Package || Package name in reverse-dns style
|-
| Filename || Actual name of .ipk file
|-
| Depends || Actual package names of dependencies (comma-space separated, ignore contents of () at the end)
|-
| Maintainer || Group or individual responsible for maintenance
|-
| Version || In x.y.z or w.x.y.z format
|-
| Description || Title of the package
|-
| MD5Sum || MD5 checksum of package to verify downloaded file
|-
| Installed-Time || Timestamp of installation
|-
| Installed-Size || Size of installed package
|-
| valign="top" | Source
|
{| class="wikitable" width="200"; height:200px" border="1"
| Title || Actual title of application
|-
| Source || Where to obtain source code
|-
| LastUpdated || Timestamp of last update
|-
| Feed || Package source feed
|-
| Type || Application, service, or plugin
|-
| Category || Package category
|-
| Homepage || URL to package homepage
|-
| Icon || URL to icon image (assumed to be 64x64)
|-
| FullDescription || Actual description of package (includes html?)
|-
| Screenshots || Array of URLs
|-
| License || Package license conditions
|-
|}
|}

Icons

2009-08-23T22:27:06Z

K4p741nkrunch: /* Just Talk Below */

== This is a Thinking Page at the Moment ==

Trying to decide a way to bring the webOS-Internals ecosystem together through their icons.

The current idea I've been throwing around is to use an "ice" platform.

== webOS-Internals Icons (more will be added shortly) ==

{{icon|Icon_WebOSInternals_Base.png}}
{{icon|Icon_WebOSInternals_Base_Plugin.png}}
{{icon|Icon_WebOSInternals_Box.png}}
{{icon|Icon_WebOSInternals_Box_Empty.png}}
{{icon|Icon_WebOSInternals_Box_Tux.png}}
{{icon|Icon_WebOSInternals_Terminal.png}}
{{icon|Icon_WebOSInternals_Keyboard.png}}
{{icon|Icon_WebOSInternals_LED.png}}

<div style="clear:both;"></div>

== Other Icons ==

{{icon|Icon_Box.png}}
{{icon|Icon_Box_Arrow.png}}

<div style="clear:both;"></div>

== Icons For other Applications (for reference only) ==

{{icon|Icon_Reversi.png}}
{{icon|Icon_Airplane.png}}

<div style="clear:both;"></div>

== Small Icons ==

{{icon|Icon_WebOSInternals_Plugin_Small.png}}
{{icon|Icon_WebOSInternals_Installed_Small.png}}
{{icon|Icon_WebOSInternals_Updates_Small.png}}
{{icon|Icon_WebOSInternals_Service_Small.png}}
<div style="clear:both;"></div>

== Just Talk Below ==
The question right now is for the Service icon do we use "Wrench" or "Gear" (votes are below)

- 4 - "Gear" - AnOutSider, Templarian, RickHasABoat, Oil<br/>
- 2 - "Wrench" - PuffTheMagic, k4p741nkrunch