WebOS Internals - User contributions [en]

Webos SDK Versions

2019-01-19T01:30:12Z

Bbito: /* How to get webOS SDKs */

== How to get webOS SDKs ==

As of late 2014 the Palm hosted SDK downloads are no longer directly accessible from their original URLs unless the accessing computer's [https://en.wikipedia.org/wiki/Hosts_(file) HOSTS file] has been edited to include the following entry:
23.4.17.24 cdn.downloads.palm.com # webOS SDK downloads

'''''NOTE: The HOSTS file must be edited with elevated permissions, e.g. SU on Linux/Unix or Administrator mode on Windows'''''

The remaining original palm.com domain links are working as of 18 January 2019 with the above HOSTS file alteration.

== Download links ==

=== 1.1 ===
==== Windows ====
* http://cdn.downloads.palm.com/sdkdownloads/1.1/sdkBinaries/Palm_Mojo_SDK-Win-1.1.0-sdk62-build08.exe

==== OSX ====
* http://cdn.downloads.palm.com/sdkdownloads/1.1/sdkBinaries/Palm_Mojo_SDK-Mac-1.1.0-sdk62-build08.pkg

==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.1.0.19/sdkBinaries/palm-sdk_1.1.0-svn189487-sdk67-pho19_i386.deb

=== 1.2 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.2.0.33/sdkBinaries/palm-sdk_1.2.0-svn202408-sdk77-pho33_i386.deb

=== 1.3.1 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.3.1.314/sdkBinaries/palm-sdk_1.3.1-svn222348-sdk100-pho314_i386.deb

=== 1.3.5 ===
==== Windows ====
* http://cdn.downloads.palm.com/sdkdownloads/1.3.5.368/sdkBinaries/Palm_Mojo_SDK-Win-1.3.5-368-x86.exe

==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.3.5.368/sdkBinaries/palm-sdk_1.3.5-svn234138-sdk117-pho368_i386.deb

=== 1.4.0 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.4.0.420/sdkBinaries/palm-sdk_1.4.0-svn263907-sdk1428-pho420_i386.deb

=== 1.4.1 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.4.1.427/sdkBinaries/palm-sdk_1.4.1-svn274946-sdk1436-pho427_i386.deb

=== 1.4.5 ===
==== Windows ====
* http://cdn.downloads.palm.com/sdkdownloads/1.4.5.465/sdkBinaries/Palm_webOS_SDK-Win-1.4.5-465-x86.exe

==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.4.5.465/sdkBinaries/palm-sdk_1.4.5-svn307799-sdk1457-pho465_i386.deb

=== 2.1 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-sdk_2.1.0-svn409992-pho519_i386.deb
* (samples) http://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/webos-sdk-docs-samples-2.1.519.zip

=== 3.05 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/3.0.5.676/sdkBinaries/palm-sdk_3.0.5-svn528736-pho676_i386.deb

==== Windows 64 bit ====
* http://cdn.downloads.palm.com/sdkdownloads/3.0.5.676/sdkBinaries/HP_webOS_SDK-Win-3.0.5-676-x64.exe

==== Windows 32 bit ====
* http://cdn.downloads.palm.com/sdkdownloads/3.0.5.676/sdkBinaries/HP_webOS_SDK-Win-3.0.5-676-x86.exe

==== OSX ====
* http://cdn.downloads.palm.com/sdkdownloads/3.0.5.676/sdkBinaries/Palm_webOS_SDK.3.0.5.676.dmg

== Emulator image download links ==
=== 1.3.5 Emulator Image (159MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%201.3.5.368.vmdk.zip

=== 1.4.0 Emulator Image (157MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%201.4.0.420.vmdk.zip

=== 1.4.1 Emulator Image (158MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%201.4.1.427.vmdk.zip

=== 1.4.5 Emulator Image (157MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%201.4.5.465.vmdk.zip

=== 2.1.0 Emulator Image (139MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%202.1.0.519.vmdk.zip

=== 2.2.0 Emulator Image (Pre3) (155MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK-2210.vmdk.zip

=== 2.2.4 Emulator Image (Pre2 and Pre3) (176MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK-2222.vmdk.zip

Webos SDK Versions

2019-01-19T01:08:22Z

Bbito: Add HOSTS file info, change https to http, test links and add later SDKs and Emulator Images

== How to get webOS SDKs ==

As of late 2014 the Palm hosted SDK downloads are no longer directly accessible from their original URLs unless the accessing computer's [https://en.wikipedia.org/wiki/Hosts_(file) HOSTS file] has been edited to include the following entry:
23.4.17.24 cdn.downloads.palm.com # webOS SDK downloads

'''''NOTE: The HOSTS file must be edited with elevated permissions, e.g. SU on Linux/Unix or Administrator mode on Windows'''''

The remaining original palm.com domain links are working as of 18 January 2019 with the above HOSTS file alteration, however many of the older versions are no longer hosted by Palm's servers and these have been struck-through but remain for reference.

== Download links ==

=== 1.1 ===
==== Windows ====
* http://cdn.downloads.palm.com/sdkdownloads/1.1/sdkBinaries/Palm_Mojo_SDK-Win-1.1.0-sdk62-build08.exe

==== OSX ====
* http://cdn.downloads.palm.com/sdkdownloads/1.1/sdkBinaries/Palm_Mojo_SDK-Mac-1.1.0-sdk62-build08.pkg

==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.1.0.19/sdkBinaries/palm-sdk_1.1.0-svn189487-sdk67-pho19_i386.deb

=== 1.2 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.2.0.33/sdkBinaries/palm-sdk_1.2.0-svn202408-sdk77-pho33_i386.deb

=== 1.3.1 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.3.1.314/sdkBinaries/palm-sdk_1.3.1-svn222348-sdk100-pho314_i386.deb

=== 1.3.5 ===
==== Windows ====
* http://cdn.downloads.palm.com/sdkdownloads/1.3.5.368/sdkBinaries/Palm_Mojo_SDK-Win-1.3.5-368-x86.exe

==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.3.5.368/sdkBinaries/palm-sdk_1.3.5-svn234138-sdk117-pho368_i386.deb

=== 1.4.0 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.4.0.420/sdkBinaries/palm-sdk_1.4.0-svn263907-sdk1428-pho420_i386.deb

=== 1.4.1 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.4.1.427/sdkBinaries/palm-sdk_1.4.1-svn274946-sdk1436-pho427_i386.deb

=== 1.4.5 ===
==== Windows ====
* http://cdn.downloads.palm.com/sdkdownloads/1.4.5.465/sdkBinaries/Palm_webOS_SDK-Win-1.4.5-465-x86.exe

==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/1.4.5.465/sdkBinaries/palm-sdk_1.4.5-svn307799-sdk1457-pho465_i386.deb

=== 2.1 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-sdk_2.1.0-svn409992-pho519_i386.deb
* (samples) http://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/webos-sdk-docs-samples-2.1.519.zip

=== 3.05 ===
==== Linux ====
* http://cdn.downloads.palm.com/sdkdownloads/3.0.5.676/sdkBinaries/palm-sdk_3.0.5-svn528736-pho676_i386.deb

==== Windows 64 bit ====
* http://cdn.downloads.palm.com/sdkdownloads/3.0.5.676/sdkBinaries/HP_webOS_SDK-Win-3.0.5-676-x64.exe

==== Windows 32 bit ====
* http://cdn.downloads.palm.com/sdkdownloads/3.0.5.676/sdkBinaries/HP_webOS_SDK-Win-3.0.5-676-x86.exe

==== OSX ====
* http://cdn.downloads.palm.com/sdkdownloads/3.0.5.676/sdkBinaries/Palm_webOS_SDK.3.0.5.676.dmg

== Emulator image download links ==
=== 1.3.5 Emulator Image (159MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%201.3.5.368.vmdk.zip

=== 1.4.0 Emulator Image (157MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%201.4.0.420.vmdk.zip

=== 1.4.1 Emulator Image (158MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%201.4.1.427.vmdk.zip

=== 1.4.5 Emulator Image (157MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%201.4.5.465.vmdk.zip

=== 2.1.0 Emulator Image (139MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK%202.1.0.519.vmdk.zip

=== 2.2.0 Emulator Image (Pre3) (155MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK-2210.vmdk.zip

=== 2.2.4 Emulator Image (Pre2 and Pre3) (176MB) ===
* http://cdn.downloads.palm.com/sdkdownloads/emulator-images/SDK-2222.vmdk.zip

WebOS 2 Upgrade

2017-10-06T01:23:54Z

Bbito: /* Novacom Drivers */ Update Universal Novacom Installer links, remove info about Palm linux installer

This page is available in two languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[WebOS_2_Upgrade|WebOS 2 Upgrade]]
:[[Image:France.png]] [[WebOS_2_Upgrade-FR| WebOS 2 Upgrade-FR (Mise à jour de webOS 1.x vers webOS 2.x pour palm Pre et Pre Plus)]]

= Overview =
With the release of the webOS 2.1.0 doctor by HP for O2 and Vodafone Pre+ devices, there is now a legal way to get webOS 2.1 onto the legacy devices of carriers that are not onboard with the 2.x upgrade. Compatible devices include all Pre and Pre Plus devices. This is not compatible with Pixi devices.

'''You must read this page from top to bottom twice before starting this procedure. You must complete all steps from 0 to 6. Do not omit any steps. Do not improvise. Do not think you can ignore the instructions. If you do not follow these instructions precisely, completely and without error, you will not achieve your goal and you will annoy a lot of people with a lot of unnecessary questions in the process.'''

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

= Disclaimer =
'''This is a process that uses official HP software in unofficial ways. You should always be prepared for the unlikely possibility that your device may be completely wiped and your Palm profile may be permanently destroyed. Do not proceed unless you have made appropriate backups and are OK with that. Working knowledge of MetaDoctor and Linux systems in general is needed.'''

If you feel the need to ask whether you should do this on your primary phone, then you should not, as that indicates that you have not yet taken the required precautions and backups in case something goes wrong.

= Other Tutorials =
'''Note that this wiki page is always the authoritative source of information about this process, so you should refer to this page first for any and all instructions. Here are some other pages which you may find useful in addition to this page. They do not replace the information on this page, which you should read from top to bottom first.'''
== Tutorials that have been updated to match the latest instructions ==
* webOSNation (née ''PreCentral'') forum user @malpha recorded a two-part [http://www.youtube.com/watch?v=CJB8NJ72kZg video overview] of the process as she followed this step-by-step. {Sprint Pre-, Ubuntu}.

Historical information: ''webosworld.com is no longer hosting webOS content in 2017''
* ''WebOS World'' writer Jake Morrison has written a How-To guide <del><nowiki>http://webosworld.com/2011/03/07/my-meta-doctor-to-2-1-experience/</nowiki></del> based directly off this walkthrough. {Sprint Pre-, Ubuntu}.

== Tutorials that are out of date and should not be relied upon ==
* webOSNation (née ''PreCentral'') forum user @djwhitey recorded a 9-minute [http://www.youtube.com/watch?v=PF2ciiNFxLc walkthrough] (includes Activation Error). {Sprint Pre-, Win7 x86, Ubuntu Server 10.04}.
* webOSNation (née ''PreCentral'') forum user @innocentbystander has written a start-to-finish guide to installing and building the Meta Doctor under Mac OS 10.6 for those with little or no experience with the command line. It can be found [http://forums.webosnation.com/webos-discussion-lounge/276785-webos-2-1-installation-step-step-guide.html here].

= Using MetaDoctor Scripts =

== Step 0: Backup your device ==
A guide by webOSNation (née PreCentral) on backing up your device can be found [http://www.webosnation.com/backup here].

Make sure you have copies of all the data that you want to preserve from your palm profile. There is a possibility that you will need to clear your palm profile to be successful in this upgrade, so you should act as if that is going to happen from the start.

Also, make sure you run the [[Application:SaveRestore]] application from Preware to back up your application data - you don't want to lose your Angry Birds progress, do you?

Then copy all the files from the USB drive onto your PC to keep them safe, including music, downloads, and pictures. The webOS Doctor has been known to wipe your USB drive without warning, so you should act as if that is going to happen from the start.

If your phone is set to use the Palm Profile as the default location for contacts you may want to manually export these. To check how many palm profile contacts you have: Contacts App -> Preferences & Accounts -> tap "Palm Profile" under the "accounts" subsection.
To manually export contacts see this post: [http://forums.webosnation.com/webos-synergy-synchronization/215705-howto-transfer-contacts-palm-profile-gmail-yahoo-mail-easier-way-2.html#post2886607 webOSNation Forums - How To Transfer contacts]. They can be imported back onto your phone by emailing the file of exported contacts to yourself, and opening that attachment on your phone.

== Step 1: Prerequisites ==
=== Disk Space ===

You should allow up to 10GB of disk space for this process.

=== MetaDoctor ===

See [[Application:MetaDoctor]] for information on how to install MetaDoctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

Note that the procedure for the WebOS 2 Upgrade is on this page. The MetaDoctor is simply a tool which is used by this procedure. You need to complete only Step 1: Setting up Meta-Doctor on that page. When you get to the end of Step 1: Setting up Meta-Doctor on that page, you should come back to this page and continue the procedure on this page.

=== Palm SDK ===

See [http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1661 Palm Developer Website] for Windows and [https://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1585 for Ubuntu].
Whilst the Palm SDK is not strictly required to complete this procedure, it is the best way to install the novacom and novaterm programs which are used to transfer files to and from your device and to access the command line on your device.

=== Novacom Drivers ===

If you are unable to get the official novacom drivers from the Palm SDK to connect to your device, you can alternately try Jason Robitaille's [https://github.com/JayCanuck/universal-novacom-installer/blob/master/bin/UniversalNovacomInstaller-1.3.jar?raw=true Universal Novacom Installer] source code is found at his [https://github.com/JayCanuck/universal-novacom-installer github repository]

These drivers are necessary to interface with webOS devices. The Installer is cross-platform and supports Windows (32bit and 64bit), Mac OS, and Ubuntu (32bit and 64bit).

== Step 2: Prepare your Palm Profile ==
With unsupported carrier/device/OS combinations, it may be necessary to clear some Palm Profile data to allow you to sign in on webOS 2.x devices. The process is as follows:
'''Warning: this will delete data from your Palm Profile, including but not limited to: calendars, contacts, account information, email signatures, bookmarks, memos, tasks, SSM/MMS messages, and icon/launcher arrangement.'''
# Open the Backup app.
# Turn off backups, confirming that you wish to erase your palm profile information.

'''This step is extremely important if you find that after finishing the webOS 2.1 installation your saved apps don't download to your device automatically and your Palm Profile account name under Accounts is "Dr. Skipped Firstuse". You should delete your profile info and Doctor again.'''

NOTE: The latest scripts (as of 5:00pm EST) MAY allow direct conversion of a 1.4.5 profile to 2.1.0 without deleting Palm Profile data. Please read the information under "Palm Profile" below to understand the issues that my arise from attempting this, as well as the required solutions to resolve those issues.

== Step 3: Run device-specific MetaDoctor script ==
The MetaDoctor scripts will automatically download the latest necessary webOS doctors, extract and replace CDMA radio firmware as necessary, and will build and launch the modified webOS Doctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

'''A NOTE ON "RE-DOCTORING":''' If this is not your first time through this process, you should do a "git pull" and a "make clobber" to ensure you have the latest scripts and a pristine build folder. From the command line, type "cd meta-doctor" without the quotes and press enter. Then type "git pull" without the quotes and press enter. Then type "make clobber" without the quotes and press enter. Voila! You now have the latest scripts and a clean folder to build your doctor in.

'''From the meta-doctor directory''', run the meta-script that corresponds to your device (note that the strings enclosed by < and > in the following line are placeholders for values that you must supply - you cannot type the string exactly as shown):
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version>
</nowiki></pre>

You should replace <carrier>, <device>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

A list of all the scripts can be found by typing
<pre><nowiki>
ls ./scripts/
</nowiki></pre>

'''For those who for what ever reason will never be using their phone on a cellular network and wish to use the phone only on wifi, just add "--wifi-only" as an extra argument to the meta-script:'''
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version> --wifi-only
</nowiki></pre>

Again, you should replace <device>, <carrier>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

Then, when your device boots after step 4, all you need to do is configure and start wifi and then run the Gesture Tutorial and you should be good to go. Note that in this case the end of the palm profile login procedure will appear to cycle forever, so just manually reboot the device using Opt-Sym-R when that happens.

Specific additional information for each of the supported device and carrier combinations can be found below:

=== AT&T Pre+ ===
<pre><nowiki>
./scripts/meta-att-preplus-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== BellMo Pre ===
<pre><nowiki>
./scripts/meta-bellmo-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== O2 Pre ===
<pre><nowiki>
./scripts/meta-o2-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== O2 Pre+ ===
<pre><nowiki>
./scripts/meta-o2-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Pre ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

<pre><nowiki>
./scripts/meta-sprint-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Franken Unlocked Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Unlocked Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-unlocked-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Sprint Franken Verizon Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Verizon Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-verizon-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Telcel Pre ===
<pre><nowiki>
./scripts/meta-telcel-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.00 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

'''In Fact, it seems Palm has already locked out all the Telcel activated devices, so, even if you managed to hack your Meta Doctor to have a 1.4.5 profile and see the paid apps in the Catalog, you won't be able to insert your credit card data and won't be able to buy apps anymore.'''

=== Verizon Pre+ ===
<pre><nowiki>
./scripts/meta-verizon-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== Verizon FrankenPre 2 ===
<pre><nowiki>
./scripts/meta-verizon-franken-unlocked-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Verizon Pre 2 ===
<pre><nowiki>
./scripts/meta-verizon-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

The Verizon specific apps (Amazon MP3, VZ Navigator, Skype Mobile) and Voice Dialing will be present and fully functional.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== WR Pre ===

For WR devices, you should attempt to use the O2 script above first, and if you end up with a 9.9.9 version in your palm profile, then use this WR script instead.

<pre><nowiki>
./scripts/meta-wr-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

== Step 4: Run the modified webOS Doctor ==
The meta-script will automatically launch the modified webOS Doctor for you. However, if you need to move it to a different location and run it manually, the modified doctor will be a '''.jar''' file located in the build output directory:
<pre><nowiki>meta-doctor/build/meta-sprint-pre-2.1.0/webosdoctorp101ueu-wr-2.1.0.jar</nowiki></pre>

Note that the directory path will change from that example based on which script you ran, and the script will tell you the exact pathname shortly after it starts running.

Do not USB connect the phone until WebOS Doctor specifically says to.

NOTE: There have been reports that, for some users, the modified webOS doctor fails to recognize the USB connection. Similarly, up-graders have also noted that in some instances their Pre will "disconnect" from the webOS Doctor (while running) and re-boot into v.1.4.5. It has been observed that Doctoring, while putting ones Pre through the "Recovery" Reboot (as detailed [http://www.webos-internals.org/wiki/How_To_Recover here]) may mitigate these issues, and allow the Doctor to continue. There is also an instance where after pressing the "next" button to start the Doctor, the phone appeared to need charging before the Doctor would start( on a 95% full battery), and then stalled at 0%. Putting the phone into emergency recovery mode appeared to solve this problem.

Note: Sprint users please read the PRL section '''before''' running The Doctor: [http://www.webos-internals.org/wiki/WebOS_2_Upgrade#Sprint_2 "5.9.1 Sprint"].

== Step 5: There is no Step 5 ==

There used to be a complex set of additional steps required here. Too many people had trouble following them, so we automated it. You should proceed directly to Step 6.

== Step 6: Donate to WebOS Internals and purchase the Preware Homebrew Documentation app ==
If this worked for you, we would appreciate a donation at http://donate.webos-internals.org - and if you want to thank Rod Whitby personally for the many hours that he put into creating the Meta-Doctor and this upgrade procedure, you should purchase the [http://developer.palm.com/appredirect/?packageid=org.preware.docs Preware Homebrew Documentation] app from the official app catalog, and leave a nice 5 star review containing your message of thanks.

= Caveats =

== OTA Updates ==
It is extremely unlikely that any Pre or Pre+ device will ever get another OTA update. If you preform this procedure on those devices, you should not expect OTA updates.

Performing this procedure on a Pre 2 device may allow it to receive OTA updates, but there is no guarantee.

== App Catalog ==
If your palm profile record says version 1.40.50, you will not be able to purchase apps that are marked as only compatible with webOS versions 2.x and above. This cannot be changed for these devices at this time. If your palm profile record says version 2.1.0, then you should be able to purchase all apps (depending upon your geographical restrictions and country of first activation).

=== Masquerading ===
Palm's servers only accept certain device/OS combinations as valid. While some combinations of carrier and devices running 2.1 are accepted, others have to report to the palm profile server that they are running webOS 1.4.5. This is done automatically, and cannot be changed for these devices at this time.

== Carrier-Specific Applications ==
Some carrier apps are not working in webOS 2.1. Apps that have been tested and are known to install cleanly and work will be added to the custom webOS Doctor for the appropriate device/carrier.

Known working carrier apps are listed below.

=== Sprint ===
* Sprint Portal
* Sprint TV
* Sprint Football Live
* NASCAR

===Verizon Wireless ===
* All Verizon apps should be working at this time for the Pre +. However, '''no one has tested the VZW Navigator subscription''' to confirm that the service carries over to a Meta-Doctored phone. You could be the first!
VZW Navigator is working much better for me now on VZ Palm Pre Plus with HP Web OS 2.1. The only problem I havent solved is system updates hangs. Anyone have a solution?

=== AT&T ===
* So far the only AT&T specific app tested with this method is the Amazon MP3 app, which may be installed using the process found [http://forums.precentral.net/palm-pre-2/279364-how-install-amazon-mp3-app-your-unlocked-pre2-step-step.html here]. However, non-free music has NOT yet been tested with this process.

== Patches ==
Not all patches have been ported over yet. If you want to check for a certain patch, please see webOS Internals' [http://patches.webos-internals.org/?do=browse&webosver=2.1.0&category=all webOS-Patches Web Portal].

== Adobe Flash ==
Adobe Flash is not included in this webOS 2.1 doctor, but can be added with files from a VZW Pre 2 2.0.1 doctor.

=== Adding Flash Support ===
The easiest way to enable Adobe Flash on your webOS 2.1.0 legacy device is by creating a modular package and installing that, along with a patch to make the Adobe Flash preferences visible in the browser. Or you can do it manually. See ([http://www.webos-internals.org/wiki/Adding_flash_support here]) for more detail.

== Performance ==
* '''OVERCLOCKING IS NOW SUPPORTED'''. Palm has just released the source code for the kernel used in webOS 2.1.0. An experimental version of UberKernel has already appeared in the experimental feeds, but casual users should wait for a stable one.
* The Pre Plus has 512 MB of memory and thus runs 2.1 quite well, but this is not the case with the original Pre since it has only 256 MB. Luckily, Palm adopted WebOS Internals's configuration of the standard Linux compcache technology that was ported to the custom kernels, and it comes active, but with only 10 MB. One potential way to enhance performance in original Pre devices is to make the compcache bigger.

=== Increase compcache size, Temporary Method ===
You can use the Govnah application to increase the size of the compcache. Disable compcache, change the size, and then reenable.

=== Increase compcache size, Permanent Method ===
You have to edit the file /etc/event.d/compcache and change the value from 10240 to 32768.

For example, you could follow these steps:

#Make sure '''novacomd''' is running on your computer.
#Use a terminal (as described on the Wiki page [http://www.webos-internals.org/wiki/Portal:Accessing_Linux Accessing Linux on the Pre... ]) to run '''novaterm''' and access your phone. Type in the following: <pre>/usr/sbin/rootfs_open -t</pre><pre>vi /etc/event.d/compcache</pre>
#vi is a bit different so, for those not familiar with how it works, the fastest way to navigate and make the required edit is in parentheses below:
##Go down to line 10 (Type <tt>10</tt> then hit <tt>Shift+G</tt>)
##Move to the first <tt>1</tt> (Type <tt>4w</tt>)
##Enter replace mode (<tt>Shift+R</tt>) and type <tt>32768</tt>
##Exit back to command mode (Press <tt>Esc</tt> or <tt>Ctrl+C</tt>)
##Save and Quit (Type <tt>:wq</tt>)
#Reboot your Pre and verify it's working by using Govnah. While you are still in novaterm, you can type the following to reboot:<pre>/sbin/reboot</pre>

== Palm Profile ==
* Some people have had problems signing in to existing Palm Profiles on 2.1 due to backup data. To make sure that you can sign in to your profile on 2.1, you should disable backups before doctoring to 2.1 and delete server side backups. Of course, this deletes most of the data in your Palm Profile (memos, tasks, calender entries, accounts, ...). Your apps will be restored on 2.1, but that is about it. Note that not all people have issues with backups. If you would rather not delete your Palm Profile data, you can try doctoring to 2.1 without turning backups off and see if restoring everything works. If it doesn't, you'll have to doctor back to 1.4.5 to turn off backups or use a new Palm Profile, though.

* If you get 9.9.9 in palm.com/palmprofile, then you can doctor back to 1.4.5 for your carrier and log in, then delete backup info in backup app and then 2.1.0 metadoctor it.

* If you get "Dr. Skipped Firstuse" as the name of your palm profile in the new accounts app in 2.1.0 and/or if the gesture application creates a blank screen, you have a false profile problem. You need to doctor back to 1.4.5 for your carrier and login in, then delete backup info in backup app and then 2.1.0 metadoctor it. To avoid this problem, redownload the latest version of the metadoctor and run the appropiate script with the <tt>--wifi-only</tt> switch. Note: Only use <tt>--wifi-only</tt> if you do not intend to have cellular service on the device as this option disables the modem update and renders cellular service inoperable without re-doctoring.

* Alternative fix for above problem: If your profile works fine but the Impostah app and the Accounts app show your profile name as "Dr. Skipped First Use" although your phone ran the first use app after doctoring, erase your backup data from the backup app by turning off backups and choose Erase Apps and Data from the reset options in the Device Info app.

*If you get stuck at the "Auto Locate" selection screen during the login process, you can re-doctor using the same 2.1 doctor file and it will go through. It appears to be an issue when creating a new profile in 2.1 rather than "porting" your 1.4.5 profile to 2.1. After the second doctoring, you will "Sign In" to an existing profile (the one you created during the first profile login after doctoring), rather than creating a new profile.

==GPS==
Step-by-step approach for those experiencing problems with GPS following upgrade.
# To enable GPS functionality go to the "Location Services" application (click "Turn On" if GPS has been completely disabled). From there go to the "Preferences" menu in the top left hand corner and select the "Locate Me Using..." sub-menu item. Ensure that both "GPS" and "Google Services" are enabled (you may be prompted to accept the Terms of Service). Close the "Location Services" application.
# Next you need to bring up the "GPS Information" application; to do this dial ##477# (or #*477# on GSM/UMTS Pres) in the phone application (the "477" corresponds to the letter keys "GPS").
# Click the "Get Fix" button. You may receive a "GPS Error - Position Unavailable" message which you can close. Keep pressing "Get Fix" until a fix is established (it may take several attempts). You will know a fix has been established when some statistics (Latitude, Longitude etc) are displayed.
# Once a fix has been established, GPS should continue to function normally thereafter.

==Voice Dialing==
For the Sprint-Franken-Pre2 (Pre2-GSM-Unlocked confirmed + sprint-pre(-)comm) and perhaps the Verizon-Franken-Pre2, the voice dialing application may not work after the metadoctor procedure above. The application may or may not even launch after tapped. You may experience problems with sound intermittently not working, esp. when playing media, or using the phone. This will be corrected automatically with a webOS OTA Update to 2.1.0. When the phone prompts for the update, install it.

To speed up the process, go to the "System Updates" app on your phone. The WebOS 2.1 update should appear after it searches for updates. (The update for a Sprint FrankenPre2 is ~7MB and only took a few minutes to install).

==PRL==
=== Sprint ===

After applying 2.1.0 to a Sprint device using this method, there is currently no known way to update the PRL. There are permissions issues, and the conventional "Update Profile" and "Update PRL" from the Phone options will no longer work. The provisioner service binary from the Sprint 1.4.5 doctor does not work on webOS 2.x, so a version of that service for 2.x is required for this to ever work. It is not expected that this situation will change before Sprint releases another webOS phone running webOS 2.0 or above.

====Overview====
:1) Back up /var/lib/software/* before upgrading to webOS 2.1
:2) Restore /var/lib/software/* after upgrading to webOS 2.1
:3) Use PmModemUpdater to update your PRL.

 
For further information, exact directions, caveats, etc., please see the [http://www.webos-internals.org/wiki/Sprint_PRL_Update dedicated Sprint PRL Update Wiki Page].

=== Verizon ===
In order to update your PRL, you will need to manually program your phone OTA by dialing '''*228''' from the dialer, and choose the "Program your phone" option.

WebOS 2 Upgrade

2017-10-06T01:16:13Z

Bbito: /* Step 0: Backup your device */ Update links from precentral to webosnation

This page is available in two languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[WebOS_2_Upgrade|WebOS 2 Upgrade]]
:[[Image:France.png]] [[WebOS_2_Upgrade-FR| WebOS 2 Upgrade-FR (Mise à jour de webOS 1.x vers webOS 2.x pour palm Pre et Pre Plus)]]

= Overview =
With the release of the webOS 2.1.0 doctor by HP for O2 and Vodafone Pre+ devices, there is now a legal way to get webOS 2.1 onto the legacy devices of carriers that are not onboard with the 2.x upgrade. Compatible devices include all Pre and Pre Plus devices. This is not compatible with Pixi devices.

'''You must read this page from top to bottom twice before starting this procedure. You must complete all steps from 0 to 6. Do not omit any steps. Do not improvise. Do not think you can ignore the instructions. If you do not follow these instructions precisely, completely and without error, you will not achieve your goal and you will annoy a lot of people with a lot of unnecessary questions in the process.'''

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

= Disclaimer =
'''This is a process that uses official HP software in unofficial ways. You should always be prepared for the unlikely possibility that your device may be completely wiped and your Palm profile may be permanently destroyed. Do not proceed unless you have made appropriate backups and are OK with that. Working knowledge of MetaDoctor and Linux systems in general is needed.'''

If you feel the need to ask whether you should do this on your primary phone, then you should not, as that indicates that you have not yet taken the required precautions and backups in case something goes wrong.

= Other Tutorials =
'''Note that this wiki page is always the authoritative source of information about this process, so you should refer to this page first for any and all instructions. Here are some other pages which you may find useful in addition to this page. They do not replace the information on this page, which you should read from top to bottom first.'''
== Tutorials that have been updated to match the latest instructions ==
* webOSNation (née ''PreCentral'') forum user @malpha recorded a two-part [http://www.youtube.com/watch?v=CJB8NJ72kZg video overview] of the process as she followed this step-by-step. {Sprint Pre-, Ubuntu}.

Historical information: ''webosworld.com is no longer hosting webOS content in 2017''
* ''WebOS World'' writer Jake Morrison has written a How-To guide <del><nowiki>http://webosworld.com/2011/03/07/my-meta-doctor-to-2-1-experience/</nowiki></del> based directly off this walkthrough. {Sprint Pre-, Ubuntu}.

== Tutorials that are out of date and should not be relied upon ==
* webOSNation (née ''PreCentral'') forum user @djwhitey recorded a 9-minute [http://www.youtube.com/watch?v=PF2ciiNFxLc walkthrough] (includes Activation Error). {Sprint Pre-, Win7 x86, Ubuntu Server 10.04}.
* webOSNation (née ''PreCentral'') forum user @innocentbystander has written a start-to-finish guide to installing and building the Meta Doctor under Mac OS 10.6 for those with little or no experience with the command line. It can be found [http://forums.webosnation.com/webos-discussion-lounge/276785-webos-2-1-installation-step-step-guide.html here].

= Using MetaDoctor Scripts =

== Step 0: Backup your device ==
A guide by webOSNation (née PreCentral) on backing up your device can be found [http://www.webosnation.com/backup here].

Make sure you have copies of all the data that you want to preserve from your palm profile. There is a possibility that you will need to clear your palm profile to be successful in this upgrade, so you should act as if that is going to happen from the start.

Also, make sure you run the [[Application:SaveRestore]] application from Preware to back up your application data - you don't want to lose your Angry Birds progress, do you?

Then copy all the files from the USB drive onto your PC to keep them safe, including music, downloads, and pictures. The webOS Doctor has been known to wipe your USB drive without warning, so you should act as if that is going to happen from the start.

If your phone is set to use the Palm Profile as the default location for contacts you may want to manually export these. To check how many palm profile contacts you have: Contacts App -> Preferences & Accounts -> tap "Palm Profile" under the "accounts" subsection.
To manually export contacts see this post: [http://forums.webosnation.com/webos-synergy-synchronization/215705-howto-transfer-contacts-palm-profile-gmail-yahoo-mail-easier-way-2.html#post2886607 webOSNation Forums - How To Transfer contacts]. They can be imported back onto your phone by emailing the file of exported contacts to yourself, and opening that attachment on your phone.

== Step 1: Prerequisites ==
=== Disk Space ===

You should allow up to 10GB of disk space for this process.

=== MetaDoctor ===

See [[Application:MetaDoctor]] for information on how to install MetaDoctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

Note that the procedure for the WebOS 2 Upgrade is on this page. The MetaDoctor is simply a tool which is used by this procedure. You need to complete only Step 1: Setting up Meta-Doctor on that page. When you get to the end of Step 1: Setting up Meta-Doctor on that page, you should come back to this page and continue the procedure on this page.

=== Palm SDK ===

See [http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1661 Palm Developer Website] for Windows and [https://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1585 for Ubuntu].
Whilst the Palm SDK is not strictly required to complete this procedure, it is the best way to install the novacom and novaterm programs which are used to transfer files to and from your device and to access the command line on your device.

=== Novacom Drivers ===

If you are unable to get the official novacom drivers from the Palm SDK to connect to your device, you can alternately try Jason Robitaille's [http://universal-novacom-installer.googlecode.com/files/Universal%20Novacom%20Installer.jar Universal Novacom Driver Installer]

These drivers are necessary to interface with the Pre. The Installer is cross-platform and supports Windows (32bit and 64bit), Mac OS, and Ubuntu (32bit and 64bit). Note that it does not support the Pre 2 on Ubuntu. For that you'll need Linux-specific drivers, which HP makes available [https://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-novacom_1.0.64_i386.deb here]for 32-bit and [https://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-novacom_1.0.64_amd64.deb here] for 64-bit.

== Step 2: Prepare your Palm Profile ==
With unsupported carrier/device/OS combinations, it may be necessary to clear some Palm Profile data to allow you to sign in on webOS 2.x devices. The process is as follows:
'''Warning: this will delete data from your Palm Profile, including but not limited to: calendars, contacts, account information, email signatures, bookmarks, memos, tasks, SSM/MMS messages, and icon/launcher arrangement.'''
# Open the Backup app.
# Turn off backups, confirming that you wish to erase your palm profile information.

'''This step is extremely important if you find that after finishing the webOS 2.1 installation your saved apps don't download to your device automatically and your Palm Profile account name under Accounts is "Dr. Skipped Firstuse". You should delete your profile info and Doctor again.'''

NOTE: The latest scripts (as of 5:00pm EST) MAY allow direct conversion of a 1.4.5 profile to 2.1.0 without deleting Palm Profile data. Please read the information under "Palm Profile" below to understand the issues that my arise from attempting this, as well as the required solutions to resolve those issues.

== Step 3: Run device-specific MetaDoctor script ==
The MetaDoctor scripts will automatically download the latest necessary webOS doctors, extract and replace CDMA radio firmware as necessary, and will build and launch the modified webOS Doctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

'''A NOTE ON "RE-DOCTORING":''' If this is not your first time through this process, you should do a "git pull" and a "make clobber" to ensure you have the latest scripts and a pristine build folder. From the command line, type "cd meta-doctor" without the quotes and press enter. Then type "git pull" without the quotes and press enter. Then type "make clobber" without the quotes and press enter. Voila! You now have the latest scripts and a clean folder to build your doctor in.

'''From the meta-doctor directory''', run the meta-script that corresponds to your device (note that the strings enclosed by < and > in the following line are placeholders for values that you must supply - you cannot type the string exactly as shown):
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version>
</nowiki></pre>

You should replace <carrier>, <device>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

A list of all the scripts can be found by typing
<pre><nowiki>
ls ./scripts/
</nowiki></pre>

'''For those who for what ever reason will never be using their phone on a cellular network and wish to use the phone only on wifi, just add "--wifi-only" as an extra argument to the meta-script:'''
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version> --wifi-only
</nowiki></pre>

Again, you should replace <device>, <carrier>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

Then, when your device boots after step 4, all you need to do is configure and start wifi and then run the Gesture Tutorial and you should be good to go. Note that in this case the end of the palm profile login procedure will appear to cycle forever, so just manually reboot the device using Opt-Sym-R when that happens.

Specific additional information for each of the supported device and carrier combinations can be found below:

=== AT&T Pre+ ===
<pre><nowiki>
./scripts/meta-att-preplus-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== BellMo Pre ===
<pre><nowiki>
./scripts/meta-bellmo-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== O2 Pre ===
<pre><nowiki>
./scripts/meta-o2-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== O2 Pre+ ===
<pre><nowiki>
./scripts/meta-o2-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Pre ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

<pre><nowiki>
./scripts/meta-sprint-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Franken Unlocked Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Unlocked Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-unlocked-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Sprint Franken Verizon Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Verizon Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-verizon-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Telcel Pre ===
<pre><nowiki>
./scripts/meta-telcel-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.00 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

'''In Fact, it seems Palm has already locked out all the Telcel activated devices, so, even if you managed to hack your Meta Doctor to have a 1.4.5 profile and see the paid apps in the Catalog, you won't be able to insert your credit card data and won't be able to buy apps anymore.'''

=== Verizon Pre+ ===
<pre><nowiki>
./scripts/meta-verizon-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== Verizon FrankenPre 2 ===
<pre><nowiki>
./scripts/meta-verizon-franken-unlocked-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Verizon Pre 2 ===
<pre><nowiki>
./scripts/meta-verizon-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

The Verizon specific apps (Amazon MP3, VZ Navigator, Skype Mobile) and Voice Dialing will be present and fully functional.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== WR Pre ===

For WR devices, you should attempt to use the O2 script above first, and if you end up with a 9.9.9 version in your palm profile, then use this WR script instead.

<pre><nowiki>
./scripts/meta-wr-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

== Step 4: Run the modified webOS Doctor ==
The meta-script will automatically launch the modified webOS Doctor for you. However, if you need to move it to a different location and run it manually, the modified doctor will be a '''.jar''' file located in the build output directory:
<pre><nowiki>meta-doctor/build/meta-sprint-pre-2.1.0/webosdoctorp101ueu-wr-2.1.0.jar</nowiki></pre>

Note that the directory path will change from that example based on which script you ran, and the script will tell you the exact pathname shortly after it starts running.

Do not USB connect the phone until WebOS Doctor specifically says to.

NOTE: There have been reports that, for some users, the modified webOS doctor fails to recognize the USB connection. Similarly, up-graders have also noted that in some instances their Pre will "disconnect" from the webOS Doctor (while running) and re-boot into v.1.4.5. It has been observed that Doctoring, while putting ones Pre through the "Recovery" Reboot (as detailed [http://www.webos-internals.org/wiki/How_To_Recover here]) may mitigate these issues, and allow the Doctor to continue. There is also an instance where after pressing the "next" button to start the Doctor, the phone appeared to need charging before the Doctor would start( on a 95% full battery), and then stalled at 0%. Putting the phone into emergency recovery mode appeared to solve this problem.

Note: Sprint users please read the PRL section '''before''' running The Doctor: [http://www.webos-internals.org/wiki/WebOS_2_Upgrade#Sprint_2 "5.9.1 Sprint"].

== Step 5: There is no Step 5 ==

There used to be a complex set of additional steps required here. Too many people had trouble following them, so we automated it. You should proceed directly to Step 6.

== Step 6: Donate to WebOS Internals and purchase the Preware Homebrew Documentation app ==
If this worked for you, we would appreciate a donation at http://donate.webos-internals.org - and if you want to thank Rod Whitby personally for the many hours that he put into creating the Meta-Doctor and this upgrade procedure, you should purchase the [http://developer.palm.com/appredirect/?packageid=org.preware.docs Preware Homebrew Documentation] app from the official app catalog, and leave a nice 5 star review containing your message of thanks.

= Caveats =

== OTA Updates ==
It is extremely unlikely that any Pre or Pre+ device will ever get another OTA update. If you preform this procedure on those devices, you should not expect OTA updates.

Performing this procedure on a Pre 2 device may allow it to receive OTA updates, but there is no guarantee.

== App Catalog ==
If your palm profile record says version 1.40.50, you will not be able to purchase apps that are marked as only compatible with webOS versions 2.x and above. This cannot be changed for these devices at this time. If your palm profile record says version 2.1.0, then you should be able to purchase all apps (depending upon your geographical restrictions and country of first activation).

=== Masquerading ===
Palm's servers only accept certain device/OS combinations as valid. While some combinations of carrier and devices running 2.1 are accepted, others have to report to the palm profile server that they are running webOS 1.4.5. This is done automatically, and cannot be changed for these devices at this time.

== Carrier-Specific Applications ==
Some carrier apps are not working in webOS 2.1. Apps that have been tested and are known to install cleanly and work will be added to the custom webOS Doctor for the appropriate device/carrier.

Known working carrier apps are listed below.

=== Sprint ===
* Sprint Portal
* Sprint TV
* Sprint Football Live
* NASCAR

===Verizon Wireless ===
* All Verizon apps should be working at this time for the Pre +. However, '''no one has tested the VZW Navigator subscription''' to confirm that the service carries over to a Meta-Doctored phone. You could be the first!
VZW Navigator is working much better for me now on VZ Palm Pre Plus with HP Web OS 2.1. The only problem I havent solved is system updates hangs. Anyone have a solution?

=== AT&T ===
* So far the only AT&T specific app tested with this method is the Amazon MP3 app, which may be installed using the process found [http://forums.precentral.net/palm-pre-2/279364-how-install-amazon-mp3-app-your-unlocked-pre2-step-step.html here]. However, non-free music has NOT yet been tested with this process.

== Patches ==
Not all patches have been ported over yet. If you want to check for a certain patch, please see webOS Internals' [http://patches.webos-internals.org/?do=browse&webosver=2.1.0&category=all webOS-Patches Web Portal].

== Adobe Flash ==
Adobe Flash is not included in this webOS 2.1 doctor, but can be added with files from a VZW Pre 2 2.0.1 doctor.

=== Adding Flash Support ===
The easiest way to enable Adobe Flash on your webOS 2.1.0 legacy device is by creating a modular package and installing that, along with a patch to make the Adobe Flash preferences visible in the browser. Or you can do it manually. See ([http://www.webos-internals.org/wiki/Adding_flash_support here]) for more detail.

== Performance ==
* '''OVERCLOCKING IS NOW SUPPORTED'''. Palm has just released the source code for the kernel used in webOS 2.1.0. An experimental version of UberKernel has already appeared in the experimental feeds, but casual users should wait for a stable one.
* The Pre Plus has 512 MB of memory and thus runs 2.1 quite well, but this is not the case with the original Pre since it has only 256 MB. Luckily, Palm adopted WebOS Internals's configuration of the standard Linux compcache technology that was ported to the custom kernels, and it comes active, but with only 10 MB. One potential way to enhance performance in original Pre devices is to make the compcache bigger.

=== Increase compcache size, Temporary Method ===
You can use the Govnah application to increase the size of the compcache. Disable compcache, change the size, and then reenable.

=== Increase compcache size, Permanent Method ===
You have to edit the file /etc/event.d/compcache and change the value from 10240 to 32768.

For example, you could follow these steps:

#Make sure '''novacomd''' is running on your computer.
#Use a terminal (as described on the Wiki page [http://www.webos-internals.org/wiki/Portal:Accessing_Linux Accessing Linux on the Pre... ]) to run '''novaterm''' and access your phone. Type in the following: <pre>/usr/sbin/rootfs_open -t</pre><pre>vi /etc/event.d/compcache</pre>
#vi is a bit different so, for those not familiar with how it works, the fastest way to navigate and make the required edit is in parentheses below:
##Go down to line 10 (Type <tt>10</tt> then hit <tt>Shift+G</tt>)
##Move to the first <tt>1</tt> (Type <tt>4w</tt>)
##Enter replace mode (<tt>Shift+R</tt>) and type <tt>32768</tt>
##Exit back to command mode (Press <tt>Esc</tt> or <tt>Ctrl+C</tt>)
##Save and Quit (Type <tt>:wq</tt>)
#Reboot your Pre and verify it's working by using Govnah. While you are still in novaterm, you can type the following to reboot:<pre>/sbin/reboot</pre>

== Palm Profile ==
* Some people have had problems signing in to existing Palm Profiles on 2.1 due to backup data. To make sure that you can sign in to your profile on 2.1, you should disable backups before doctoring to 2.1 and delete server side backups. Of course, this deletes most of the data in your Palm Profile (memos, tasks, calender entries, accounts, ...). Your apps will be restored on 2.1, but that is about it. Note that not all people have issues with backups. If you would rather not delete your Palm Profile data, you can try doctoring to 2.1 without turning backups off and see if restoring everything works. If it doesn't, you'll have to doctor back to 1.4.5 to turn off backups or use a new Palm Profile, though.

* If you get 9.9.9 in palm.com/palmprofile, then you can doctor back to 1.4.5 for your carrier and log in, then delete backup info in backup app and then 2.1.0 metadoctor it.

* If you get "Dr. Skipped Firstuse" as the name of your palm profile in the new accounts app in 2.1.0 and/or if the gesture application creates a blank screen, you have a false profile problem. You need to doctor back to 1.4.5 for your carrier and login in, then delete backup info in backup app and then 2.1.0 metadoctor it. To avoid this problem, redownload the latest version of the metadoctor and run the appropiate script with the <tt>--wifi-only</tt> switch. Note: Only use <tt>--wifi-only</tt> if you do not intend to have cellular service on the device as this option disables the modem update and renders cellular service inoperable without re-doctoring.

* Alternative fix for above problem: If your profile works fine but the Impostah app and the Accounts app show your profile name as "Dr. Skipped First Use" although your phone ran the first use app after doctoring, erase your backup data from the backup app by turning off backups and choose Erase Apps and Data from the reset options in the Device Info app.

*If you get stuck at the "Auto Locate" selection screen during the login process, you can re-doctor using the same 2.1 doctor file and it will go through. It appears to be an issue when creating a new profile in 2.1 rather than "porting" your 1.4.5 profile to 2.1. After the second doctoring, you will "Sign In" to an existing profile (the one you created during the first profile login after doctoring), rather than creating a new profile.

==GPS==
Step-by-step approach for those experiencing problems with GPS following upgrade.
# To enable GPS functionality go to the "Location Services" application (click "Turn On" if GPS has been completely disabled). From there go to the "Preferences" menu in the top left hand corner and select the "Locate Me Using..." sub-menu item. Ensure that both "GPS" and "Google Services" are enabled (you may be prompted to accept the Terms of Service). Close the "Location Services" application.
# Next you need to bring up the "GPS Information" application; to do this dial ##477# (or #*477# on GSM/UMTS Pres) in the phone application (the "477" corresponds to the letter keys "GPS").
# Click the "Get Fix" button. You may receive a "GPS Error - Position Unavailable" message which you can close. Keep pressing "Get Fix" until a fix is established (it may take several attempts). You will know a fix has been established when some statistics (Latitude, Longitude etc) are displayed.
# Once a fix has been established, GPS should continue to function normally thereafter.

==Voice Dialing==
For the Sprint-Franken-Pre2 (Pre2-GSM-Unlocked confirmed + sprint-pre(-)comm) and perhaps the Verizon-Franken-Pre2, the voice dialing application may not work after the metadoctor procedure above. The application may or may not even launch after tapped. You may experience problems with sound intermittently not working, esp. when playing media, or using the phone. This will be corrected automatically with a webOS OTA Update to 2.1.0. When the phone prompts for the update, install it.

To speed up the process, go to the "System Updates" app on your phone. The WebOS 2.1 update should appear after it searches for updates. (The update for a Sprint FrankenPre2 is ~7MB and only took a few minutes to install).

==PRL==
=== Sprint ===

After applying 2.1.0 to a Sprint device using this method, there is currently no known way to update the PRL. There are permissions issues, and the conventional "Update Profile" and "Update PRL" from the Phone options will no longer work. The provisioner service binary from the Sprint 1.4.5 doctor does not work on webOS 2.x, so a version of that service for 2.x is required for this to ever work. It is not expected that this situation will change before Sprint releases another webOS phone running webOS 2.0 or above.

====Overview====
:1) Back up /var/lib/software/* before upgrading to webOS 2.1
:2) Restore /var/lib/software/* after upgrading to webOS 2.1
:3) Use PmModemUpdater to update your PRL.

 
For further information, exact directions, caveats, etc., please see the [http://www.webos-internals.org/wiki/Sprint_PRL_Update dedicated Sprint PRL Update Wiki Page].

=== Verizon ===
In order to update your PRL, you will need to manually program your phone OTA by dialing '''*228''' from the dialer, and choose the "Program your phone" option.

WebOS 2 Upgrade

2017-10-06T01:11:24Z

Bbito: /* Tutorials that have been updated to match the latest instructions */ Update to webOSNation

This page is available in two languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[WebOS_2_Upgrade|WebOS 2 Upgrade]]
:[[Image:France.png]] [[WebOS_2_Upgrade-FR| WebOS 2 Upgrade-FR (Mise à jour de webOS 1.x vers webOS 2.x pour palm Pre et Pre Plus)]]

= Overview =
With the release of the webOS 2.1.0 doctor by HP for O2 and Vodafone Pre+ devices, there is now a legal way to get webOS 2.1 onto the legacy devices of carriers that are not onboard with the 2.x upgrade. Compatible devices include all Pre and Pre Plus devices. This is not compatible with Pixi devices.

'''You must read this page from top to bottom twice before starting this procedure. You must complete all steps from 0 to 6. Do not omit any steps. Do not improvise. Do not think you can ignore the instructions. If you do not follow these instructions precisely, completely and without error, you will not achieve your goal and you will annoy a lot of people with a lot of unnecessary questions in the process.'''

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

= Disclaimer =
'''This is a process that uses official HP software in unofficial ways. You should always be prepared for the unlikely possibility that your device may be completely wiped and your Palm profile may be permanently destroyed. Do not proceed unless you have made appropriate backups and are OK with that. Working knowledge of MetaDoctor and Linux systems in general is needed.'''

If you feel the need to ask whether you should do this on your primary phone, then you should not, as that indicates that you have not yet taken the required precautions and backups in case something goes wrong.

= Other Tutorials =
'''Note that this wiki page is always the authoritative source of information about this process, so you should refer to this page first for any and all instructions. Here are some other pages which you may find useful in addition to this page. They do not replace the information on this page, which you should read from top to bottom first.'''
== Tutorials that have been updated to match the latest instructions ==
* webOSNation (née ''PreCentral'') forum user @malpha recorded a two-part [http://www.youtube.com/watch?v=CJB8NJ72kZg video overview] of the process as she followed this step-by-step. {Sprint Pre-, Ubuntu}.

Historical information: ''webosworld.com is no longer hosting webOS content in 2017''
* ''WebOS World'' writer Jake Morrison has written a How-To guide <del><nowiki>http://webosworld.com/2011/03/07/my-meta-doctor-to-2-1-experience/</nowiki></del> based directly off this walkthrough. {Sprint Pre-, Ubuntu}.

== Tutorials that are out of date and should not be relied upon ==
* webOSNation (née ''PreCentral'') forum user @djwhitey recorded a 9-minute [http://www.youtube.com/watch?v=PF2ciiNFxLc walkthrough] (includes Activation Error). {Sprint Pre-, Win7 x86, Ubuntu Server 10.04}.
* webOSNation (née ''PreCentral'') forum user @innocentbystander has written a start-to-finish guide to installing and building the Meta Doctor under Mac OS 10.6 for those with little or no experience with the command line. It can be found [http://forums.webosnation.com/webos-discussion-lounge/276785-webos-2-1-installation-step-step-guide.html here].

= Using MetaDoctor Scripts =

== Step 0: Backup your device ==
A guide by PreCentral on backing up your device can be found [http://www.precentral.net/backup here].

Make sure you have copies of all the data that you want to preserve from your palm profile. There is a possibility that you will need to clear your palm profile to be successful in this upgrade, so you should act as if that is going to happen from the start.

Also, make sure you run the [[Application:SaveRestore]] application from Preware to back up your application data - you don't want to lose your Angry Birds progress, do you?

Then copy all the files from the USB drive onto your PC to keep them safe, including music, downloads, and pictures. The webOS Doctor has been known to wipe your USB drive without warning, so you should act as if that is going to happen from the start.

If your phone is set to use the Palm Profile as the default location for contacts you may want to manually export these. To check how many palm profile contacts you have: Contacts App -> Preferences & Accounts -> tap "Palm Profile" under the "accounts" subsection.
To manually export contacts see this post: [http://forums.precentral.net/webos-synergy-synchronization/215705-howto-transfer-contacts-palm-profile-gmail-yahoo-mail-easier-way-2.html#post2886607 PreCentral Forums - How To Transfer contacts]. They can be imported back onto your phone by emailing the file of exported contacts to yourself, and opening that attachment on your phone.

== Step 1: Prerequisites ==
=== Disk Space ===

You should allow up to 10GB of disk space for this process.

=== MetaDoctor ===

See [[Application:MetaDoctor]] for information on how to install MetaDoctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

Note that the procedure for the WebOS 2 Upgrade is on this page. The MetaDoctor is simply a tool which is used by this procedure. You need to complete only Step 1: Setting up Meta-Doctor on that page. When you get to the end of Step 1: Setting up Meta-Doctor on that page, you should come back to this page and continue the procedure on this page.

=== Palm SDK ===

See [http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1661 Palm Developer Website] for Windows and [https://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1585 for Ubuntu].
Whilst the Palm SDK is not strictly required to complete this procedure, it is the best way to install the novacom and novaterm programs which are used to transfer files to and from your device and to access the command line on your device.

=== Novacom Drivers ===

If you are unable to get the official novacom drivers from the Palm SDK to connect to your device, you can alternately try Jason Robitaille's [http://universal-novacom-installer.googlecode.com/files/Universal%20Novacom%20Installer.jar Universal Novacom Driver Installer]

These drivers are necessary to interface with the Pre. The Installer is cross-platform and supports Windows (32bit and 64bit), Mac OS, and Ubuntu (32bit and 64bit). Note that it does not support the Pre 2 on Ubuntu. For that you'll need Linux-specific drivers, which HP makes available [https://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-novacom_1.0.64_i386.deb here]for 32-bit and [https://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-novacom_1.0.64_amd64.deb here] for 64-bit.

== Step 2: Prepare your Palm Profile ==
With unsupported carrier/device/OS combinations, it may be necessary to clear some Palm Profile data to allow you to sign in on webOS 2.x devices. The process is as follows:
'''Warning: this will delete data from your Palm Profile, including but not limited to: calendars, contacts, account information, email signatures, bookmarks, memos, tasks, SSM/MMS messages, and icon/launcher arrangement.'''
# Open the Backup app.
# Turn off backups, confirming that you wish to erase your palm profile information.

'''This step is extremely important if you find that after finishing the webOS 2.1 installation your saved apps don't download to your device automatically and your Palm Profile account name under Accounts is "Dr. Skipped Firstuse". You should delete your profile info and Doctor again.'''

NOTE: The latest scripts (as of 5:00pm EST) MAY allow direct conversion of a 1.4.5 profile to 2.1.0 without deleting Palm Profile data. Please read the information under "Palm Profile" below to understand the issues that my arise from attempting this, as well as the required solutions to resolve those issues.

== Step 3: Run device-specific MetaDoctor script ==
The MetaDoctor scripts will automatically download the latest necessary webOS doctors, extract and replace CDMA radio firmware as necessary, and will build and launch the modified webOS Doctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

'''A NOTE ON "RE-DOCTORING":''' If this is not your first time through this process, you should do a "git pull" and a "make clobber" to ensure you have the latest scripts and a pristine build folder. From the command line, type "cd meta-doctor" without the quotes and press enter. Then type "git pull" without the quotes and press enter. Then type "make clobber" without the quotes and press enter. Voila! You now have the latest scripts and a clean folder to build your doctor in.

'''From the meta-doctor directory''', run the meta-script that corresponds to your device (note that the strings enclosed by < and > in the following line are placeholders for values that you must supply - you cannot type the string exactly as shown):
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version>
</nowiki></pre>

You should replace <carrier>, <device>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

A list of all the scripts can be found by typing
<pre><nowiki>
ls ./scripts/
</nowiki></pre>

'''For those who for what ever reason will never be using their phone on a cellular network and wish to use the phone only on wifi, just add "--wifi-only" as an extra argument to the meta-script:'''
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version> --wifi-only
</nowiki></pre>

Again, you should replace <device>, <carrier>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

Then, when your device boots after step 4, all you need to do is configure and start wifi and then run the Gesture Tutorial and you should be good to go. Note that in this case the end of the palm profile login procedure will appear to cycle forever, so just manually reboot the device using Opt-Sym-R when that happens.

Specific additional information for each of the supported device and carrier combinations can be found below:

=== AT&T Pre+ ===
<pre><nowiki>
./scripts/meta-att-preplus-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== BellMo Pre ===
<pre><nowiki>
./scripts/meta-bellmo-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== O2 Pre ===
<pre><nowiki>
./scripts/meta-o2-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== O2 Pre+ ===
<pre><nowiki>
./scripts/meta-o2-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Pre ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

<pre><nowiki>
./scripts/meta-sprint-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Franken Unlocked Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Unlocked Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-unlocked-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Sprint Franken Verizon Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Verizon Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-verizon-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Telcel Pre ===
<pre><nowiki>
./scripts/meta-telcel-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.00 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

'''In Fact, it seems Palm has already locked out all the Telcel activated devices, so, even if you managed to hack your Meta Doctor to have a 1.4.5 profile and see the paid apps in the Catalog, you won't be able to insert your credit card data and won't be able to buy apps anymore.'''

=== Verizon Pre+ ===
<pre><nowiki>
./scripts/meta-verizon-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== Verizon FrankenPre 2 ===
<pre><nowiki>
./scripts/meta-verizon-franken-unlocked-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Verizon Pre 2 ===
<pre><nowiki>
./scripts/meta-verizon-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

The Verizon specific apps (Amazon MP3, VZ Navigator, Skype Mobile) and Voice Dialing will be present and fully functional.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== WR Pre ===

For WR devices, you should attempt to use the O2 script above first, and if you end up with a 9.9.9 version in your palm profile, then use this WR script instead.

<pre><nowiki>
./scripts/meta-wr-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

== Step 4: Run the modified webOS Doctor ==
The meta-script will automatically launch the modified webOS Doctor for you. However, if you need to move it to a different location and run it manually, the modified doctor will be a '''.jar''' file located in the build output directory:
<pre><nowiki>meta-doctor/build/meta-sprint-pre-2.1.0/webosdoctorp101ueu-wr-2.1.0.jar</nowiki></pre>

Note that the directory path will change from that example based on which script you ran, and the script will tell you the exact pathname shortly after it starts running.

Do not USB connect the phone until WebOS Doctor specifically says to.

NOTE: There have been reports that, for some users, the modified webOS doctor fails to recognize the USB connection. Similarly, up-graders have also noted that in some instances their Pre will "disconnect" from the webOS Doctor (while running) and re-boot into v.1.4.5. It has been observed that Doctoring, while putting ones Pre through the "Recovery" Reboot (as detailed [http://www.webos-internals.org/wiki/How_To_Recover here]) may mitigate these issues, and allow the Doctor to continue. There is also an instance where after pressing the "next" button to start the Doctor, the phone appeared to need charging before the Doctor would start( on a 95% full battery), and then stalled at 0%. Putting the phone into emergency recovery mode appeared to solve this problem.

Note: Sprint users please read the PRL section '''before''' running The Doctor: [http://www.webos-internals.org/wiki/WebOS_2_Upgrade#Sprint_2 "5.9.1 Sprint"].

== Step 5: There is no Step 5 ==

There used to be a complex set of additional steps required here. Too many people had trouble following them, so we automated it. You should proceed directly to Step 6.

== Step 6: Donate to WebOS Internals and purchase the Preware Homebrew Documentation app ==
If this worked for you, we would appreciate a donation at http://donate.webos-internals.org - and if you want to thank Rod Whitby personally for the many hours that he put into creating the Meta-Doctor and this upgrade procedure, you should purchase the [http://developer.palm.com/appredirect/?packageid=org.preware.docs Preware Homebrew Documentation] app from the official app catalog, and leave a nice 5 star review containing your message of thanks.

= Caveats =

== OTA Updates ==
It is extremely unlikely that any Pre or Pre+ device will ever get another OTA update. If you preform this procedure on those devices, you should not expect OTA updates.

Performing this procedure on a Pre 2 device may allow it to receive OTA updates, but there is no guarantee.

== App Catalog ==
If your palm profile record says version 1.40.50, you will not be able to purchase apps that are marked as only compatible with webOS versions 2.x and above. This cannot be changed for these devices at this time. If your palm profile record says version 2.1.0, then you should be able to purchase all apps (depending upon your geographical restrictions and country of first activation).

=== Masquerading ===
Palm's servers only accept certain device/OS combinations as valid. While some combinations of carrier and devices running 2.1 are accepted, others have to report to the palm profile server that they are running webOS 1.4.5. This is done automatically, and cannot be changed for these devices at this time.

== Carrier-Specific Applications ==
Some carrier apps are not working in webOS 2.1. Apps that have been tested and are known to install cleanly and work will be added to the custom webOS Doctor for the appropriate device/carrier.

Known working carrier apps are listed below.

=== Sprint ===
* Sprint Portal
* Sprint TV
* Sprint Football Live
* NASCAR

===Verizon Wireless ===
* All Verizon apps should be working at this time for the Pre +. However, '''no one has tested the VZW Navigator subscription''' to confirm that the service carries over to a Meta-Doctored phone. You could be the first!
VZW Navigator is working much better for me now on VZ Palm Pre Plus with HP Web OS 2.1. The only problem I havent solved is system updates hangs. Anyone have a solution?

=== AT&T ===
* So far the only AT&T specific app tested with this method is the Amazon MP3 app, which may be installed using the process found [http://forums.precentral.net/palm-pre-2/279364-how-install-amazon-mp3-app-your-unlocked-pre2-step-step.html here]. However, non-free music has NOT yet been tested with this process.

== Patches ==
Not all patches have been ported over yet. If you want to check for a certain patch, please see webOS Internals' [http://patches.webos-internals.org/?do=browse&webosver=2.1.0&category=all webOS-Patches Web Portal].

== Adobe Flash ==
Adobe Flash is not included in this webOS 2.1 doctor, but can be added with files from a VZW Pre 2 2.0.1 doctor.

=== Adding Flash Support ===
The easiest way to enable Adobe Flash on your webOS 2.1.0 legacy device is by creating a modular package and installing that, along with a patch to make the Adobe Flash preferences visible in the browser. Or you can do it manually. See ([http://www.webos-internals.org/wiki/Adding_flash_support here]) for more detail.

== Performance ==
* '''OVERCLOCKING IS NOW SUPPORTED'''. Palm has just released the source code for the kernel used in webOS 2.1.0. An experimental version of UberKernel has already appeared in the experimental feeds, but casual users should wait for a stable one.
* The Pre Plus has 512 MB of memory and thus runs 2.1 quite well, but this is not the case with the original Pre since it has only 256 MB. Luckily, Palm adopted WebOS Internals's configuration of the standard Linux compcache technology that was ported to the custom kernels, and it comes active, but with only 10 MB. One potential way to enhance performance in original Pre devices is to make the compcache bigger.

=== Increase compcache size, Temporary Method ===
You can use the Govnah application to increase the size of the compcache. Disable compcache, change the size, and then reenable.

=== Increase compcache size, Permanent Method ===
You have to edit the file /etc/event.d/compcache and change the value from 10240 to 32768.

For example, you could follow these steps:

#Make sure '''novacomd''' is running on your computer.
#Use a terminal (as described on the Wiki page [http://www.webos-internals.org/wiki/Portal:Accessing_Linux Accessing Linux on the Pre... ]) to run '''novaterm''' and access your phone. Type in the following: <pre>/usr/sbin/rootfs_open -t</pre><pre>vi /etc/event.d/compcache</pre>
#vi is a bit different so, for those not familiar with how it works, the fastest way to navigate and make the required edit is in parentheses below:
##Go down to line 10 (Type <tt>10</tt> then hit <tt>Shift+G</tt>)
##Move to the first <tt>1</tt> (Type <tt>4w</tt>)
##Enter replace mode (<tt>Shift+R</tt>) and type <tt>32768</tt>
##Exit back to command mode (Press <tt>Esc</tt> or <tt>Ctrl+C</tt>)
##Save and Quit (Type <tt>:wq</tt>)
#Reboot your Pre and verify it's working by using Govnah. While you are still in novaterm, you can type the following to reboot:<pre>/sbin/reboot</pre>

== Palm Profile ==
* Some people have had problems signing in to existing Palm Profiles on 2.1 due to backup data. To make sure that you can sign in to your profile on 2.1, you should disable backups before doctoring to 2.1 and delete server side backups. Of course, this deletes most of the data in your Palm Profile (memos, tasks, calender entries, accounts, ...). Your apps will be restored on 2.1, but that is about it. Note that not all people have issues with backups. If you would rather not delete your Palm Profile data, you can try doctoring to 2.1 without turning backups off and see if restoring everything works. If it doesn't, you'll have to doctor back to 1.4.5 to turn off backups or use a new Palm Profile, though.

* If you get 9.9.9 in palm.com/palmprofile, then you can doctor back to 1.4.5 for your carrier and log in, then delete backup info in backup app and then 2.1.0 metadoctor it.

* If you get "Dr. Skipped Firstuse" as the name of your palm profile in the new accounts app in 2.1.0 and/or if the gesture application creates a blank screen, you have a false profile problem. You need to doctor back to 1.4.5 for your carrier and login in, then delete backup info in backup app and then 2.1.0 metadoctor it. To avoid this problem, redownload the latest version of the metadoctor and run the appropiate script with the <tt>--wifi-only</tt> switch. Note: Only use <tt>--wifi-only</tt> if you do not intend to have cellular service on the device as this option disables the modem update and renders cellular service inoperable without re-doctoring.

* Alternative fix for above problem: If your profile works fine but the Impostah app and the Accounts app show your profile name as "Dr. Skipped First Use" although your phone ran the first use app after doctoring, erase your backup data from the backup app by turning off backups and choose Erase Apps and Data from the reset options in the Device Info app.

*If you get stuck at the "Auto Locate" selection screen during the login process, you can re-doctor using the same 2.1 doctor file and it will go through. It appears to be an issue when creating a new profile in 2.1 rather than "porting" your 1.4.5 profile to 2.1. After the second doctoring, you will "Sign In" to an existing profile (the one you created during the first profile login after doctoring), rather than creating a new profile.

==GPS==
Step-by-step approach for those experiencing problems with GPS following upgrade.
# To enable GPS functionality go to the "Location Services" application (click "Turn On" if GPS has been completely disabled). From there go to the "Preferences" menu in the top left hand corner and select the "Locate Me Using..." sub-menu item. Ensure that both "GPS" and "Google Services" are enabled (you may be prompted to accept the Terms of Service). Close the "Location Services" application.
# Next you need to bring up the "GPS Information" application; to do this dial ##477# (or #*477# on GSM/UMTS Pres) in the phone application (the "477" corresponds to the letter keys "GPS").
# Click the "Get Fix" button. You may receive a "GPS Error - Position Unavailable" message which you can close. Keep pressing "Get Fix" until a fix is established (it may take several attempts). You will know a fix has been established when some statistics (Latitude, Longitude etc) are displayed.
# Once a fix has been established, GPS should continue to function normally thereafter.

==Voice Dialing==
For the Sprint-Franken-Pre2 (Pre2-GSM-Unlocked confirmed + sprint-pre(-)comm) and perhaps the Verizon-Franken-Pre2, the voice dialing application may not work after the metadoctor procedure above. The application may or may not even launch after tapped. You may experience problems with sound intermittently not working, esp. when playing media, or using the phone. This will be corrected automatically with a webOS OTA Update to 2.1.0. When the phone prompts for the update, install it.

To speed up the process, go to the "System Updates" app on your phone. The WebOS 2.1 update should appear after it searches for updates. (The update for a Sprint FrankenPre2 is ~7MB and only took a few minutes to install).

==PRL==
=== Sprint ===

After applying 2.1.0 to a Sprint device using this method, there is currently no known way to update the PRL. There are permissions issues, and the conventional "Update Profile" and "Update PRL" from the Phone options will no longer work. The provisioner service binary from the Sprint 1.4.5 doctor does not work on webOS 2.x, so a version of that service for 2.x is required for this to ever work. It is not expected that this situation will change before Sprint releases another webOS phone running webOS 2.0 or above.

====Overview====
:1) Back up /var/lib/software/* before upgrading to webOS 2.1
:2) Restore /var/lib/software/* after upgrading to webOS 2.1
:3) Use PmModemUpdater to update your PRL.

 
For further information, exact directions, caveats, etc., please see the [http://www.webos-internals.org/wiki/Sprint_PRL_Update dedicated Sprint PRL Update Wiki Page].

=== Verizon ===
In order to update your PRL, you will need to manually program your phone OTA by dialing '''*228''' from the dialer, and choose the "Program your phone" option.

WebOS 2 Upgrade

2017-10-06T01:10:08Z

Bbito: /* Tutorials that are out of date and should not be relied upon */ Update to webOSNation link

This page is available in two languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[WebOS_2_Upgrade|WebOS 2 Upgrade]]
:[[Image:France.png]] [[WebOS_2_Upgrade-FR| WebOS 2 Upgrade-FR (Mise à jour de webOS 1.x vers webOS 2.x pour palm Pre et Pre Plus)]]

= Overview =
With the release of the webOS 2.1.0 doctor by HP for O2 and Vodafone Pre+ devices, there is now a legal way to get webOS 2.1 onto the legacy devices of carriers that are not onboard with the 2.x upgrade. Compatible devices include all Pre and Pre Plus devices. This is not compatible with Pixi devices.

'''You must read this page from top to bottom twice before starting this procedure. You must complete all steps from 0 to 6. Do not omit any steps. Do not improvise. Do not think you can ignore the instructions. If you do not follow these instructions precisely, completely and without error, you will not achieve your goal and you will annoy a lot of people with a lot of unnecessary questions in the process.'''

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

= Disclaimer =
'''This is a process that uses official HP software in unofficial ways. You should always be prepared for the unlikely possibility that your device may be completely wiped and your Palm profile may be permanently destroyed. Do not proceed unless you have made appropriate backups and are OK with that. Working knowledge of MetaDoctor and Linux systems in general is needed.'''

If you feel the need to ask whether you should do this on your primary phone, then you should not, as that indicates that you have not yet taken the required precautions and backups in case something goes wrong.

= Other Tutorials =
'''Note that this wiki page is always the authoritative source of information about this process, so you should refer to this page first for any and all instructions. Here are some other pages which you may find useful in addition to this page. They do not replace the information on this page, which you should read from top to bottom first.'''
== Tutorials that have been updated to match the latest instructions ==
* ''PreCentral'' forum user @malpha recorded a two-part [http://www.youtube.com/watch?v=CJB8NJ72kZg video overview] of the process as she followed this step-by-step. {Sprint Pre-, Ubuntu}.

Historical information: ''webosworld.com is no longer hosting webOS content in 2017''
* ''WebOS World'' writer Jake Morrison has written a How-To guide <del><nowiki>http://webosworld.com/2011/03/07/my-meta-doctor-to-2-1-experience/</nowiki></del> based directly off this walkthrough. {Sprint Pre-, Ubuntu}.

== Tutorials that are out of date and should not be relied upon ==
* webOSNation (née ''PreCentral'') forum user @djwhitey recorded a 9-minute [http://www.youtube.com/watch?v=PF2ciiNFxLc walkthrough] (includes Activation Error). {Sprint Pre-, Win7 x86, Ubuntu Server 10.04}.
* webOSNation (née ''PreCentral'') forum user @innocentbystander has written a start-to-finish guide to installing and building the Meta Doctor under Mac OS 10.6 for those with little or no experience with the command line. It can be found [http://forums.webosnation.com/webos-discussion-lounge/276785-webos-2-1-installation-step-step-guide.html here].

= Using MetaDoctor Scripts =

== Step 0: Backup your device ==
A guide by PreCentral on backing up your device can be found [http://www.precentral.net/backup here].

Make sure you have copies of all the data that you want to preserve from your palm profile. There is a possibility that you will need to clear your palm profile to be successful in this upgrade, so you should act as if that is going to happen from the start.

Also, make sure you run the [[Application:SaveRestore]] application from Preware to back up your application data - you don't want to lose your Angry Birds progress, do you?

Then copy all the files from the USB drive onto your PC to keep them safe, including music, downloads, and pictures. The webOS Doctor has been known to wipe your USB drive without warning, so you should act as if that is going to happen from the start.

If your phone is set to use the Palm Profile as the default location for contacts you may want to manually export these. To check how many palm profile contacts you have: Contacts App -> Preferences & Accounts -> tap "Palm Profile" under the "accounts" subsection.
To manually export contacts see this post: [http://forums.precentral.net/webos-synergy-synchronization/215705-howto-transfer-contacts-palm-profile-gmail-yahoo-mail-easier-way-2.html#post2886607 PreCentral Forums - How To Transfer contacts]. They can be imported back onto your phone by emailing the file of exported contacts to yourself, and opening that attachment on your phone.

== Step 1: Prerequisites ==
=== Disk Space ===

You should allow up to 10GB of disk space for this process.

=== MetaDoctor ===

See [[Application:MetaDoctor]] for information on how to install MetaDoctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

Note that the procedure for the WebOS 2 Upgrade is on this page. The MetaDoctor is simply a tool which is used by this procedure. You need to complete only Step 1: Setting up Meta-Doctor on that page. When you get to the end of Step 1: Setting up Meta-Doctor on that page, you should come back to this page and continue the procedure on this page.

=== Palm SDK ===

See [http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1661 Palm Developer Website] for Windows and [https://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1585 for Ubuntu].
Whilst the Palm SDK is not strictly required to complete this procedure, it is the best way to install the novacom and novaterm programs which are used to transfer files to and from your device and to access the command line on your device.

=== Novacom Drivers ===

If you are unable to get the official novacom drivers from the Palm SDK to connect to your device, you can alternately try Jason Robitaille's [http://universal-novacom-installer.googlecode.com/files/Universal%20Novacom%20Installer.jar Universal Novacom Driver Installer]

These drivers are necessary to interface with the Pre. The Installer is cross-platform and supports Windows (32bit and 64bit), Mac OS, and Ubuntu (32bit and 64bit). Note that it does not support the Pre 2 on Ubuntu. For that you'll need Linux-specific drivers, which HP makes available [https://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-novacom_1.0.64_i386.deb here]for 32-bit and [https://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-novacom_1.0.64_amd64.deb here] for 64-bit.

== Step 2: Prepare your Palm Profile ==
With unsupported carrier/device/OS combinations, it may be necessary to clear some Palm Profile data to allow you to sign in on webOS 2.x devices. The process is as follows:
'''Warning: this will delete data from your Palm Profile, including but not limited to: calendars, contacts, account information, email signatures, bookmarks, memos, tasks, SSM/MMS messages, and icon/launcher arrangement.'''
# Open the Backup app.
# Turn off backups, confirming that you wish to erase your palm profile information.

'''This step is extremely important if you find that after finishing the webOS 2.1 installation your saved apps don't download to your device automatically and your Palm Profile account name under Accounts is "Dr. Skipped Firstuse". You should delete your profile info and Doctor again.'''

NOTE: The latest scripts (as of 5:00pm EST) MAY allow direct conversion of a 1.4.5 profile to 2.1.0 without deleting Palm Profile data. Please read the information under "Palm Profile" below to understand the issues that my arise from attempting this, as well as the required solutions to resolve those issues.

== Step 3: Run device-specific MetaDoctor script ==
The MetaDoctor scripts will automatically download the latest necessary webOS doctors, extract and replace CDMA radio firmware as necessary, and will build and launch the modified webOS Doctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

'''A NOTE ON "RE-DOCTORING":''' If this is not your first time through this process, you should do a "git pull" and a "make clobber" to ensure you have the latest scripts and a pristine build folder. From the command line, type "cd meta-doctor" without the quotes and press enter. Then type "git pull" without the quotes and press enter. Then type "make clobber" without the quotes and press enter. Voila! You now have the latest scripts and a clean folder to build your doctor in.

'''From the meta-doctor directory''', run the meta-script that corresponds to your device (note that the strings enclosed by < and > in the following line are placeholders for values that you must supply - you cannot type the string exactly as shown):
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version>
</nowiki></pre>

You should replace <carrier>, <device>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

A list of all the scripts can be found by typing
<pre><nowiki>
ls ./scripts/
</nowiki></pre>

'''For those who for what ever reason will never be using their phone on a cellular network and wish to use the phone only on wifi, just add "--wifi-only" as an extra argument to the meta-script:'''
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version> --wifi-only
</nowiki></pre>

Again, you should replace <device>, <carrier>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

Then, when your device boots after step 4, all you need to do is configure and start wifi and then run the Gesture Tutorial and you should be good to go. Note that in this case the end of the palm profile login procedure will appear to cycle forever, so just manually reboot the device using Opt-Sym-R when that happens.

Specific additional information for each of the supported device and carrier combinations can be found below:

=== AT&T Pre+ ===
<pre><nowiki>
./scripts/meta-att-preplus-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== BellMo Pre ===
<pre><nowiki>
./scripts/meta-bellmo-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== O2 Pre ===
<pre><nowiki>
./scripts/meta-o2-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== O2 Pre+ ===
<pre><nowiki>
./scripts/meta-o2-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Pre ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

<pre><nowiki>
./scripts/meta-sprint-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Franken Unlocked Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Unlocked Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-unlocked-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Sprint Franken Verizon Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Verizon Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-verizon-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Telcel Pre ===
<pre><nowiki>
./scripts/meta-telcel-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.00 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

'''In Fact, it seems Palm has already locked out all the Telcel activated devices, so, even if you managed to hack your Meta Doctor to have a 1.4.5 profile and see the paid apps in the Catalog, you won't be able to insert your credit card data and won't be able to buy apps anymore.'''

=== Verizon Pre+ ===
<pre><nowiki>
./scripts/meta-verizon-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== Verizon FrankenPre 2 ===
<pre><nowiki>
./scripts/meta-verizon-franken-unlocked-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Verizon Pre 2 ===
<pre><nowiki>
./scripts/meta-verizon-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

The Verizon specific apps (Amazon MP3, VZ Navigator, Skype Mobile) and Voice Dialing will be present and fully functional.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== WR Pre ===

For WR devices, you should attempt to use the O2 script above first, and if you end up with a 9.9.9 version in your palm profile, then use this WR script instead.

<pre><nowiki>
./scripts/meta-wr-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

== Step 4: Run the modified webOS Doctor ==
The meta-script will automatically launch the modified webOS Doctor for you. However, if you need to move it to a different location and run it manually, the modified doctor will be a '''.jar''' file located in the build output directory:
<pre><nowiki>meta-doctor/build/meta-sprint-pre-2.1.0/webosdoctorp101ueu-wr-2.1.0.jar</nowiki></pre>

Note that the directory path will change from that example based on which script you ran, and the script will tell you the exact pathname shortly after it starts running.

Do not USB connect the phone until WebOS Doctor specifically says to.

NOTE: There have been reports that, for some users, the modified webOS doctor fails to recognize the USB connection. Similarly, up-graders have also noted that in some instances their Pre will "disconnect" from the webOS Doctor (while running) and re-boot into v.1.4.5. It has been observed that Doctoring, while putting ones Pre through the "Recovery" Reboot (as detailed [http://www.webos-internals.org/wiki/How_To_Recover here]) may mitigate these issues, and allow the Doctor to continue. There is also an instance where after pressing the "next" button to start the Doctor, the phone appeared to need charging before the Doctor would start( on a 95% full battery), and then stalled at 0%. Putting the phone into emergency recovery mode appeared to solve this problem.

Note: Sprint users please read the PRL section '''before''' running The Doctor: [http://www.webos-internals.org/wiki/WebOS_2_Upgrade#Sprint_2 "5.9.1 Sprint"].

== Step 5: There is no Step 5 ==

There used to be a complex set of additional steps required here. Too many people had trouble following them, so we automated it. You should proceed directly to Step 6.

== Step 6: Donate to WebOS Internals and purchase the Preware Homebrew Documentation app ==
If this worked for you, we would appreciate a donation at http://donate.webos-internals.org - and if you want to thank Rod Whitby personally for the many hours that he put into creating the Meta-Doctor and this upgrade procedure, you should purchase the [http://developer.palm.com/appredirect/?packageid=org.preware.docs Preware Homebrew Documentation] app from the official app catalog, and leave a nice 5 star review containing your message of thanks.

= Caveats =

== OTA Updates ==
It is extremely unlikely that any Pre or Pre+ device will ever get another OTA update. If you preform this procedure on those devices, you should not expect OTA updates.

Performing this procedure on a Pre 2 device may allow it to receive OTA updates, but there is no guarantee.

== App Catalog ==
If your palm profile record says version 1.40.50, you will not be able to purchase apps that are marked as only compatible with webOS versions 2.x and above. This cannot be changed for these devices at this time. If your palm profile record says version 2.1.0, then you should be able to purchase all apps (depending upon your geographical restrictions and country of first activation).

=== Masquerading ===
Palm's servers only accept certain device/OS combinations as valid. While some combinations of carrier and devices running 2.1 are accepted, others have to report to the palm profile server that they are running webOS 1.4.5. This is done automatically, and cannot be changed for these devices at this time.

== Carrier-Specific Applications ==
Some carrier apps are not working in webOS 2.1. Apps that have been tested and are known to install cleanly and work will be added to the custom webOS Doctor for the appropriate device/carrier.

Known working carrier apps are listed below.

=== Sprint ===
* Sprint Portal
* Sprint TV
* Sprint Football Live
* NASCAR

===Verizon Wireless ===
* All Verizon apps should be working at this time for the Pre +. However, '''no one has tested the VZW Navigator subscription''' to confirm that the service carries over to a Meta-Doctored phone. You could be the first!
VZW Navigator is working much better for me now on VZ Palm Pre Plus with HP Web OS 2.1. The only problem I havent solved is system updates hangs. Anyone have a solution?

=== AT&T ===
* So far the only AT&T specific app tested with this method is the Amazon MP3 app, which may be installed using the process found [http://forums.precentral.net/palm-pre-2/279364-how-install-amazon-mp3-app-your-unlocked-pre2-step-step.html here]. However, non-free music has NOT yet been tested with this process.

== Patches ==
Not all patches have been ported over yet. If you want to check for a certain patch, please see webOS Internals' [http://patches.webos-internals.org/?do=browse&webosver=2.1.0&category=all webOS-Patches Web Portal].

== Adobe Flash ==
Adobe Flash is not included in this webOS 2.1 doctor, but can be added with files from a VZW Pre 2 2.0.1 doctor.

=== Adding Flash Support ===
The easiest way to enable Adobe Flash on your webOS 2.1.0 legacy device is by creating a modular package and installing that, along with a patch to make the Adobe Flash preferences visible in the browser. Or you can do it manually. See ([http://www.webos-internals.org/wiki/Adding_flash_support here]) for more detail.

== Performance ==
* '''OVERCLOCKING IS NOW SUPPORTED'''. Palm has just released the source code for the kernel used in webOS 2.1.0. An experimental version of UberKernel has already appeared in the experimental feeds, but casual users should wait for a stable one.
* The Pre Plus has 512 MB of memory and thus runs 2.1 quite well, but this is not the case with the original Pre since it has only 256 MB. Luckily, Palm adopted WebOS Internals's configuration of the standard Linux compcache technology that was ported to the custom kernels, and it comes active, but with only 10 MB. One potential way to enhance performance in original Pre devices is to make the compcache bigger.

=== Increase compcache size, Temporary Method ===
You can use the Govnah application to increase the size of the compcache. Disable compcache, change the size, and then reenable.

=== Increase compcache size, Permanent Method ===
You have to edit the file /etc/event.d/compcache and change the value from 10240 to 32768.

For example, you could follow these steps:

#Make sure '''novacomd''' is running on your computer.
#Use a terminal (as described on the Wiki page [http://www.webos-internals.org/wiki/Portal:Accessing_Linux Accessing Linux on the Pre... ]) to run '''novaterm''' and access your phone. Type in the following: <pre>/usr/sbin/rootfs_open -t</pre><pre>vi /etc/event.d/compcache</pre>
#vi is a bit different so, for those not familiar with how it works, the fastest way to navigate and make the required edit is in parentheses below:
##Go down to line 10 (Type <tt>10</tt> then hit <tt>Shift+G</tt>)
##Move to the first <tt>1</tt> (Type <tt>4w</tt>)
##Enter replace mode (<tt>Shift+R</tt>) and type <tt>32768</tt>
##Exit back to command mode (Press <tt>Esc</tt> or <tt>Ctrl+C</tt>)
##Save and Quit (Type <tt>:wq</tt>)
#Reboot your Pre and verify it's working by using Govnah. While you are still in novaterm, you can type the following to reboot:<pre>/sbin/reboot</pre>

== Palm Profile ==
* Some people have had problems signing in to existing Palm Profiles on 2.1 due to backup data. To make sure that you can sign in to your profile on 2.1, you should disable backups before doctoring to 2.1 and delete server side backups. Of course, this deletes most of the data in your Palm Profile (memos, tasks, calender entries, accounts, ...). Your apps will be restored on 2.1, but that is about it. Note that not all people have issues with backups. If you would rather not delete your Palm Profile data, you can try doctoring to 2.1 without turning backups off and see if restoring everything works. If it doesn't, you'll have to doctor back to 1.4.5 to turn off backups or use a new Palm Profile, though.

* If you get 9.9.9 in palm.com/palmprofile, then you can doctor back to 1.4.5 for your carrier and log in, then delete backup info in backup app and then 2.1.0 metadoctor it.

* If you get "Dr. Skipped Firstuse" as the name of your palm profile in the new accounts app in 2.1.0 and/or if the gesture application creates a blank screen, you have a false profile problem. You need to doctor back to 1.4.5 for your carrier and login in, then delete backup info in backup app and then 2.1.0 metadoctor it. To avoid this problem, redownload the latest version of the metadoctor and run the appropiate script with the <tt>--wifi-only</tt> switch. Note: Only use <tt>--wifi-only</tt> if you do not intend to have cellular service on the device as this option disables the modem update and renders cellular service inoperable without re-doctoring.

* Alternative fix for above problem: If your profile works fine but the Impostah app and the Accounts app show your profile name as "Dr. Skipped First Use" although your phone ran the first use app after doctoring, erase your backup data from the backup app by turning off backups and choose Erase Apps and Data from the reset options in the Device Info app.

*If you get stuck at the "Auto Locate" selection screen during the login process, you can re-doctor using the same 2.1 doctor file and it will go through. It appears to be an issue when creating a new profile in 2.1 rather than "porting" your 1.4.5 profile to 2.1. After the second doctoring, you will "Sign In" to an existing profile (the one you created during the first profile login after doctoring), rather than creating a new profile.

==GPS==
Step-by-step approach for those experiencing problems with GPS following upgrade.
# To enable GPS functionality go to the "Location Services" application (click "Turn On" if GPS has been completely disabled). From there go to the "Preferences" menu in the top left hand corner and select the "Locate Me Using..." sub-menu item. Ensure that both "GPS" and "Google Services" are enabled (you may be prompted to accept the Terms of Service). Close the "Location Services" application.
# Next you need to bring up the "GPS Information" application; to do this dial ##477# (or #*477# on GSM/UMTS Pres) in the phone application (the "477" corresponds to the letter keys "GPS").
# Click the "Get Fix" button. You may receive a "GPS Error - Position Unavailable" message which you can close. Keep pressing "Get Fix" until a fix is established (it may take several attempts). You will know a fix has been established when some statistics (Latitude, Longitude etc) are displayed.
# Once a fix has been established, GPS should continue to function normally thereafter.

==Voice Dialing==
For the Sprint-Franken-Pre2 (Pre2-GSM-Unlocked confirmed + sprint-pre(-)comm) and perhaps the Verizon-Franken-Pre2, the voice dialing application may not work after the metadoctor procedure above. The application may or may not even launch after tapped. You may experience problems with sound intermittently not working, esp. when playing media, or using the phone. This will be corrected automatically with a webOS OTA Update to 2.1.0. When the phone prompts for the update, install it.

To speed up the process, go to the "System Updates" app on your phone. The WebOS 2.1 update should appear after it searches for updates. (The update for a Sprint FrankenPre2 is ~7MB and only took a few minutes to install).

==PRL==
=== Sprint ===

After applying 2.1.0 to a Sprint device using this method, there is currently no known way to update the PRL. There are permissions issues, and the conventional "Update Profile" and "Update PRL" from the Phone options will no longer work. The provisioner service binary from the Sprint 1.4.5 doctor does not work on webOS 2.x, so a version of that service for 2.x is required for this to ever work. It is not expected that this situation will change before Sprint releases another webOS phone running webOS 2.0 or above.

====Overview====
:1) Back up /var/lib/software/* before upgrading to webOS 2.1
:2) Restore /var/lib/software/* after upgrading to webOS 2.1
:3) Use PmModemUpdater to update your PRL.

 
For further information, exact directions, caveats, etc., please see the [http://www.webos-internals.org/wiki/Sprint_PRL_Update dedicated Sprint PRL Update Wiki Page].

=== Verizon ===
In order to update your PRL, you will need to manually program your phone OTA by dialing '''*228''' from the dialer, and choose the "Program your phone" option.

WebOS 2 Upgrade

2017-10-06T01:02:00Z

Bbito: /* Tutorials that have been updated to match the latest instructions */ Strikethrough and de-link webosworld.com links

This page is available in two languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[WebOS_2_Upgrade|WebOS 2 Upgrade]]
:[[Image:France.png]] [[WebOS_2_Upgrade-FR| WebOS 2 Upgrade-FR (Mise à jour de webOS 1.x vers webOS 2.x pour palm Pre et Pre Plus)]]

= Overview =
With the release of the webOS 2.1.0 doctor by HP for O2 and Vodafone Pre+ devices, there is now a legal way to get webOS 2.1 onto the legacy devices of carriers that are not onboard with the 2.x upgrade. Compatible devices include all Pre and Pre Plus devices. This is not compatible with Pixi devices.

'''You must read this page from top to bottom twice before starting this procedure. You must complete all steps from 0 to 6. Do not omit any steps. Do not improvise. Do not think you can ignore the instructions. If you do not follow these instructions precisely, completely and without error, you will not achieve your goal and you will annoy a lot of people with a lot of unnecessary questions in the process.'''

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

= Disclaimer =
'''This is a process that uses official HP software in unofficial ways. You should always be prepared for the unlikely possibility that your device may be completely wiped and your Palm profile may be permanently destroyed. Do not proceed unless you have made appropriate backups and are OK with that. Working knowledge of MetaDoctor and Linux systems in general is needed.'''

If you feel the need to ask whether you should do this on your primary phone, then you should not, as that indicates that you have not yet taken the required precautions and backups in case something goes wrong.

= Other Tutorials =
'''Note that this wiki page is always the authoritative source of information about this process, so you should refer to this page first for any and all instructions. Here are some other pages which you may find useful in addition to this page. They do not replace the information on this page, which you should read from top to bottom first.'''
== Tutorials that have been updated to match the latest instructions ==
* ''PreCentral'' forum user @malpha recorded a two-part [http://www.youtube.com/watch?v=CJB8NJ72kZg video overview] of the process as she followed this step-by-step. {Sprint Pre-, Ubuntu}.

Historical information: ''webosworld.com is no longer hosting webOS content in 2017''
* ''WebOS World'' writer Jake Morrison has written a How-To guide <del><nowiki>http://webosworld.com/2011/03/07/my-meta-doctor-to-2-1-experience/</nowiki></del> based directly off this walkthrough. {Sprint Pre-, Ubuntu}.

== Tutorials that are out of date and should not be relied upon ==
* ''PreCentral'' forum user @djwhitey recorded a 9-minute [http://www.youtube.com/watch?v=PF2ciiNFxLc walkthrough] (includes Activation Error). {Sprint Pre-, Win7 x86, Ubuntu Server 10.04}.
* ''PreCentral'' forum user @innocentbystander has written a start-to-finish guide to installing and building the Meta Doctor under Mac OS 10.6 for those with little or no experience with the command line. It can be found [http://forums.precentral.net/showthread.php?p=2885787 here].

= Using MetaDoctor Scripts =

== Step 0: Backup your device ==
A guide by PreCentral on backing up your device can be found [http://www.precentral.net/backup here].

Make sure you have copies of all the data that you want to preserve from your palm profile. There is a possibility that you will need to clear your palm profile to be successful in this upgrade, so you should act as if that is going to happen from the start.

Also, make sure you run the [[Application:SaveRestore]] application from Preware to back up your application data - you don't want to lose your Angry Birds progress, do you?

Then copy all the files from the USB drive onto your PC to keep them safe, including music, downloads, and pictures. The webOS Doctor has been known to wipe your USB drive without warning, so you should act as if that is going to happen from the start.

If your phone is set to use the Palm Profile as the default location for contacts you may want to manually export these. To check how many palm profile contacts you have: Contacts App -> Preferences & Accounts -> tap "Palm Profile" under the "accounts" subsection.
To manually export contacts see this post: [http://forums.precentral.net/webos-synergy-synchronization/215705-howto-transfer-contacts-palm-profile-gmail-yahoo-mail-easier-way-2.html#post2886607 PreCentral Forums - How To Transfer contacts]. They can be imported back onto your phone by emailing the file of exported contacts to yourself, and opening that attachment on your phone.

== Step 1: Prerequisites ==
=== Disk Space ===

You should allow up to 10GB of disk space for this process.

=== MetaDoctor ===

See [[Application:MetaDoctor]] for information on how to install MetaDoctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

Note that the procedure for the WebOS 2 Upgrade is on this page. The MetaDoctor is simply a tool which is used by this procedure. You need to complete only Step 1: Setting up Meta-Doctor on that page. When you get to the end of Step 1: Setting up Meta-Doctor on that page, you should come back to this page and continue the procedure on this page.

=== Palm SDK ===

See [http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1661 Palm Developer Website] for Windows and [https://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1585 for Ubuntu].
Whilst the Palm SDK is not strictly required to complete this procedure, it is the best way to install the novacom and novaterm programs which are used to transfer files to and from your device and to access the command line on your device.

=== Novacom Drivers ===

If you are unable to get the official novacom drivers from the Palm SDK to connect to your device, you can alternately try Jason Robitaille's [http://universal-novacom-installer.googlecode.com/files/Universal%20Novacom%20Installer.jar Universal Novacom Driver Installer]

These drivers are necessary to interface with the Pre. The Installer is cross-platform and supports Windows (32bit and 64bit), Mac OS, and Ubuntu (32bit and 64bit). Note that it does not support the Pre 2 on Ubuntu. For that you'll need Linux-specific drivers, which HP makes available [https://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-novacom_1.0.64_i386.deb here]for 32-bit and [https://cdn.downloads.palm.com/sdkdownloads/2.1.0.519/sdkBinaries/palm-novacom_1.0.64_amd64.deb here] for 64-bit.

== Step 2: Prepare your Palm Profile ==
With unsupported carrier/device/OS combinations, it may be necessary to clear some Palm Profile data to allow you to sign in on webOS 2.x devices. The process is as follows:
'''Warning: this will delete data from your Palm Profile, including but not limited to: calendars, contacts, account information, email signatures, bookmarks, memos, tasks, SSM/MMS messages, and icon/launcher arrangement.'''
# Open the Backup app.
# Turn off backups, confirming that you wish to erase your palm profile information.

'''This step is extremely important if you find that after finishing the webOS 2.1 installation your saved apps don't download to your device automatically and your Palm Profile account name under Accounts is "Dr. Skipped Firstuse". You should delete your profile info and Doctor again.'''

NOTE: The latest scripts (as of 5:00pm EST) MAY allow direct conversion of a 1.4.5 profile to 2.1.0 without deleting Palm Profile data. Please read the information under "Palm Profile" below to understand the issues that my arise from attempting this, as well as the required solutions to resolve those issues.

== Step 3: Run device-specific MetaDoctor script ==
The MetaDoctor scripts will automatically download the latest necessary webOS doctors, extract and replace CDMA radio firmware as necessary, and will build and launch the modified webOS Doctor.

'''NOTE THAT USING CYGWIN ON WINDOWS IS NO LONGER SUPPORTED AND WILL MAKE YOUR PHONE FAIL TO BOOT'''

'''A NOTE ON "RE-DOCTORING":''' If this is not your first time through this process, you should do a "git pull" and a "make clobber" to ensure you have the latest scripts and a pristine build folder. From the command line, type "cd meta-doctor" without the quotes and press enter. Then type "git pull" without the quotes and press enter. Then type "make clobber" without the quotes and press enter. Voila! You now have the latest scripts and a clean folder to build your doctor in.

'''From the meta-doctor directory''', run the meta-script that corresponds to your device (note that the strings enclosed by < and > in the following line are placeholders for values that you must supply - you cannot type the string exactly as shown):
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version>
</nowiki></pre>

You should replace <carrier>, <device>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

A list of all the scripts can be found by typing
<pre><nowiki>
ls ./scripts/
</nowiki></pre>

'''For those who for what ever reason will never be using their phone on a cellular network and wish to use the phone only on wifi, just add "--wifi-only" as an extra argument to the meta-script:'''
<pre><nowiki>
./scripts/meta-<carrier>-<device>-<version> --wifi-only
</nowiki></pre>

Again, you should replace <device>, <carrier>, and <version> with the specific values that match your particular situation, using the detailed information given in the section below that matches your particular device and carrier.

Then, when your device boots after step 4, all you need to do is configure and start wifi and then run the Gesture Tutorial and you should be good to go. Note that in this case the end of the palm profile login procedure will appear to cycle forever, so just manually reboot the device using Opt-Sym-R when that happens.

Specific additional information for each of the supported device and carrier combinations can be found below:

=== AT&T Pre+ ===
<pre><nowiki>
./scripts/meta-att-preplus-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== BellMo Pre ===
<pre><nowiki>
./scripts/meta-bellmo-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

=== O2 Pre ===
<pre><nowiki>
./scripts/meta-o2-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== O2 Pre+ ===
<pre><nowiki>
./scripts/meta-o2-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Pre ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

<pre><nowiki>
./scripts/meta-sprint-pre-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

=== Sprint Franken Unlocked Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Unlocked Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-unlocked-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Sprint Franken Verizon Pre 2 ===
'''Be aware that there is no publicly available solution for Sprint Navigation or Sprint PRL Update for this procedure. If you depend on either of those things, you should not upgrade to webOS 2.x'''

NOTE: Tokens are no longer needed to create a Sprint Franken Verizon Pre 2. You only need to run the script below. However, it is still a good idea to capture and store the tokens from each phone for potential future use.

<pre><nowiki>
./scripts/meta-sprint-franken-verizon-pre2-2.2.4
</nowiki></pre>

You will end up with version 2.2.4 listed in your palm profile, and version 2.2.4 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Telcel Pre ===
<pre><nowiki>
./scripts/meta-telcel-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.00 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

'''In Fact, it seems Palm has already locked out all the Telcel activated devices, so, even if you managed to hack your Meta Doctor to have a 1.4.5 profile and see the paid apps in the Catalog, you won't be able to insert your credit card data and won't be able to buy apps anymore.'''

=== Verizon Pre+ ===
<pre><nowiki>
./scripts/meta-verizon-preplus-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== Verizon FrankenPre 2 ===
<pre><nowiki>
./scripts/meta-verizon-franken-unlocked-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

The "Voice Dial" app may not work. Please see the Voice Dialing section below to remedy this.

=== Verizon Pre 2 ===
<pre><nowiki>
./scripts/meta-verizon-pre2-2.1.0
</nowiki></pre>

You will end up with version 2.1.0 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

The Verizon specific apps (Amazon MP3, VZ Navigator, Skype Mobile) and Voice Dialing will be present and fully functional.

You should be able to purchase apps that require a minimum webOS 2.x version (depending upon geo-restrictions and country of first activation).

In order to update your PRL, you will need to manually program your phone OTA by dialing *228 from the dialer, and choose the "Program your phone" option.

=== WR Pre ===

For WR devices, you should attempt to use the O2 script above first, and if you end up with a 9.9.9 version in your palm profile, then use this WR script instead.

<pre><nowiki>
./scripts/meta-wr-pre-2.1.0
</nowiki></pre>

You will end up with version 1.40.50 listed in your palm profile, and version 2.1.0 listed in the Device Info application.

You will not be able to purchase apps that require a minimum webOS 2.x version.

== Step 4: Run the modified webOS Doctor ==
The meta-script will automatically launch the modified webOS Doctor for you. However, if you need to move it to a different location and run it manually, the modified doctor will be a '''.jar''' file located in the build output directory:
<pre><nowiki>meta-doctor/build/meta-sprint-pre-2.1.0/webosdoctorp101ueu-wr-2.1.0.jar</nowiki></pre>

Note that the directory path will change from that example based on which script you ran, and the script will tell you the exact pathname shortly after it starts running.

Do not USB connect the phone until WebOS Doctor specifically says to.

NOTE: There have been reports that, for some users, the modified webOS doctor fails to recognize the USB connection. Similarly, up-graders have also noted that in some instances their Pre will "disconnect" from the webOS Doctor (while running) and re-boot into v.1.4.5. It has been observed that Doctoring, while putting ones Pre through the "Recovery" Reboot (as detailed [http://www.webos-internals.org/wiki/How_To_Recover here]) may mitigate these issues, and allow the Doctor to continue. There is also an instance where after pressing the "next" button to start the Doctor, the phone appeared to need charging before the Doctor would start( on a 95% full battery), and then stalled at 0%. Putting the phone into emergency recovery mode appeared to solve this problem.

Note: Sprint users please read the PRL section '''before''' running The Doctor: [http://www.webos-internals.org/wiki/WebOS_2_Upgrade#Sprint_2 "5.9.1 Sprint"].

== Step 5: There is no Step 5 ==

There used to be a complex set of additional steps required here. Too many people had trouble following them, so we automated it. You should proceed directly to Step 6.

== Step 6: Donate to WebOS Internals and purchase the Preware Homebrew Documentation app ==
If this worked for you, we would appreciate a donation at http://donate.webos-internals.org - and if you want to thank Rod Whitby personally for the many hours that he put into creating the Meta-Doctor and this upgrade procedure, you should purchase the [http://developer.palm.com/appredirect/?packageid=org.preware.docs Preware Homebrew Documentation] app from the official app catalog, and leave a nice 5 star review containing your message of thanks.

= Caveats =

== OTA Updates ==
It is extremely unlikely that any Pre or Pre+ device will ever get another OTA update. If you preform this procedure on those devices, you should not expect OTA updates.

Performing this procedure on a Pre 2 device may allow it to receive OTA updates, but there is no guarantee.

== App Catalog ==
If your palm profile record says version 1.40.50, you will not be able to purchase apps that are marked as only compatible with webOS versions 2.x and above. This cannot be changed for these devices at this time. If your palm profile record says version 2.1.0, then you should be able to purchase all apps (depending upon your geographical restrictions and country of first activation).

=== Masquerading ===
Palm's servers only accept certain device/OS combinations as valid. While some combinations of carrier and devices running 2.1 are accepted, others have to report to the palm profile server that they are running webOS 1.4.5. This is done automatically, and cannot be changed for these devices at this time.

== Carrier-Specific Applications ==
Some carrier apps are not working in webOS 2.1. Apps that have been tested and are known to install cleanly and work will be added to the custom webOS Doctor for the appropriate device/carrier.

Known working carrier apps are listed below.

=== Sprint ===
* Sprint Portal
* Sprint TV
* Sprint Football Live
* NASCAR

===Verizon Wireless ===
* All Verizon apps should be working at this time for the Pre +. However, '''no one has tested the VZW Navigator subscription''' to confirm that the service carries over to a Meta-Doctored phone. You could be the first!
VZW Navigator is working much better for me now on VZ Palm Pre Plus with HP Web OS 2.1. The only problem I havent solved is system updates hangs. Anyone have a solution?

=== AT&T ===
* So far the only AT&T specific app tested with this method is the Amazon MP3 app, which may be installed using the process found [http://forums.precentral.net/palm-pre-2/279364-how-install-amazon-mp3-app-your-unlocked-pre2-step-step.html here]. However, non-free music has NOT yet been tested with this process.

== Patches ==
Not all patches have been ported over yet. If you want to check for a certain patch, please see webOS Internals' [http://patches.webos-internals.org/?do=browse&webosver=2.1.0&category=all webOS-Patches Web Portal].

== Adobe Flash ==
Adobe Flash is not included in this webOS 2.1 doctor, but can be added with files from a VZW Pre 2 2.0.1 doctor.

=== Adding Flash Support ===
The easiest way to enable Adobe Flash on your webOS 2.1.0 legacy device is by creating a modular package and installing that, along with a patch to make the Adobe Flash preferences visible in the browser. Or you can do it manually. See ([http://www.webos-internals.org/wiki/Adding_flash_support here]) for more detail.

== Performance ==
* '''OVERCLOCKING IS NOW SUPPORTED'''. Palm has just released the source code for the kernel used in webOS 2.1.0. An experimental version of UberKernel has already appeared in the experimental feeds, but casual users should wait for a stable one.
* The Pre Plus has 512 MB of memory and thus runs 2.1 quite well, but this is not the case with the original Pre since it has only 256 MB. Luckily, Palm adopted WebOS Internals's configuration of the standard Linux compcache technology that was ported to the custom kernels, and it comes active, but with only 10 MB. One potential way to enhance performance in original Pre devices is to make the compcache bigger.

=== Increase compcache size, Temporary Method ===
You can use the Govnah application to increase the size of the compcache. Disable compcache, change the size, and then reenable.

=== Increase compcache size, Permanent Method ===
You have to edit the file /etc/event.d/compcache and change the value from 10240 to 32768.

For example, you could follow these steps:

#Make sure '''novacomd''' is running on your computer.
#Use a terminal (as described on the Wiki page [http://www.webos-internals.org/wiki/Portal:Accessing_Linux Accessing Linux on the Pre... ]) to run '''novaterm''' and access your phone. Type in the following: <pre>/usr/sbin/rootfs_open -t</pre><pre>vi /etc/event.d/compcache</pre>
#vi is a bit different so, for those not familiar with how it works, the fastest way to navigate and make the required edit is in parentheses below:
##Go down to line 10 (Type <tt>10</tt> then hit <tt>Shift+G</tt>)
##Move to the first <tt>1</tt> (Type <tt>4w</tt>)
##Enter replace mode (<tt>Shift+R</tt>) and type <tt>32768</tt>
##Exit back to command mode (Press <tt>Esc</tt> or <tt>Ctrl+C</tt>)
##Save and Quit (Type <tt>:wq</tt>)
#Reboot your Pre and verify it's working by using Govnah. While you are still in novaterm, you can type the following to reboot:<pre>/sbin/reboot</pre>

== Palm Profile ==
* Some people have had problems signing in to existing Palm Profiles on 2.1 due to backup data. To make sure that you can sign in to your profile on 2.1, you should disable backups before doctoring to 2.1 and delete server side backups. Of course, this deletes most of the data in your Palm Profile (memos, tasks, calender entries, accounts, ...). Your apps will be restored on 2.1, but that is about it. Note that not all people have issues with backups. If you would rather not delete your Palm Profile data, you can try doctoring to 2.1 without turning backups off and see if restoring everything works. If it doesn't, you'll have to doctor back to 1.4.5 to turn off backups or use a new Palm Profile, though.

* If you get 9.9.9 in palm.com/palmprofile, then you can doctor back to 1.4.5 for your carrier and log in, then delete backup info in backup app and then 2.1.0 metadoctor it.

* If you get "Dr. Skipped Firstuse" as the name of your palm profile in the new accounts app in 2.1.0 and/or if the gesture application creates a blank screen, you have a false profile problem. You need to doctor back to 1.4.5 for your carrier and login in, then delete backup info in backup app and then 2.1.0 metadoctor it. To avoid this problem, redownload the latest version of the metadoctor and run the appropiate script with the <tt>--wifi-only</tt> switch. Note: Only use <tt>--wifi-only</tt> if you do not intend to have cellular service on the device as this option disables the modem update and renders cellular service inoperable without re-doctoring.

* Alternative fix for above problem: If your profile works fine but the Impostah app and the Accounts app show your profile name as "Dr. Skipped First Use" although your phone ran the first use app after doctoring, erase your backup data from the backup app by turning off backups and choose Erase Apps and Data from the reset options in the Device Info app.

*If you get stuck at the "Auto Locate" selection screen during the login process, you can re-doctor using the same 2.1 doctor file and it will go through. It appears to be an issue when creating a new profile in 2.1 rather than "porting" your 1.4.5 profile to 2.1. After the second doctoring, you will "Sign In" to an existing profile (the one you created during the first profile login after doctoring), rather than creating a new profile.

==GPS==
Step-by-step approach for those experiencing problems with GPS following upgrade.
# To enable GPS functionality go to the "Location Services" application (click "Turn On" if GPS has been completely disabled). From there go to the "Preferences" menu in the top left hand corner and select the "Locate Me Using..." sub-menu item. Ensure that both "GPS" and "Google Services" are enabled (you may be prompted to accept the Terms of Service). Close the "Location Services" application.
# Next you need to bring up the "GPS Information" application; to do this dial ##477# (or #*477# on GSM/UMTS Pres) in the phone application (the "477" corresponds to the letter keys "GPS").
# Click the "Get Fix" button. You may receive a "GPS Error - Position Unavailable" message which you can close. Keep pressing "Get Fix" until a fix is established (it may take several attempts). You will know a fix has been established when some statistics (Latitude, Longitude etc) are displayed.
# Once a fix has been established, GPS should continue to function normally thereafter.

==Voice Dialing==
For the Sprint-Franken-Pre2 (Pre2-GSM-Unlocked confirmed + sprint-pre(-)comm) and perhaps the Verizon-Franken-Pre2, the voice dialing application may not work after the metadoctor procedure above. The application may or may not even launch after tapped. You may experience problems with sound intermittently not working, esp. when playing media, or using the phone. This will be corrected automatically with a webOS OTA Update to 2.1.0. When the phone prompts for the update, install it.

To speed up the process, go to the "System Updates" app on your phone. The WebOS 2.1 update should appear after it searches for updates. (The update for a Sprint FrankenPre2 is ~7MB and only took a few minutes to install).

==PRL==
=== Sprint ===

After applying 2.1.0 to a Sprint device using this method, there is currently no known way to update the PRL. There are permissions issues, and the conventional "Update Profile" and "Update PRL" from the Phone options will no longer work. The provisioner service binary from the Sprint 1.4.5 doctor does not work on webOS 2.x, so a version of that service for 2.x is required for this to ever work. It is not expected that this situation will change before Sprint releases another webOS phone running webOS 2.0 or above.

====Overview====
:1) Back up /var/lib/software/* before upgrading to webOS 2.1
:2) Restore /var/lib/software/* after upgrading to webOS 2.1
:3) Use PmModemUpdater to update your PRL.

 
For further information, exact directions, caveats, etc., please see the [http://www.webos-internals.org/wiki/Sprint_PRL_Update dedicated Sprint PRL Update Wiki Page].

=== Verizon ===
In order to update your PRL, you will need to manually program your phone OTA by dialing '''*228''' from the dialer, and choose the "Program your phone" option.

Sprint Pre 2

2017-10-05T22:33:33Z

Bbito: /* Step 16 */ update with 2.2.4 scripts

This is the page where we document the complete Sprint Pre 2 procedure, hardware and software.

= Hardware =

Rich Dunbar has created a very detailed step by step pictorial guide for swapping a Sprint Pre- comms board into a Pre 2. Important note that the Sprint Comm board must be activated PRIOR to this process. Cannot activate a Sprint Comm board through the Pre 2 at this time. You should also have already read through and understand the entire software portion (Step 16 in this guide) BEFORE starting this process. Pay special attention to Step 2: Prepare Your Palm Profile.

== Step 1 - Introduction ==

[[Image:Slide1.PNG]]
== Step 2 ==

[[Image:Slide2.PNG]]
== Step 3 ==

[[Image:Slide3.PNG]]
== Step 4 ==

[[Image:Slide4.PNG]]
== Step 5 ==

[[Image:Slide5.PNG]]
== Step 6 ==

[[Image:Slide6.PNG]]
== Step 7 ==

[[Image:Slide7.PNG]]
== Step 8 ==

[[Image:Slide8.PNG]]
== Step 9 ==

[[Image:Slide9.PNG]]
== Step 10 ==

[[Image:Slide10.PNG]]
== Step 11 ==

[[Image:Slide11.PNG]]
== Step 12 ==

[[Image:Slide12.PNG]]
== Step 13 ==

[[Image:Slide13.PNG]]
== Step 14 ==

[[Image:Slide14.PNG]]
'''YOU HAVE TO BE EXTRA CAREFUL WITH THE VOLUME ROCKER RIBBON AS IT WILL BREAK IF NOT ALIGNED PROPERLY'''

== Step 15 ==

[[Image:Slide15.PNG]]

= Software =

== Step 16 ==

Follow the instructions on [[WebOS_2_Upgrade]] and use the ./scripts/meta-sprint-franken-unlocked-pre2-2.2.4 or ./scripts/meta-sprint-franken-verizon-pre2-2.2.4 depending upon whether your Pre 2 is Unlocked or Verizon branded. See [http://www.webos-internals.org/wiki/WebOS_2_Upgrade#Sprint_Franken_Unlocked_Pre_2 Sprint_Franken_Unlocked_Pre_2] or [http://www.webos-internals.org/wiki/WebOS_2_Upgrade#Sprint_Franken_Verizon_Pre_2 Sprint_Franken_Verizon_Pre_2]

Application:Preware

2017-10-05T20:37:26Z

Bbito: /* Installing Preware */ Change link for Preware Homebrew Documentation to github repo

[[Category:Application]]
This page is currently available in four languages:
: [[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
: [[Image:France.png]] [[Application:Preware-FR]]
: [[Image:Germany.png]] [[Application:Preware-DE]]
: [[Image:China.png]] [[Application:Preware-ZH]]

{{application
| name=Preware
| type=webOS
| version=Version: 1.9.7 (15 December 2011)
| tag=Utilities
| screenshot=Preware_ss1.png
| description=
}}

 
== Summary ==

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre, Palm Pixi, and the HP TouchPad. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
=== Key features ===
Install / Remove / Update:
* Homebrew Applications including advanced applications with special requirements.
* WebOS Themes
* Patches
* webOS Kernels
* Support for installation of signed packages

 
=== Status ===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009, it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009, it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009, it also supports installation of themes.
* Since 8 October 2009, it also supports installation of webOS patches.
* Since 12 Jan 2010, it also supports all Palm App Catalog feeds.
* Since 3 May 2010, it also supports installation of webOS custom kernels.
* Since 20 July 2010, it also supports installation of packages from URLs and local files.
* Since 24 July 2010, is also supports blacklisting packages and authors.
* Since 8 June 2011, access to webOS app catalog feeds is no longer available to third party developers or applications.
* Since 15 December 2011, access to webOS app catalog feeds has been restored via App Tuckerbox.
* Since 15 December 2011, it also supports downloading feeds and packages from authenticated secure sites.

 
=== License ===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware 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 [mailto:support@webos-internals.org authors].

 

== Installing Preware ==

There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.

For a step-by-step tutorial, the official [https://github.com/rwhitby/phd Preware Homebrew Documentation] '''''was''''' highly recommended but it was available from the now closed app catalog and is no longer available for installation although one could build it from the github source linked above.

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
=== Installing Preware using the official HP/Palm SDK ===

To install Preware on any webOS device, the following procedure is recommended if you're having problems with WebOS Quick Install:

# Install the latest official Palm webOS SDK from http://developer.palm.com
# '''Disconnect your device''' (I repeat, do not have your device connected, no cables in the device, device not even anywhere near the computer), and run the latest webOS Doctor to install or upgrade your Novacom drivers
# Close the doctor
# Your device should remain disconnected
# Download the latest Preware package onto your computer from http://get.preware.net
## To install Preware on a device, download the 'arm' .ipk file
## To install Preware on an emulator, download the 'i686' .ipk file
# Typing webos20090606, select the developer mode icon that will appear, and verify that your device is in developer mode
# Connect your device to your computers USB port, and select 'Just Charge' (or 'Cancel' on your Touchpad)
# If you are installing on a Veer, you will need to reboot the phone while connected to the computer, at this point, or it will not be recognized
# Use palm-install to install the package you downloaded
## Typically you can simply get a command line, navigate to the directory with the Preware package you downloaded, then type palm-install and.the.package.arm.name.ipk

 

=== Installing Preware with WebOS Quick Install ===
You can use version 4.6.0 or later of WebOS Quick Install to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and webOSDoctor.

'''Latest Version of WebOS Quick Install available here: [http://forums.webosnation.com/canuck-coding/274461-webos-quick-install-v4-6-0-a.html WebOS Quick Install v4.6.0]

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## Download the current version of WebOS Quick Install (link see above)
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" or "Cancel" (on a Touchpad). Do not select USB Drive.
# Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
## '''Do not believe any guide that says you need to download the SDK or webOSDoctor for WOSQI to run.''' The most you'll download is the novacom driver, which is only 11MB on Windows, and will be done via WOSQI.
# If you are installing on a Veer, you will need to reboot the phone at this point or WOSQI will not recognize it. Hold the On/Off button down for about five seconds and release it. Select "Power" then select "Restart".
# Click the third button on the right (the globe icon)
# Select the Applications tab at the top
# Search for Preware
# Click Install.

 

=== Installing Preware with the standalone installer ===
'''Historical information:''' ''The standalone installers are not available in October 2017''

Preware installers can be downloaded here: <del><nowiki>http://get.preware.org/</nowiki></del> These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and device in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the Preware Standalone Installer from <del><nowiki>http://get.preware.org/</nowiki></del> (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# If you are installing on a Veer, you may need to reboot the phone at this point.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 

=== Installing Preware from the command line ===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. If you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<code><nowiki>
cd /tmp
curl -L https://raw.githubusercontent.com/bbito/webos-internals-gitorious-bootstrap/master/preware-bootstrap.sh > preware-bootstrap.sh
sh /tmp/preware-bootstrap.sh
</nowiki></code>

''Historical note:'' The original script can be found at the gitorious mirror: https://gitorious.org/webos-internals/bootstrap/blobs/raw/master/preware-bootstrap.sh?p=webos-internals:bootstrap.git;a=blob_plain;f=preware-bootstrap.sh;hb=HEAD

About the gitorious mirror, see: https://gitorious.org

 

=== Updating Preware ===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Alternatively, WebOS Quick Install provides a method for updates as well that is similar to Preware.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

=== Removing Preware ===
''Why would you ever want to remove Preware?''

To remove Preware on webOS 2.x or lower, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.
For Touchpads (3.x), tap and hold the icon and click the "x" that appear on the icon. Choose delete.

 

== Usage ==
=== Preferences ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
| valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default. 
In the upper right corner is a blue question mark. To get additional information on each preference tap on the blue question mark. All preferences are now highlighted in blue. Tap on a certain preference to enter the help screen. To leave the help screen back swipe. Tap again on the blue question mark to leave the help mode.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
| TIP:
|-
| To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

=== Feed management ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
| valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
| align="center" colspan="4" | '''Default Feeds'''
|-
| align="center" | [http://ipkg.preware.org/feeds/precentral/ PreCentral]
|-
| align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
| align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
| align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
| align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
| align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

=== Package updates ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
| valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

=== Installing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
| valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
# Find the package you want to install either by scrolling and tapping on it, or just start typing
# Tap the "Install" button that the bottom of the package's page to install.
|}
 

=== Removing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
| valign="top"|Removing a package is just as easy.
# On the main screen, tap "Installed Packages", then the category of the package you want to remove
# Tap the Package you want to remove
# Tap the "Remove" button that the bottom of the package's page.
|}
 

=== Blacklist (category filters) ===
{| Width="70%" VAlign="top"
[[File:preware_2011-09-03_165038.png]]''' '''[[File:preware_2011-09-03_165049.png]]
| valign="top" | The Preware "Blacklist" is a tool used to hide packages (applications, patches, etc) that you do not want to see, such as mass-produced book apps or real estate apps. This tool can also be used to hide unavailable packages, such as patches that are not compatible with your current webOS version. Got to Preferences in Preware and scroll to the Blacklist section. You can add whatever filters you like to customize your Preware experience. To hide all apps from a particular Maintainer, choose a "Maintainer" filter with the package maintainer in the search field. To hide unavailable packages, choose a "Category" filter, with "Unavailable" in the search field.
|}
 



== Operating notes ==
=== Limitations ===
No known limitations.

 
=== Known bugs ===
* When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

* The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

* The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
== Changelog ==
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

; 1.9.12
* Added support for WebOS Community Edition (WOCE) feeds by the WebOS Ports team from WebOS Internals.

; 1.9.10
* Updated German translation (courtesy of DiplPhy).

; 1.9.9
* Added Traditional Chinese translation (courtesy of tonyw).

; 1.9.8
* Updated German translation (courtesy of DocZet).

; 1.9.7
* Added support for secure package downloads.

; 1.9.6
* Added support for secure feed downloads.

; 1.9.5
* Fixed the window orientation for the blue question mark help items.

; 1.9.4
* Added disclaimer when installing apps marked incompatible with current device.

; 1.9.2
* Revamped feed downloading to give better error and status reporting.

; 1.9.1
* Fixed device identification of WiFi TouchPads.

; 1.9.0
* Added feed display and installation support for App Tuckerbox.

; 1.8.7
* Hide authentication information in the Manage Feeds display.

; 1.8.6
* Added support for displaying the Changelog and DeviceCompatibility fields.

; 1.8.5
* Fixed missing package information bug

; 1.8.4
* Added some additional Second Line preference options

; 1.8.3
* Please read http://testing.preware.org/ if you use the testing feeds

; 1.8.2
* Fixed the removal of obsolete testing feeds

; 1.8.1
* Remove the obsolete testing feeds when adding alpha or beta feeds

; 1.8.0
* Disabled support for adding obsolete testing feeds

; 1.7.7
* Enabled support of alpha and beta testing feeds

; 1.7.6:
* Larger screenshots on the TouchPad
* Pressed states for TouchPad back buttons
* Fixed search backspace on TouchPad

; 1.7.5:
* Fixed list rendering on TouchPad (courtesy of chpwn).

; 1.7.4:
* Removed catalog feed specific preferences (show only free/show only english).

; 1.7.3:
* Added support for font packages.

; 1.7.2:
* Replaced the word phone with the word device in all messages.

; 1.7.1:
* Fixed fullscreen screenshot resizing on TouchPad rotate (courtesy of Appsotutely).
* Fixed dependent packages spinner location (courtesy of chpwn).

; 1.7.0:
* Rolled up all the beta release features for a TouchPad-compatible public release.

; 1.6.8:
* Enabled back tap on header for all devices.

; 1.6.7:
* Fixed full-screen formatting of ipkg log screen.

; 1.6.6:
* Preware is now fully compatible with the TouchPad, using the full screen area.

; 1.6.5:
* Now usable on devices without a back gesture.
* Set the wget user-agent to Preware when retrieving indexes and packages.

; 1.6.4:
* Fixed a problem when loading the saved packages list.

; 1.6.3:
* WebOS Internals has been formally notified by Richard Kerris (HP Vice President of Worldwide Developer Relations) that open access to the webOS app catalog feed (including the beta and web feeds) is no longer available to third party developers or applications. Please direct any questions about this decision (which is final and permanent) to HP, not to WebOS Internals.
* Removed all HP webOS app catalog feeds from new installations of Preware.

; 1.6.2:
* Added the clock themes feed (disabled by default).

; 1.6.0:
* webOS 2.x Just Type integration.
* Fixed package list ordering bug.
* Layout fixes for Pixi/Veer.

; 1.5.9:
* Fixed parse errors resulting from packages with very large descriptions.
* Fixed problems with updates to app catalog apps.

; 1.5.8:
* Moved blacklisting to feed load to speed up listing.
* Suggests a reload after changing the blacklist.
* Fixed homebrew feed/catalog feed same appid bug.

; 1.5.7:
* Added check to make sure package has a title before trying to search it.

; 1.5.6:
* Removed support for Visibility feed value - use a category filter to exclude Unavailable packages if desired.

; 1.5.5:
* Added support for Visibility feed value.
* Fix display of screenshots from devices with a different resolution.
* Test fix for custom feed on network with no internet connection.
* Style updates for pre3 screen size.

; 1.5.4:
* Updated French translations (courtesy of Clément).

; 1.5.3:
* Reinstated banner notification of manual saved package list update.

; 1.5.2:
* Check if package dates are actually dates.
* Removed banner notification of saved package list being saved.

; 1.5.1:
* Added support for optware testing feeds.

; 1.5.0:
* You must upgrade to this version for full webOS 2.0 compatibility.

; 1.4.9:
* Better compatibility with unknown future webOS versions.

; 1.4.8:

* Now calls the correct software manager updates screen on webOS 2.0.

; 1.4.7:
* Fixed update, install and remove status messages on webOS 2.0.

; 1.4.6:
* New "App Catalog" theme preferences thanks to Garrett92C.
* Added support for "MaxWebOSVersion" in the feeds.

; 1.4.5:
* Added support for identifying when running on a Pre 2 device.

; 1.4.4:
* Updated the version check to support future webOS versions.

; 1.4.2:
* Added Category as a blacklist option.

; 1.4.1:
* Added a Changelog button to the Help scene.

; 1.4.0:
* Added help to preferences scene.
* Fixed swipe-to-delete bug in blacklist.
* Updated Italian translations (courtesy of Darkmagister).
* Added "Get Info" button to package install scene.
* Added "Send" button to ipkg log scene.
* Fixed bug when loading large package descriptions.

; 1.3.8:
* Updated French translations (courtesy of Yannick LE NY).

; 1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

; 1.3.5:
* Updated German translations.

; 1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

; 1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

; 1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

; 1.2.9:
* Fixed the Saved Package List swipe to delete bug.

; 1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

; 1.2.7
* Fixed the Install Package problem when running on the emulator.

; 1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

; 1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

; 1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

; 1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

; 1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

; 1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

; 1.1.7
* Added support for Kernel Modules.

; 1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

; 1.1.4
* Fixed hang on package download failures.

; 1.1.2
* Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
* Removed the tag line about eventually reaching 1.0.
* Minor French translation updates, courtesy of Yannick LE NY.

; 1.1.1
* Added languages field in package descriptions.
* Added preference to only show packages with English descriptions.

; 1.1.0
* Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
* Updated German and French translations.
* Fixed deletion of disabled feeds.
* Added service version number to the ipkgservice API. Robustified the service upgrade process.

; 1.0.0
* The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
* Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 

== Repository ==
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For more information getting your application published in the WebOS Internals Source Code Repositories, please see the [[WebOS Internals Source Code Repositories]] page. For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]

Application:Preware

2017-10-05T20:21:14Z

Bbito: /* Installing Preware with the standalone installer */ De-link and strikethrough dead get.preware.org links

[[Category:Application]]
This page is currently available in four languages:
: [[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
: [[Image:France.png]] [[Application:Preware-FR]]
: [[Image:Germany.png]] [[Application:Preware-DE]]
: [[Image:China.png]] [[Application:Preware-ZH]]

{{application
| name=Preware
| type=webOS
| version=Version: 1.9.7 (15 December 2011)
| tag=Utilities
| screenshot=Preware_ss1.png
| description=
}}

 
== Summary ==

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre, Palm Pixi, and the HP TouchPad. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
=== Key features ===
Install / Remove / Update:
* Homebrew Applications including advanced applications with special requirements.
* WebOS Themes
* Patches
* webOS Kernels
* Support for installation of signed packages

 
=== Status ===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009, it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009, it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009, it also supports installation of themes.
* Since 8 October 2009, it also supports installation of webOS patches.
* Since 12 Jan 2010, it also supports all Palm App Catalog feeds.
* Since 3 May 2010, it also supports installation of webOS custom kernels.
* Since 20 July 2010, it also supports installation of packages from URLs and local files.
* Since 24 July 2010, is also supports blacklisting packages and authors.
* Since 8 June 2011, access to webOS app catalog feeds is no longer available to third party developers or applications.
* Since 15 December 2011, access to webOS app catalog feeds has been restored via App Tuckerbox.
* Since 15 December 2011, it also supports downloading feeds and packages from authenticated secure sites.

 
=== License ===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware 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 [mailto:support@webos-internals.org authors].

 

== Installing Preware ==

There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.

'''For a step-by-step tutorial, the official [http://bit.ly/phd-ac Preware Homebrew Documentation] is highly recommended'''

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
=== Installing Preware using the official HP/Palm SDK ===

To install Preware on any webOS device, the following procedure is recommended if you're having problems with WebOS Quick Install:

# Install the latest official Palm webOS SDK from http://developer.palm.com
# '''Disconnect your device''' (I repeat, do not have your device connected, no cables in the device, device not even anywhere near the computer), and run the latest webOS Doctor to install or upgrade your Novacom drivers
# Close the doctor
# Your device should remain disconnected
# Download the latest Preware package onto your computer from http://get.preware.net
## To install Preware on a device, download the 'arm' .ipk file
## To install Preware on an emulator, download the 'i686' .ipk file
# Typing webos20090606, select the developer mode icon that will appear, and verify that your device is in developer mode
# Connect your device to your computers USB port, and select 'Just Charge' (or 'Cancel' on your Touchpad)
# If you are installing on a Veer, you will need to reboot the phone while connected to the computer, at this point, or it will not be recognized
# Use palm-install to install the package you downloaded
## Typically you can simply get a command line, navigate to the directory with the Preware package you downloaded, then type palm-install and.the.package.arm.name.ipk

 

=== Installing Preware with WebOS Quick Install ===
You can use version 4.6.0 or later of WebOS Quick Install to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and webOSDoctor.

'''Latest Version of WebOS Quick Install available here: [http://forums.webosnation.com/canuck-coding/274461-webos-quick-install-v4-6-0-a.html WebOS Quick Install v4.6.0]

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## Download the current version of WebOS Quick Install (link see above)
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" or "Cancel" (on a Touchpad). Do not select USB Drive.
# Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
## '''Do not believe any guide that says you need to download the SDK or webOSDoctor for WOSQI to run.''' The most you'll download is the novacom driver, which is only 11MB on Windows, and will be done via WOSQI.
# If you are installing on a Veer, you will need to reboot the phone at this point or WOSQI will not recognize it. Hold the On/Off button down for about five seconds and release it. Select "Power" then select "Restart".
# Click the third button on the right (the globe icon)
# Select the Applications tab at the top
# Search for Preware
# Click Install.

 

=== Installing Preware with the standalone installer ===
'''Historical information:''' ''The standalone installers are not available in October 2017''

Preware installers can be downloaded here: <del><nowiki>http://get.preware.org/</nowiki></del> These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and device in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the Preware Standalone Installer from <del><nowiki>http://get.preware.org/</nowiki></del> (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# If you are installing on a Veer, you may need to reboot the phone at this point.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 

=== Installing Preware from the command line ===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. If you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<code><nowiki>
cd /tmp
curl -L https://raw.githubusercontent.com/bbito/webos-internals-gitorious-bootstrap/master/preware-bootstrap.sh > preware-bootstrap.sh
sh /tmp/preware-bootstrap.sh
</nowiki></code>

''Historical note:'' The original script can be found at the gitorious mirror: https://gitorious.org/webos-internals/bootstrap/blobs/raw/master/preware-bootstrap.sh?p=webos-internals:bootstrap.git;a=blob_plain;f=preware-bootstrap.sh;hb=HEAD

About the gitorious mirror, see: https://gitorious.org

 

=== Updating Preware ===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Alternatively, WebOS Quick Install provides a method for updates as well that is similar to Preware.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

=== Removing Preware ===
''Why would you ever want to remove Preware?''

To remove Preware on webOS 2.x or lower, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.
For Touchpads (3.x), tap and hold the icon and click the "x" that appear on the icon. Choose delete.

 

== Usage ==
=== Preferences ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
| valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default. 
In the upper right corner is a blue question mark. To get additional information on each preference tap on the blue question mark. All preferences are now highlighted in blue. Tap on a certain preference to enter the help screen. To leave the help screen back swipe. Tap again on the blue question mark to leave the help mode.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
| TIP:
|-
| To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

=== Feed management ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
| valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
| align="center" colspan="4" | '''Default Feeds'''
|-
| align="center" | [http://ipkg.preware.org/feeds/precentral/ PreCentral]
|-
| align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
| align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
| align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
| align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
| align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

=== Package updates ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
| valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

=== Installing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
| valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
# Find the package you want to install either by scrolling and tapping on it, or just start typing
# Tap the "Install" button that the bottom of the package's page to install.
|}
 

=== Removing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
| valign="top"|Removing a package is just as easy.
# On the main screen, tap "Installed Packages", then the category of the package you want to remove
# Tap the Package you want to remove
# Tap the "Remove" button that the bottom of the package's page.
|}
 

=== Blacklist (category filters) ===
{| Width="70%" VAlign="top"
[[File:preware_2011-09-03_165038.png]]''' '''[[File:preware_2011-09-03_165049.png]]
| valign="top" | The Preware "Blacklist" is a tool used to hide packages (applications, patches, etc) that you do not want to see, such as mass-produced book apps or real estate apps. This tool can also be used to hide unavailable packages, such as patches that are not compatible with your current webOS version. Got to Preferences in Preware and scroll to the Blacklist section. You can add whatever filters you like to customize your Preware experience. To hide all apps from a particular Maintainer, choose a "Maintainer" filter with the package maintainer in the search field. To hide unavailable packages, choose a "Category" filter, with "Unavailable" in the search field.
|}
 



== Operating notes ==
=== Limitations ===
No known limitations.

 
=== Known bugs ===
* When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

* The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

* The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
== Changelog ==
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

; 1.9.12
* Added support for WebOS Community Edition (WOCE) feeds by the WebOS Ports team from WebOS Internals.

; 1.9.10
* Updated German translation (courtesy of DiplPhy).

; 1.9.9
* Added Traditional Chinese translation (courtesy of tonyw).

; 1.9.8
* Updated German translation (courtesy of DocZet).

; 1.9.7
* Added support for secure package downloads.

; 1.9.6
* Added support for secure feed downloads.

; 1.9.5
* Fixed the window orientation for the blue question mark help items.

; 1.9.4
* Added disclaimer when installing apps marked incompatible with current device.

; 1.9.2
* Revamped feed downloading to give better error and status reporting.

; 1.9.1
* Fixed device identification of WiFi TouchPads.

; 1.9.0
* Added feed display and installation support for App Tuckerbox.

; 1.8.7
* Hide authentication information in the Manage Feeds display.

; 1.8.6
* Added support for displaying the Changelog and DeviceCompatibility fields.

; 1.8.5
* Fixed missing package information bug

; 1.8.4
* Added some additional Second Line preference options

; 1.8.3
* Please read http://testing.preware.org/ if you use the testing feeds

; 1.8.2
* Fixed the removal of obsolete testing feeds

; 1.8.1
* Remove the obsolete testing feeds when adding alpha or beta feeds

; 1.8.0
* Disabled support for adding obsolete testing feeds

; 1.7.7
* Enabled support of alpha and beta testing feeds

; 1.7.6:
* Larger screenshots on the TouchPad
* Pressed states for TouchPad back buttons
* Fixed search backspace on TouchPad

; 1.7.5:
* Fixed list rendering on TouchPad (courtesy of chpwn).

; 1.7.4:
* Removed catalog feed specific preferences (show only free/show only english).

; 1.7.3:
* Added support for font packages.

; 1.7.2:
* Replaced the word phone with the word device in all messages.

; 1.7.1:
* Fixed fullscreen screenshot resizing on TouchPad rotate (courtesy of Appsotutely).
* Fixed dependent packages spinner location (courtesy of chpwn).

; 1.7.0:
* Rolled up all the beta release features for a TouchPad-compatible public release.

; 1.6.8:
* Enabled back tap on header for all devices.

; 1.6.7:
* Fixed full-screen formatting of ipkg log screen.

; 1.6.6:
* Preware is now fully compatible with the TouchPad, using the full screen area.

; 1.6.5:
* Now usable on devices without a back gesture.
* Set the wget user-agent to Preware when retrieving indexes and packages.

; 1.6.4:
* Fixed a problem when loading the saved packages list.

; 1.6.3:
* WebOS Internals has been formally notified by Richard Kerris (HP Vice President of Worldwide Developer Relations) that open access to the webOS app catalog feed (including the beta and web feeds) is no longer available to third party developers or applications. Please direct any questions about this decision (which is final and permanent) to HP, not to WebOS Internals.
* Removed all HP webOS app catalog feeds from new installations of Preware.

; 1.6.2:
* Added the clock themes feed (disabled by default).

; 1.6.0:
* webOS 2.x Just Type integration.
* Fixed package list ordering bug.
* Layout fixes for Pixi/Veer.

; 1.5.9:
* Fixed parse errors resulting from packages with very large descriptions.
* Fixed problems with updates to app catalog apps.

; 1.5.8:
* Moved blacklisting to feed load to speed up listing.
* Suggests a reload after changing the blacklist.
* Fixed homebrew feed/catalog feed same appid bug.

; 1.5.7:
* Added check to make sure package has a title before trying to search it.

; 1.5.6:
* Removed support for Visibility feed value - use a category filter to exclude Unavailable packages if desired.

; 1.5.5:
* Added support for Visibility feed value.
* Fix display of screenshots from devices with a different resolution.
* Test fix for custom feed on network with no internet connection.
* Style updates for pre3 screen size.

; 1.5.4:
* Updated French translations (courtesy of Clément).

; 1.5.3:
* Reinstated banner notification of manual saved package list update.

; 1.5.2:
* Check if package dates are actually dates.
* Removed banner notification of saved package list being saved.

; 1.5.1:
* Added support for optware testing feeds.

; 1.5.0:
* You must upgrade to this version for full webOS 2.0 compatibility.

; 1.4.9:
* Better compatibility with unknown future webOS versions.

; 1.4.8:

* Now calls the correct software manager updates screen on webOS 2.0.

; 1.4.7:
* Fixed update, install and remove status messages on webOS 2.0.

; 1.4.6:
* New "App Catalog" theme preferences thanks to Garrett92C.
* Added support for "MaxWebOSVersion" in the feeds.

; 1.4.5:
* Added support for identifying when running on a Pre 2 device.

; 1.4.4:
* Updated the version check to support future webOS versions.

; 1.4.2:
* Added Category as a blacklist option.

; 1.4.1:
* Added a Changelog button to the Help scene.

; 1.4.0:
* Added help to preferences scene.
* Fixed swipe-to-delete bug in blacklist.
* Updated Italian translations (courtesy of Darkmagister).
* Added "Get Info" button to package install scene.
* Added "Send" button to ipkg log scene.
* Fixed bug when loading large package descriptions.

; 1.3.8:
* Updated French translations (courtesy of Yannick LE NY).

; 1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

; 1.3.5:
* Updated German translations.

; 1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

; 1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

; 1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

; 1.2.9:
* Fixed the Saved Package List swipe to delete bug.

; 1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

; 1.2.7
* Fixed the Install Package problem when running on the emulator.

; 1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

; 1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

; 1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

; 1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

; 1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

; 1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

; 1.1.7
* Added support for Kernel Modules.

; 1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

; 1.1.4
* Fixed hang on package download failures.

; 1.1.2
* Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
* Removed the tag line about eventually reaching 1.0.
* Minor French translation updates, courtesy of Yannick LE NY.

; 1.1.1
* Added languages field in package descriptions.
* Added preference to only show packages with English descriptions.

; 1.1.0
* Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
* Updated German and French translations.
* Fixed deletion of disabled feeds.
* Added service version number to the ipkgservice API. Robustified the service upgrade process.

; 1.0.0
* The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
* Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 

== Repository ==
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For more information getting your application published in the WebOS Internals Source Code Repositories, please see the [[WebOS Internals Source Code Repositories]] page. For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]

Application:Preware

2017-10-05T19:40:03Z

Bbito: /* Installing Preware from the command line */ Add historical note with link to original script.

[[Category:Application]]
This page is currently available in four languages:
: [[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
: [[Image:France.png]] [[Application:Preware-FR]]
: [[Image:Germany.png]] [[Application:Preware-DE]]
: [[Image:China.png]] [[Application:Preware-ZH]]

{{application
| name=Preware
| type=webOS
| version=Version: 1.9.7 (15 December 2011)
| tag=Utilities
| screenshot=Preware_ss1.png
| description=
}}

 
== Summary ==

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre, Palm Pixi, and the HP TouchPad. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
=== Key features ===
Install / Remove / Update:
* Homebrew Applications including advanced applications with special requirements.
* WebOS Themes
* Patches
* webOS Kernels
* Support for installation of signed packages

 
=== Status ===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009, it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009, it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009, it also supports installation of themes.
* Since 8 October 2009, it also supports installation of webOS patches.
* Since 12 Jan 2010, it also supports all Palm App Catalog feeds.
* Since 3 May 2010, it also supports installation of webOS custom kernels.
* Since 20 July 2010, it also supports installation of packages from URLs and local files.
* Since 24 July 2010, is also supports blacklisting packages and authors.
* Since 8 June 2011, access to webOS app catalog feeds is no longer available to third party developers or applications.
* Since 15 December 2011, access to webOS app catalog feeds has been restored via App Tuckerbox.
* Since 15 December 2011, it also supports downloading feeds and packages from authenticated secure sites.

 
=== License ===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware 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 [mailto:support@webos-internals.org authors].

 

== Installing Preware ==

There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.

'''For a step-by-step tutorial, the official [http://bit.ly/phd-ac Preware Homebrew Documentation] is highly recommended'''

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
=== Installing Preware using the official HP/Palm SDK ===

To install Preware on any webOS device, the following procedure is recommended if you're having problems with WebOS Quick Install:

# Install the latest official Palm webOS SDK from http://developer.palm.com
# '''Disconnect your device''' (I repeat, do not have your device connected, no cables in the device, device not even anywhere near the computer), and run the latest webOS Doctor to install or upgrade your Novacom drivers
# Close the doctor
# Your device should remain disconnected
# Download the latest Preware package onto your computer from http://get.preware.net
## To install Preware on a device, download the 'arm' .ipk file
## To install Preware on an emulator, download the 'i686' .ipk file
# Typing webos20090606, select the developer mode icon that will appear, and verify that your device is in developer mode
# Connect your device to your computers USB port, and select 'Just Charge' (or 'Cancel' on your Touchpad)
# If you are installing on a Veer, you will need to reboot the phone while connected to the computer, at this point, or it will not be recognized
# Use palm-install to install the package you downloaded
## Typically you can simply get a command line, navigate to the directory with the Preware package you downloaded, then type palm-install and.the.package.arm.name.ipk

 

=== Installing Preware with WebOS Quick Install ===
You can use version 4.6.0 or later of WebOS Quick Install to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and webOSDoctor.

'''Latest Version of WebOS Quick Install available here: [http://forums.webosnation.com/canuck-coding/274461-webos-quick-install-v4-6-0-a.html WebOS Quick Install v4.6.0]

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## Download the current version of WebOS Quick Install (link see above)
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" or "Cancel" (on a Touchpad). Do not select USB Drive.
# Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
## '''Do not believe any guide that says you need to download the SDK or webOSDoctor for WOSQI to run.''' The most you'll download is the novacom driver, which is only 11MB on Windows, and will be done via WOSQI.
# If you are installing on a Veer, you will need to reboot the phone at this point or WOSQI will not recognize it. Hold the On/Off button down for about five seconds and release it. Select "Power" then select "Restart".
# Click the third button on the right (the globe icon)
# Select the Applications tab at the top
# Search for Preware
# Click Install.

 

=== Installing Preware with the standalone installer ===
Preware installers can be downloaded here: [http://get.preware.org Preware Standalone Installers]. These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and device in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the [http://get.preware.org/ Preware Standalone Installer] (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# If you are installing on a Veer, you may need to reboot the phone at this point.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 
=== Installing Preware from the command line ===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. If you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<code><nowiki>
cd /tmp
curl -L https://raw.githubusercontent.com/bbito/webos-internals-gitorious-bootstrap/master/preware-bootstrap.sh > preware-bootstrap.sh
sh /tmp/preware-bootstrap.sh
</nowiki></code>

''Historical note:'' The original script can be found at the gitorious mirror: https://gitorious.org/webos-internals/bootstrap/blobs/raw/master/preware-bootstrap.sh?p=webos-internals:bootstrap.git;a=blob_plain;f=preware-bootstrap.sh;hb=HEAD

About the gitorious mirror, see: https://gitorious.org

 

=== Updating Preware ===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Alternatively, WebOS Quick Install provides a method for updates as well that is similar to Preware.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

=== Removing Preware ===
''Why would you ever want to remove Preware?''

To remove Preware on webOS 2.x or lower, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.
For Touchpads (3.x), tap and hold the icon and click the "x" that appear on the icon. Choose delete.

 

== Usage ==
=== Preferences ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
| valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default. 
In the upper right corner is a blue question mark. To get additional information on each preference tap on the blue question mark. All preferences are now highlighted in blue. Tap on a certain preference to enter the help screen. To leave the help screen back swipe. Tap again on the blue question mark to leave the help mode.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
| TIP:
|-
| To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

=== Feed management ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
| valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
| align="center" colspan="4" | '''Default Feeds'''
|-
| align="center" | [http://ipkg.preware.org/feeds/precentral/ PreCentral]
|-
| align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
| align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
| align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
| align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
| align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

=== Package updates ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
| valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

=== Installing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
| valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
# Find the package you want to install either by scrolling and tapping on it, or just start typing
# Tap the "Install" button that the bottom of the package's page to install.
|}
 

=== Removing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
| valign="top"|Removing a package is just as easy.
# On the main screen, tap "Installed Packages", then the category of the package you want to remove
# Tap the Package you want to remove
# Tap the "Remove" button that the bottom of the package's page.
|}
 

=== Blacklist (category filters) ===
{| Width="70%" VAlign="top"
[[File:preware_2011-09-03_165038.png]]''' '''[[File:preware_2011-09-03_165049.png]]
| valign="top" | The Preware "Blacklist" is a tool used to hide packages (applications, patches, etc) that you do not want to see, such as mass-produced book apps or real estate apps. This tool can also be used to hide unavailable packages, such as patches that are not compatible with your current webOS version. Got to Preferences in Preware and scroll to the Blacklist section. You can add whatever filters you like to customize your Preware experience. To hide all apps from a particular Maintainer, choose a "Maintainer" filter with the package maintainer in the search field. To hide unavailable packages, choose a "Category" filter, with "Unavailable" in the search field.
|}
 



== Operating notes ==
=== Limitations ===
No known limitations.

 
=== Known bugs ===
* When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

* The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

* The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
== Changelog ==
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

; 1.9.12
* Added support for WebOS Community Edition (WOCE) feeds by the WebOS Ports team from WebOS Internals.

; 1.9.10
* Updated German translation (courtesy of DiplPhy).

; 1.9.9
* Added Traditional Chinese translation (courtesy of tonyw).

; 1.9.8
* Updated German translation (courtesy of DocZet).

; 1.9.7
* Added support for secure package downloads.

; 1.9.6
* Added support for secure feed downloads.

; 1.9.5
* Fixed the window orientation for the blue question mark help items.

; 1.9.4
* Added disclaimer when installing apps marked incompatible with current device.

; 1.9.2
* Revamped feed downloading to give better error and status reporting.

; 1.9.1
* Fixed device identification of WiFi TouchPads.

; 1.9.0
* Added feed display and installation support for App Tuckerbox.

; 1.8.7
* Hide authentication information in the Manage Feeds display.

; 1.8.6
* Added support for displaying the Changelog and DeviceCompatibility fields.

; 1.8.5
* Fixed missing package information bug

; 1.8.4
* Added some additional Second Line preference options

; 1.8.3
* Please read http://testing.preware.org/ if you use the testing feeds

; 1.8.2
* Fixed the removal of obsolete testing feeds

; 1.8.1
* Remove the obsolete testing feeds when adding alpha or beta feeds

; 1.8.0
* Disabled support for adding obsolete testing feeds

; 1.7.7
* Enabled support of alpha and beta testing feeds

; 1.7.6:
* Larger screenshots on the TouchPad
* Pressed states for TouchPad back buttons
* Fixed search backspace on TouchPad

; 1.7.5:
* Fixed list rendering on TouchPad (courtesy of chpwn).

; 1.7.4:
* Removed catalog feed specific preferences (show only free/show only english).

; 1.7.3:
* Added support for font packages.

; 1.7.2:
* Replaced the word phone with the word device in all messages.

; 1.7.1:
* Fixed fullscreen screenshot resizing on TouchPad rotate (courtesy of Appsotutely).
* Fixed dependent packages spinner location (courtesy of chpwn).

; 1.7.0:
* Rolled up all the beta release features for a TouchPad-compatible public release.

; 1.6.8:
* Enabled back tap on header for all devices.

; 1.6.7:
* Fixed full-screen formatting of ipkg log screen.

; 1.6.6:
* Preware is now fully compatible with the TouchPad, using the full screen area.

; 1.6.5:
* Now usable on devices without a back gesture.
* Set the wget user-agent to Preware when retrieving indexes and packages.

; 1.6.4:
* Fixed a problem when loading the saved packages list.

; 1.6.3:
* WebOS Internals has been formally notified by Richard Kerris (HP Vice President of Worldwide Developer Relations) that open access to the webOS app catalog feed (including the beta and web feeds) is no longer available to third party developers or applications. Please direct any questions about this decision (which is final and permanent) to HP, not to WebOS Internals.
* Removed all HP webOS app catalog feeds from new installations of Preware.

; 1.6.2:
* Added the clock themes feed (disabled by default).

; 1.6.0:
* webOS 2.x Just Type integration.
* Fixed package list ordering bug.
* Layout fixes for Pixi/Veer.

; 1.5.9:
* Fixed parse errors resulting from packages with very large descriptions.
* Fixed problems with updates to app catalog apps.

; 1.5.8:
* Moved blacklisting to feed load to speed up listing.
* Suggests a reload after changing the blacklist.
* Fixed homebrew feed/catalog feed same appid bug.

; 1.5.7:
* Added check to make sure package has a title before trying to search it.

; 1.5.6:
* Removed support for Visibility feed value - use a category filter to exclude Unavailable packages if desired.

; 1.5.5:
* Added support for Visibility feed value.
* Fix display of screenshots from devices with a different resolution.
* Test fix for custom feed on network with no internet connection.
* Style updates for pre3 screen size.

; 1.5.4:
* Updated French translations (courtesy of Clément).

; 1.5.3:
* Reinstated banner notification of manual saved package list update.

; 1.5.2:
* Check if package dates are actually dates.
* Removed banner notification of saved package list being saved.

; 1.5.1:
* Added support for optware testing feeds.

; 1.5.0:
* You must upgrade to this version for full webOS 2.0 compatibility.

; 1.4.9:
* Better compatibility with unknown future webOS versions.

; 1.4.8:

* Now calls the correct software manager updates screen on webOS 2.0.

; 1.4.7:
* Fixed update, install and remove status messages on webOS 2.0.

; 1.4.6:
* New "App Catalog" theme preferences thanks to Garrett92C.
* Added support for "MaxWebOSVersion" in the feeds.

; 1.4.5:
* Added support for identifying when running on a Pre 2 device.

; 1.4.4:
* Updated the version check to support future webOS versions.

; 1.4.2:
* Added Category as a blacklist option.

; 1.4.1:
* Added a Changelog button to the Help scene.

; 1.4.0:
* Added help to preferences scene.
* Fixed swipe-to-delete bug in blacklist.
* Updated Italian translations (courtesy of Darkmagister).
* Added "Get Info" button to package install scene.
* Added "Send" button to ipkg log scene.
* Fixed bug when loading large package descriptions.

; 1.3.8:
* Updated French translations (courtesy of Yannick LE NY).

; 1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

; 1.3.5:
* Updated German translations.

; 1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

; 1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

; 1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

; 1.2.9:
* Fixed the Saved Package List swipe to delete bug.

; 1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

; 1.2.7
* Fixed the Install Package problem when running on the emulator.

; 1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

; 1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

; 1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

; 1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

; 1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

; 1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

; 1.1.7
* Added support for Kernel Modules.

; 1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

; 1.1.4
* Fixed hang on package download failures.

; 1.1.2
* Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
* Removed the tag line about eventually reaching 1.0.
* Minor French translation updates, courtesy of Yannick LE NY.

; 1.1.1
* Added languages field in package descriptions.
* Added preference to only show packages with English descriptions.

; 1.1.0
* Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
* Updated German and French translations.
* Fixed deletion of disabled feeds.
* Added service version number to the ipkgservice API. Robustified the service upgrade process.

; 1.0.0
* The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
* Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 

== Repository ==
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For more information getting your application published in the WebOS Internals Source Code Repositories, please see the [[WebOS Internals Source Code Repositories]] page. For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]

Application:Preware

2017-10-05T19:32:49Z

Bbito: /* Installing Preware from the command line */ Pull updated script from github.com/bbito and remove shortened URL

[[Category:Application]]
This page is currently available in four languages:
: [[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
: [[Image:France.png]] [[Application:Preware-FR]]
: [[Image:Germany.png]] [[Application:Preware-DE]]
: [[Image:China.png]] [[Application:Preware-ZH]]

{{application
| name=Preware
| type=webOS
| version=Version: 1.9.7 (15 December 2011)
| tag=Utilities
| screenshot=Preware_ss1.png
| description=
}}

 
== Summary ==

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre, Palm Pixi, and the HP TouchPad. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
=== Key features ===
Install / Remove / Update:
* Homebrew Applications including advanced applications with special requirements.
* WebOS Themes
* Patches
* webOS Kernels
* Support for installation of signed packages

 
=== Status ===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009, it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009, it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009, it also supports installation of themes.
* Since 8 October 2009, it also supports installation of webOS patches.
* Since 12 Jan 2010, it also supports all Palm App Catalog feeds.
* Since 3 May 2010, it also supports installation of webOS custom kernels.
* Since 20 July 2010, it also supports installation of packages from URLs and local files.
* Since 24 July 2010, is also supports blacklisting packages and authors.
* Since 8 June 2011, access to webOS app catalog feeds is no longer available to third party developers or applications.
* Since 15 December 2011, access to webOS app catalog feeds has been restored via App Tuckerbox.
* Since 15 December 2011, it also supports downloading feeds and packages from authenticated secure sites.

 
=== License ===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware 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 [mailto:support@webos-internals.org authors].

 

== Installing Preware ==

There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.

'''For a step-by-step tutorial, the official [http://bit.ly/phd-ac Preware Homebrew Documentation] is highly recommended'''

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
=== Installing Preware using the official HP/Palm SDK ===

To install Preware on any webOS device, the following procedure is recommended if you're having problems with WebOS Quick Install:

# Install the latest official Palm webOS SDK from http://developer.palm.com
# '''Disconnect your device''' (I repeat, do not have your device connected, no cables in the device, device not even anywhere near the computer), and run the latest webOS Doctor to install or upgrade your Novacom drivers
# Close the doctor
# Your device should remain disconnected
# Download the latest Preware package onto your computer from http://get.preware.net
## To install Preware on a device, download the 'arm' .ipk file
## To install Preware on an emulator, download the 'i686' .ipk file
# Typing webos20090606, select the developer mode icon that will appear, and verify that your device is in developer mode
# Connect your device to your computers USB port, and select 'Just Charge' (or 'Cancel' on your Touchpad)
# If you are installing on a Veer, you will need to reboot the phone while connected to the computer, at this point, or it will not be recognized
# Use palm-install to install the package you downloaded
## Typically you can simply get a command line, navigate to the directory with the Preware package you downloaded, then type palm-install and.the.package.arm.name.ipk

 

=== Installing Preware with WebOS Quick Install ===
You can use version 4.6.0 or later of WebOS Quick Install to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and webOSDoctor.

'''Latest Version of WebOS Quick Install available here: [http://forums.webosnation.com/canuck-coding/274461-webos-quick-install-v4-6-0-a.html WebOS Quick Install v4.6.0]

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## Download the current version of WebOS Quick Install (link see above)
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" or "Cancel" (on a Touchpad). Do not select USB Drive.
# Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
## '''Do not believe any guide that says you need to download the SDK or webOSDoctor for WOSQI to run.''' The most you'll download is the novacom driver, which is only 11MB on Windows, and will be done via WOSQI.
# If you are installing on a Veer, you will need to reboot the phone at this point or WOSQI will not recognize it. Hold the On/Off button down for about five seconds and release it. Select "Power" then select "Restart".
# Click the third button on the right (the globe icon)
# Select the Applications tab at the top
# Search for Preware
# Click Install.

 

=== Installing Preware with the standalone installer ===
Preware installers can be downloaded here: [http://get.preware.org Preware Standalone Installers]. These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and device in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the [http://get.preware.org/ Preware Standalone Installer] (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# If you are installing on a Veer, you may need to reboot the phone at this point.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 
=== Installing Preware from the command line ===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. If you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<code><nowiki>
cd /tmp
curl -L https://raw.githubusercontent.com/bbito/webos-internals-gitorious-bootstrap/master/preware-bootstrap.sh > preware-bootstrap.sh
sh /tmp/preware-bootstrap.sh
</nowiki></code>

 

=== Updating Preware ===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Alternatively, WebOS Quick Install provides a method for updates as well that is similar to Preware.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

=== Removing Preware ===
''Why would you ever want to remove Preware?''

To remove Preware on webOS 2.x or lower, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.
For Touchpads (3.x), tap and hold the icon and click the "x" that appear on the icon. Choose delete.

 

== Usage ==
=== Preferences ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
| valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default. 
In the upper right corner is a blue question mark. To get additional information on each preference tap on the blue question mark. All preferences are now highlighted in blue. Tap on a certain preference to enter the help screen. To leave the help screen back swipe. Tap again on the blue question mark to leave the help mode.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
| TIP:
|-
| To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

=== Feed management ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
| valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
| align="center" colspan="4" | '''Default Feeds'''
|-
| align="center" | [http://ipkg.preware.org/feeds/precentral/ PreCentral]
|-
| align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
| align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
| align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
| align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
| align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

=== Package updates ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
| valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

=== Installing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
| valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
# Find the package you want to install either by scrolling and tapping on it, or just start typing
# Tap the "Install" button that the bottom of the package's page to install.
|}
 

=== Removing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
| valign="top"|Removing a package is just as easy.
# On the main screen, tap "Installed Packages", then the category of the package you want to remove
# Tap the Package you want to remove
# Tap the "Remove" button that the bottom of the package's page.
|}
 

=== Blacklist (category filters) ===
{| Width="70%" VAlign="top"
[[File:preware_2011-09-03_165038.png]]''' '''[[File:preware_2011-09-03_165049.png]]
| valign="top" | The Preware "Blacklist" is a tool used to hide packages (applications, patches, etc) that you do not want to see, such as mass-produced book apps or real estate apps. This tool can also be used to hide unavailable packages, such as patches that are not compatible with your current webOS version. Got to Preferences in Preware and scroll to the Blacklist section. You can add whatever filters you like to customize your Preware experience. To hide all apps from a particular Maintainer, choose a "Maintainer" filter with the package maintainer in the search field. To hide unavailable packages, choose a "Category" filter, with "Unavailable" in the search field.
|}
 



== Operating notes ==
=== Limitations ===
No known limitations.

 
=== Known bugs ===
* When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

* The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

* The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
== Changelog ==
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

; 1.9.12
* Added support for WebOS Community Edition (WOCE) feeds by the WebOS Ports team from WebOS Internals.

; 1.9.10
* Updated German translation (courtesy of DiplPhy).

; 1.9.9
* Added Traditional Chinese translation (courtesy of tonyw).

; 1.9.8
* Updated German translation (courtesy of DocZet).

; 1.9.7
* Added support for secure package downloads.

; 1.9.6
* Added support for secure feed downloads.

; 1.9.5
* Fixed the window orientation for the blue question mark help items.

; 1.9.4
* Added disclaimer when installing apps marked incompatible with current device.

; 1.9.2
* Revamped feed downloading to give better error and status reporting.

; 1.9.1
* Fixed device identification of WiFi TouchPads.

; 1.9.0
* Added feed display and installation support for App Tuckerbox.

; 1.8.7
* Hide authentication information in the Manage Feeds display.

; 1.8.6
* Added support for displaying the Changelog and DeviceCompatibility fields.

; 1.8.5
* Fixed missing package information bug

; 1.8.4
* Added some additional Second Line preference options

; 1.8.3
* Please read http://testing.preware.org/ if you use the testing feeds

; 1.8.2
* Fixed the removal of obsolete testing feeds

; 1.8.1
* Remove the obsolete testing feeds when adding alpha or beta feeds

; 1.8.0
* Disabled support for adding obsolete testing feeds

; 1.7.7
* Enabled support of alpha and beta testing feeds

; 1.7.6:
* Larger screenshots on the TouchPad
* Pressed states for TouchPad back buttons
* Fixed search backspace on TouchPad

; 1.7.5:
* Fixed list rendering on TouchPad (courtesy of chpwn).

; 1.7.4:
* Removed catalog feed specific preferences (show only free/show only english).

; 1.7.3:
* Added support for font packages.

; 1.7.2:
* Replaced the word phone with the word device in all messages.

; 1.7.1:
* Fixed fullscreen screenshot resizing on TouchPad rotate (courtesy of Appsotutely).
* Fixed dependent packages spinner location (courtesy of chpwn).

; 1.7.0:
* Rolled up all the beta release features for a TouchPad-compatible public release.

; 1.6.8:
* Enabled back tap on header for all devices.

; 1.6.7:
* Fixed full-screen formatting of ipkg log screen.

; 1.6.6:
* Preware is now fully compatible with the TouchPad, using the full screen area.

; 1.6.5:
* Now usable on devices without a back gesture.
* Set the wget user-agent to Preware when retrieving indexes and packages.

; 1.6.4:
* Fixed a problem when loading the saved packages list.

; 1.6.3:
* WebOS Internals has been formally notified by Richard Kerris (HP Vice President of Worldwide Developer Relations) that open access to the webOS app catalog feed (including the beta and web feeds) is no longer available to third party developers or applications. Please direct any questions about this decision (which is final and permanent) to HP, not to WebOS Internals.
* Removed all HP webOS app catalog feeds from new installations of Preware.

; 1.6.2:
* Added the clock themes feed (disabled by default).

; 1.6.0:
* webOS 2.x Just Type integration.
* Fixed package list ordering bug.
* Layout fixes for Pixi/Veer.

; 1.5.9:
* Fixed parse errors resulting from packages with very large descriptions.
* Fixed problems with updates to app catalog apps.

; 1.5.8:
* Moved blacklisting to feed load to speed up listing.
* Suggests a reload after changing the blacklist.
* Fixed homebrew feed/catalog feed same appid bug.

; 1.5.7:
* Added check to make sure package has a title before trying to search it.

; 1.5.6:
* Removed support for Visibility feed value - use a category filter to exclude Unavailable packages if desired.

; 1.5.5:
* Added support for Visibility feed value.
* Fix display of screenshots from devices with a different resolution.
* Test fix for custom feed on network with no internet connection.
* Style updates for pre3 screen size.

; 1.5.4:
* Updated French translations (courtesy of Clément).

; 1.5.3:
* Reinstated banner notification of manual saved package list update.

; 1.5.2:
* Check if package dates are actually dates.
* Removed banner notification of saved package list being saved.

; 1.5.1:
* Added support for optware testing feeds.

; 1.5.0:
* You must upgrade to this version for full webOS 2.0 compatibility.

; 1.4.9:
* Better compatibility with unknown future webOS versions.

; 1.4.8:

* Now calls the correct software manager updates screen on webOS 2.0.

; 1.4.7:
* Fixed update, install and remove status messages on webOS 2.0.

; 1.4.6:
* New "App Catalog" theme preferences thanks to Garrett92C.
* Added support for "MaxWebOSVersion" in the feeds.

; 1.4.5:
* Added support for identifying when running on a Pre 2 device.

; 1.4.4:
* Updated the version check to support future webOS versions.

; 1.4.2:
* Added Category as a blacklist option.

; 1.4.1:
* Added a Changelog button to the Help scene.

; 1.4.0:
* Added help to preferences scene.
* Fixed swipe-to-delete bug in blacklist.
* Updated Italian translations (courtesy of Darkmagister).
* Added "Get Info" button to package install scene.
* Added "Send" button to ipkg log scene.
* Fixed bug when loading large package descriptions.

; 1.3.8:
* Updated French translations (courtesy of Yannick LE NY).

; 1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

; 1.3.5:
* Updated German translations.

; 1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

; 1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

; 1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

; 1.2.9:
* Fixed the Saved Package List swipe to delete bug.

; 1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

; 1.2.7
* Fixed the Install Package problem when running on the emulator.

; 1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

; 1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

; 1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

; 1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

; 1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

; 1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

; 1.1.7
* Added support for Kernel Modules.

; 1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

; 1.1.4
* Fixed hang on package download failures.

; 1.1.2
* Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
* Removed the tag line about eventually reaching 1.0.
* Minor French translation updates, courtesy of Yannick LE NY.

; 1.1.1
* Added languages field in package descriptions.
* Added preference to only show packages with English descriptions.

; 1.1.0
* Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
* Updated German and French translations.
* Fixed deletion of disabled feeds.
* Added service version number to the ipkgservice API. Robustified the service upgrade process.

; 1.0.0
* The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
* Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 

== Repository ==
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For more information getting your application published in the WebOS Internals Source Code Repositories, please see the [[WebOS Internals Source Code Repositories]] page. For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]

Application:Preware

2017-10-05T19:26:41Z

Bbito: /* Installing Preware from the command line */ change source lang=bash tags to code tags plus nowiki tags

[[Category:Application]]
This page is currently available in four languages:
: [[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
: [[Image:France.png]] [[Application:Preware-FR]]
: [[Image:Germany.png]] [[Application:Preware-DE]]
: [[Image:China.png]] [[Application:Preware-ZH]]

{{application
| name=Preware
| type=webOS
| version=Version: 1.9.7 (15 December 2011)
| tag=Utilities
| screenshot=Preware_ss1.png
| description=
}}

 
== Summary ==

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre, Palm Pixi, and the HP TouchPad. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
=== Key features ===
Install / Remove / Update:
* Homebrew Applications including advanced applications with special requirements.
* WebOS Themes
* Patches
* webOS Kernels
* Support for installation of signed packages

 
=== Status ===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009, it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009, it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009, it also supports installation of themes.
* Since 8 October 2009, it also supports installation of webOS patches.
* Since 12 Jan 2010, it also supports all Palm App Catalog feeds.
* Since 3 May 2010, it also supports installation of webOS custom kernels.
* Since 20 July 2010, it also supports installation of packages from URLs and local files.
* Since 24 July 2010, is also supports blacklisting packages and authors.
* Since 8 June 2011, access to webOS app catalog feeds is no longer available to third party developers or applications.
* Since 15 December 2011, access to webOS app catalog feeds has been restored via App Tuckerbox.
* Since 15 December 2011, it also supports downloading feeds and packages from authenticated secure sites.

 
=== License ===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware 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 [mailto:support@webos-internals.org authors].

 

== Installing Preware ==

There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.

'''For a step-by-step tutorial, the official [http://bit.ly/phd-ac Preware Homebrew Documentation] is highly recommended'''

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
=== Installing Preware using the official HP/Palm SDK ===

To install Preware on any webOS device, the following procedure is recommended if you're having problems with WebOS Quick Install:

# Install the latest official Palm webOS SDK from http://developer.palm.com
# '''Disconnect your device''' (I repeat, do not have your device connected, no cables in the device, device not even anywhere near the computer), and run the latest webOS Doctor to install or upgrade your Novacom drivers
# Close the doctor
# Your device should remain disconnected
# Download the latest Preware package onto your computer from http://get.preware.net
## To install Preware on a device, download the 'arm' .ipk file
## To install Preware on an emulator, download the 'i686' .ipk file
# Typing webos20090606, select the developer mode icon that will appear, and verify that your device is in developer mode
# Connect your device to your computers USB port, and select 'Just Charge' (or 'Cancel' on your Touchpad)
# If you are installing on a Veer, you will need to reboot the phone while connected to the computer, at this point, or it will not be recognized
# Use palm-install to install the package you downloaded
## Typically you can simply get a command line, navigate to the directory with the Preware package you downloaded, then type palm-install and.the.package.arm.name.ipk

 

=== Installing Preware with WebOS Quick Install ===
You can use version 4.6.0 or later of WebOS Quick Install to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and webOSDoctor.

'''Latest Version of WebOS Quick Install available here: [http://forums.webosnation.com/canuck-coding/274461-webos-quick-install-v4-6-0-a.html WebOS Quick Install v4.6.0]

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## Download the current version of WebOS Quick Install (link see above)
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" or "Cancel" (on a Touchpad). Do not select USB Drive.
# Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
## '''Do not believe any guide that says you need to download the SDK or webOSDoctor for WOSQI to run.''' The most you'll download is the novacom driver, which is only 11MB on Windows, and will be done via WOSQI.
# If you are installing on a Veer, you will need to reboot the phone at this point or WOSQI will not recognize it. Hold the On/Off button down for about five seconds and release it. Select "Power" then select "Restart".
# Click the third button on the right (the globe icon)
# Select the Applications tab at the top
# Search for Preware
# Click Install.

 

=== Installing Preware with the standalone installer ===
Preware installers can be downloaded here: [http://get.preware.org Preware Standalone Installers]. These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and device in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the [http://get.preware.org/ Preware Standalone Installer] (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# If you are installing on a Veer, you may need to reboot the phone at this point.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 
=== Installing Preware from the command line ===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. If you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<code><nowiki>
cd /tmp
curl -L http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/preware-bootstrap.sh > preware-bootstrap.sh
sh /tmp/preware-bootstrap.sh
</nowiki></code>

Alternatively, you can use the url-shortened address (as of this date):

<code><nowiki>
cd /tmp
curl -L http://bit.ly/preware-bootstrap > preware-bootstrap.sh
sh /tmp/preware-bootstrap.sh
</nowiki></code>

 

=== Updating Preware ===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Alternatively, WebOS Quick Install provides a method for updates as well that is similar to Preware.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

=== Removing Preware ===
''Why would you ever want to remove Preware?''

To remove Preware on webOS 2.x or lower, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.
For Touchpads (3.x), tap and hold the icon and click the "x" that appear on the icon. Choose delete.

 

== Usage ==
=== Preferences ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
| valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default. 
In the upper right corner is a blue question mark. To get additional information on each preference tap on the blue question mark. All preferences are now highlighted in blue. Tap on a certain preference to enter the help screen. To leave the help screen back swipe. Tap again on the blue question mark to leave the help mode.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
| TIP:
|-
| To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

=== Feed management ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
| valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
| align="center" colspan="4" | '''Default Feeds'''
|-
| align="center" | [http://ipkg.preware.org/feeds/precentral/ PreCentral]
|-
| align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
| align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
| align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
| align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
| align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

=== Package updates ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
| valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

=== Installing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
| valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
# Find the package you want to install either by scrolling and tapping on it, or just start typing
# Tap the "Install" button that the bottom of the package's page to install.
|}
 

=== Removing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
| valign="top"|Removing a package is just as easy.
# On the main screen, tap "Installed Packages", then the category of the package you want to remove
# Tap the Package you want to remove
# Tap the "Remove" button that the bottom of the package's page.
|}
 

=== Blacklist (category filters) ===
{| Width="70%" VAlign="top"
[[File:preware_2011-09-03_165038.png]]''' '''[[File:preware_2011-09-03_165049.png]]
| valign="top" | The Preware "Blacklist" is a tool used to hide packages (applications, patches, etc) that you do not want to see, such as mass-produced book apps or real estate apps. This tool can also be used to hide unavailable packages, such as patches that are not compatible with your current webOS version. Got to Preferences in Preware and scroll to the Blacklist section. You can add whatever filters you like to customize your Preware experience. To hide all apps from a particular Maintainer, choose a "Maintainer" filter with the package maintainer in the search field. To hide unavailable packages, choose a "Category" filter, with "Unavailable" in the search field.
|}
 



== Operating notes ==
=== Limitations ===
No known limitations.

 
=== Known bugs ===
* When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

* The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

* The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
== Changelog ==
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

; 1.9.12
* Added support for WebOS Community Edition (WOCE) feeds by the WebOS Ports team from WebOS Internals.

; 1.9.10
* Updated German translation (courtesy of DiplPhy).

; 1.9.9
* Added Traditional Chinese translation (courtesy of tonyw).

; 1.9.8
* Updated German translation (courtesy of DocZet).

; 1.9.7
* Added support for secure package downloads.

; 1.9.6
* Added support for secure feed downloads.

; 1.9.5
* Fixed the window orientation for the blue question mark help items.

; 1.9.4
* Added disclaimer when installing apps marked incompatible with current device.

; 1.9.2
* Revamped feed downloading to give better error and status reporting.

; 1.9.1
* Fixed device identification of WiFi TouchPads.

; 1.9.0
* Added feed display and installation support for App Tuckerbox.

; 1.8.7
* Hide authentication information in the Manage Feeds display.

; 1.8.6
* Added support for displaying the Changelog and DeviceCompatibility fields.

; 1.8.5
* Fixed missing package information bug

; 1.8.4
* Added some additional Second Line preference options

; 1.8.3
* Please read http://testing.preware.org/ if you use the testing feeds

; 1.8.2
* Fixed the removal of obsolete testing feeds

; 1.8.1
* Remove the obsolete testing feeds when adding alpha or beta feeds

; 1.8.0
* Disabled support for adding obsolete testing feeds

; 1.7.7
* Enabled support of alpha and beta testing feeds

; 1.7.6:
* Larger screenshots on the TouchPad
* Pressed states for TouchPad back buttons
* Fixed search backspace on TouchPad

; 1.7.5:
* Fixed list rendering on TouchPad (courtesy of chpwn).

; 1.7.4:
* Removed catalog feed specific preferences (show only free/show only english).

; 1.7.3:
* Added support for font packages.

; 1.7.2:
* Replaced the word phone with the word device in all messages.

; 1.7.1:
* Fixed fullscreen screenshot resizing on TouchPad rotate (courtesy of Appsotutely).
* Fixed dependent packages spinner location (courtesy of chpwn).

; 1.7.0:
* Rolled up all the beta release features for a TouchPad-compatible public release.

; 1.6.8:
* Enabled back tap on header for all devices.

; 1.6.7:
* Fixed full-screen formatting of ipkg log screen.

; 1.6.6:
* Preware is now fully compatible with the TouchPad, using the full screen area.

; 1.6.5:
* Now usable on devices without a back gesture.
* Set the wget user-agent to Preware when retrieving indexes and packages.

; 1.6.4:
* Fixed a problem when loading the saved packages list.

; 1.6.3:
* WebOS Internals has been formally notified by Richard Kerris (HP Vice President of Worldwide Developer Relations) that open access to the webOS app catalog feed (including the beta and web feeds) is no longer available to third party developers or applications. Please direct any questions about this decision (which is final and permanent) to HP, not to WebOS Internals.
* Removed all HP webOS app catalog feeds from new installations of Preware.

; 1.6.2:
* Added the clock themes feed (disabled by default).

; 1.6.0:
* webOS 2.x Just Type integration.
* Fixed package list ordering bug.
* Layout fixes for Pixi/Veer.

; 1.5.9:
* Fixed parse errors resulting from packages with very large descriptions.
* Fixed problems with updates to app catalog apps.

; 1.5.8:
* Moved blacklisting to feed load to speed up listing.
* Suggests a reload after changing the blacklist.
* Fixed homebrew feed/catalog feed same appid bug.

; 1.5.7:
* Added check to make sure package has a title before trying to search it.

; 1.5.6:
* Removed support for Visibility feed value - use a category filter to exclude Unavailable packages if desired.

; 1.5.5:
* Added support for Visibility feed value.
* Fix display of screenshots from devices with a different resolution.
* Test fix for custom feed on network with no internet connection.
* Style updates for pre3 screen size.

; 1.5.4:
* Updated French translations (courtesy of Clément).

; 1.5.3:
* Reinstated banner notification of manual saved package list update.

; 1.5.2:
* Check if package dates are actually dates.
* Removed banner notification of saved package list being saved.

; 1.5.1:
* Added support for optware testing feeds.

; 1.5.0:
* You must upgrade to this version for full webOS 2.0 compatibility.

; 1.4.9:
* Better compatibility with unknown future webOS versions.

; 1.4.8:

* Now calls the correct software manager updates screen on webOS 2.0.

; 1.4.7:
* Fixed update, install and remove status messages on webOS 2.0.

; 1.4.6:
* New "App Catalog" theme preferences thanks to Garrett92C.
* Added support for "MaxWebOSVersion" in the feeds.

; 1.4.5:
* Added support for identifying when running on a Pre 2 device.

; 1.4.4:
* Updated the version check to support future webOS versions.

; 1.4.2:
* Added Category as a blacklist option.

; 1.4.1:
* Added a Changelog button to the Help scene.

; 1.4.0:
* Added help to preferences scene.
* Fixed swipe-to-delete bug in blacklist.
* Updated Italian translations (courtesy of Darkmagister).
* Added "Get Info" button to package install scene.
* Added "Send" button to ipkg log scene.
* Fixed bug when loading large package descriptions.

; 1.3.8:
* Updated French translations (courtesy of Yannick LE NY).

; 1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

; 1.3.5:
* Updated German translations.

; 1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

; 1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

; 1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

; 1.2.9:
* Fixed the Saved Package List swipe to delete bug.

; 1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

; 1.2.7
* Fixed the Install Package problem when running on the emulator.

; 1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

; 1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

; 1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

; 1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

; 1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

; 1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

; 1.1.7
* Added support for Kernel Modules.

; 1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

; 1.1.4
* Fixed hang on package download failures.

; 1.1.2
* Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
* Removed the tag line about eventually reaching 1.0.
* Minor French translation updates, courtesy of Yannick LE NY.

; 1.1.1
* Added languages field in package descriptions.
* Added preference to only show packages with English descriptions.

; 1.1.0
* Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
* Updated German and French translations.
* Fixed deletion of disabled feeds.
* Added service version number to the ipkgservice API. Robustified the service upgrade process.

; 1.0.0
* The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
* Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 

== Repository ==
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For more information getting your application published in the WebOS Internals Source Code Repositories, please see the [[WebOS Internals Source Code Repositories]] page. For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]

WebOS Doctor Versions

2017-09-13T22:16:31Z

Bbito: Removed Palm serial number tool link/info, added HOSTS file modification info, de-linked and struck-through entries that are no longer available.

== How to get webOS Doctor ==

As of late 2014 the Palm hosted webOS Doctor .jar files are no longer directly accessible from their original URLs unless the accessing computer's [https://en.wikipedia.org/wiki/Hosts_(file) HOSTS file] has been edited to include the following entry:
195.22.200.42 downloads.help.palm.com # webOS Doctor downloads

'''''NOTE: The HOSTS file must be edited with elevated permissions, e.g. SU on Linux/Unix or Administrator mode on Windows'''''

The remaining original palm.com domain links are working as of 13 September 2017 with the above HOSTS file alteration, however many of the older versions are no longer hosted by Palm's servers and these have been struck-through but remain for reference.

== Serial Numbers ==

The first five characters of product serial numbers are listed for many of the models in this Doctor list.

== Download links ==

'''''NOTE: Since March 18th 2010, the Palm servers are no longer hosting old WebOSDoctor versions via the struck-through links below. The current versions are still available.'''''
=== Tablet ===
==== Wifi Only ====
* HSTNH-I29C: 5CL1XXXXXX: FB456UTXXXX (HP TouchPad 10" 64GB Wifi Only)
* HSTNH-I29C: 5CL1XXXXXX: FB359UAXXXX (HP TouchPad 10" 32GB Wifi Only)
* HSTNH-I29C: 5CL1XXXXXX: FB355UAXXXX (HP TouchPad 10" 16GB Wifi Only)
* version 3.0.0 http://downloads.help.palm.com/webosdoctor/rom/touchpad/wd300wifi/webosdoctorp300hstnhwifi.jar
* version 3.0.2 http://downloads.help.palm.com/webosdoctor/rom/touchpad/p302r0d08012011/wifip302rod/webosdoctorp302hstnhwifi.jar
* version 3.0.4 http://downloads.help.palm.com/webosdoctor/rom/touchpad/p304rod10182011/wd304wifi/webosdoctorp304hstnhwifi.jar
* version 3.0.5 http://downloads.help.palm.com/webosdoctor/rom/touchpad/p305rod01122012/wd305wifi/webosdoctorp305hstnhwifi.jar

==== AT&T 3G ====
* HSTNH-I30C
* version 3.0.2-66 http://downloads.help.palm.com/webosdoctor/rom/touchpad/p302rod09232011/wd302att/webosdoctorp302hstnhatt.jar
* version 3.0.2-74 http://downloads.help.palm.com/webosdoctor/rom/touchpad/p302rod10102011/wd302att/webosdoctorp302hstnhatt.jar
* version 3.0.4 http://downloads.help.palm.com/webosdoctor/rom/touchpad/p304rod10182011/wd304att/webosdoctorp304hstnhatt.jar
* version 3.0.4-78 http://downloads.help.palm.com/webosdoctor/rom/touchpad/p304rod11152011/wd304att/webosdoctorp304hstnhatt.jar
* version 3.0.5 http://downloads.help.palm.com/webosdoctor/rom/touchpad/p305rod01122012/wd305att/webosdoctorp305hstnhatt.jar

=== Phone ===
==== Sprint ====
===== Pre =====
* P100EWW: P5PE0XXXXXXX (Pre on the Sprint network)
* version 1.2.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/p121r0d10092009/sr1ntp121rod/webosdoctorp100ewwsprint.jar</nowiki></del>
* version 1.3.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p131r0d11172009/sr1ntp131rod/webosdoctorp100ewwsprint.jar</nowiki></del>
* version 1.3.5 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p135r0d12302009/sr1ntp135rod/webosdoctorp100ewwsprint.jar</nowiki></del>
* version 1.3.5.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p1351r0d01082010/sr1ntp1351rod/webosdoctorp100ewwsprint.jar</nowiki></del>
* version 1.4.0 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p14r0d02252010/sr1ntp140rod/webosdoctorp100ewwsprint.jar</nowiki></del>
* version 1.4.1.1 http://downloads.help.palm.com/webosdoctor/rom/pre/p1411r0d03312010/sr1ntp1411rod/webosdoctorp100ewwsprint.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/pre/p145r0d08102010/spr1ntp145rod/webosdoctorp100ewwsprint.jar

===== Pixi =====
*P120EWW: P6P20XXXXXXX (Pixi on the Sprint network)
* version 1.3.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pixi/px131r0d11172009/sr1ntp131rod/webosdoctorp200ewwsprint.jar</nowiki></del>
* version 1.3.2 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pixi/px132r0d12032009/sr1ntp132rod/webosdoctorp200ewwsprint.jar</nowiki></del>
* version 1.3.5 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pixi/px135r0d12302009/sr1ntp135rod/webosdoctorp200ewwsprint.jar</nowiki></del>
* version 1.3.5.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pixi/px1351r0d01082010/sr1ntp1351rod/webosdoctorp120ewwsprint.jar</nowiki></del>
* version 1.4.0 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pixi/px14r0d02252010/sr1ntp140rod/webosdoctorp200ewwsprint.jar</nowiki></del>
* version 1.4.1.1 http://downloads.help.palm.com/webosdoctor/rom/pixi/px1411r0d03312010/sr1ntp1411rod/webosdoctorp200ewwsprint.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/pixi/px145r0d08102010/spr1ntp145rod/webosdoctorp200ewwsprint.jar
''(Palm changed p200eww to p120eww in version 1.3.5.1)''
''(Palm changed p120eww back to p200eww in version 1.4.0)''

==== Bell Mobility ====
===== Pre =====
* P100EWW: P5BE0XXXXXXX (Pre on the Bell network)
* version 1.2.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/p121r0d10092009/b11ep121rod/webosdoctorp100ewwbellmo.jar</nowiki></del>
* version 1.3.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p131r0d11172009/b11ep131rod/webosdoctorp100ewwbellmo.jar</nowiki></del>
* version 1.3.5.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p1351r0d01082010/b11ep1351rod/webosdoctorp100ewwbellmo.jar</nowiki></del>
* version 1.4.0 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p14r0d02252010/b11ep140rod/webosdoctorp100ewwbellmo.jar</nowiki></del>
* version 1.4.1 http://downloads.help.palm.com/webosdoctor/rom/pre/p141r0d03312010/b11ep141rod/webosdoctorp100ewwbellmo.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/pre/p145r0d07142010/b11ep145rod/webosdoctorp100ewwbellmo.jar

==== O2 Germany, UK and Ireland / Movistar Spain ====
===== Pre =====
* P100UEU: P5FU0XXXXXXX (Pre on the Movistar network)
* P100UEU: P5HUGXXXXXXX (Pre on the o2 network)
* version 1.1.3 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/p113r0d10122009/wr640xdfgy12z/webosdoctorp100eww-wr.jar</nowiki></del>
* version 1.3.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p131r0d11172009/wrep131rod/webosdoctorp100ueu-wr.jar</nowiki></del>
* version 1.3.5.2 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p1352r0d01182010/wrep1352rod/webosdoctorp100ueu-wr.jar</nowiki></del>
* version 1.4.0 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p14r0d02252010/wrep140rod/webosdoctorp100ueu-wr.jar</nowiki></del>
* version 1.4.1 http://downloads.help.palm.com/webosdoctor/rom/pre/p141r0d03312010/eudep141rod/webosdoctorp100ueu-wr.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/pre/p145r0d06302010/eudep145rod/webosdoctorp100ueu-wr.jar

===== Pre Plus =====
* version 1.4.1 http://downloads.help.palm.com/webosdoctor/rom/preplus/p141r0d04272010/wrep141rod/webosdoctorp101ueu-wr.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/preplus/p145r0d06302010/eudep145rod/webosdoctorp101ueu-wr.jar
* version 2.1.0 (DE) http://downloads.help.palm.com/webosdoctor/rom/preplus/p210r0d02212011/eudep210rod/webosdoctorp101ueude-wr.jar
* version 2.1.0 http://downloads.help.palm.com/webosdoctor/rom/preplus/p210r0d03142011/eudep210rod/webosdoctorp101ueu-wr.jar

===== Pixi Plus =====
* P121UEU: P8GUGXXXXXXX (Pixi Plus)
* version 1.4.1 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px141r0d04282010/wrep141rod/webosdoctorp121ewweu-wr.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px145r0d06302010/wrep145rod/webosdoctorp121ewweu-wr.jar

===== Veer =====
* P160UEU: W3UE1XXXXXXX (Veer)
* version 2.1.1 http://downloads.help.palm.com/webosdoctor/rom/veer/p211r0d06292011/wrp211rod/webosdoctorp160unawr.jar

==== Vodafone Europe ====
===== Pixi Plus =====
* P121UEU: P8GUGXXXXXXX (Pixi Plus)
* version 1.4.1.2 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px1412r0d04282010/wrep1412rod/webosdoctorp121ewweu-wr.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px145r0d06302010/wrep145rod/webosdoctorp121ewweu-wr.jar

===== Pre Plus =====
* P101UEU: P7NUGXXXXXXX (Pre Plus on the Vodafone network)
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/preplus/p145r0d06302010/eudep145rod/webosdoctorp101ueu-wr.jar
* version 2.1.0 http://downloads.help.palm.com/webosdoctor/rom/preplus/p210r0d02212011/eudep210rod/webosdoctorp101ueude-wr.jar

==== SFR France ====
===== Pre Plus =====
* P101UEU: P7JUAXXXXXXX (Pre Plus on the SFR network)
* version 1.4.1 http://downloads.help.palm.com/webosdoctor/rom/preplus/p141r0d04272010/wrep141rod/webosdoctorp101ueu-wr.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/preplus/p145r0d06302010/eudep145rod/webosdoctorp101ueu-wr.jar
* version 2.1.0 http://downloads.help.palm.com/webosdoctor/rom/preplus/p210r0d03142011/eudep210rod/webosdoctorp101ueu-wr.jar

===== Pixi Plus =====
* version 1.4.1 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px141r0d04272010/wrep141rod/webosdoctorp121ueu-wr.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px145r0d06302010/wrep145rod/webosdoctorp121ewweu-wr.jar

===== Pre 2 =====
* version 2.0.0 http://downloads.help.palm.com/webosdoctor/rom/pre2/p20r0d11012010/wrep20rod/webosdoctorp103ueu-wr.jar
* version 2.0.1 http://downloads.help.palm.com/webosdoctor/rom/pre2/p201r0d11242010/wrep201rod/webosdoctorp102ueuna-wr.jar
* version 2.1.0 http://downloads.help.palm.com/webosdoctor/rom/pre2/p210sfr03082011/wrep210rod/webosdoctorp103ueuna-wr.jar
* version 2.2.4 http://downloads.help.palm.com/webosdoctor/rom/pre2/p224rod12052011/wrep224rod/webosdoctorp224pre2wr.jar

==== Telcel GSM, Mexico ====
===== Pre =====
* P100UNA: P5XU0XXXXXXX (Pre on the Telcel network)
* version 1.2.5 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p125r0d11252009/tce11p125rod/webosdoctorp100ewwtelcel.jar</nowiki></del>
* version 1.3.5.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p1351r0d01082010/tce11p1351rod/webosdoctorp100ewwtelcel.jar</nowiki></del>
* version 1.4.0 http://downloads.help.palm.com/webosdoctor/rom/pre/p14r0d02252010/tce11p140rod/webosdoctorp100ewwtelcel.jar (P100UNA/ROW)

==== Verizon Wireless ====
===== Pre Plus =====
* P101EWW: P7VE0XXXXXXX (Pre Plus on the Verizon network)
* version 1.3.5.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pre/p1351r0d01082010/ver1z0np1351rod/webosdoctorp101ewwverizonwireless.jar</nowiki></del>
* version 1.4.0 http://downloads.help.palm.com/webosdoctor/rom/pre/p14r0d02252010/ver1z0np140rod/webosdoctorp101ewwverizonwireless.jar
* version 1.4.1.1 http://downloads.help.palm.com/webosdoctor/rom/preplus/p1411r0d04282010/ver1z0np1411rod/webosdoctorp101ewwverizonwireless.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/preplus/p145r0d09132010/ver1z0np145rod/webosdoctorp101ewwverizonwireless.jar
* version 1.4.5.1 http://downloads.help.palm.com/webosdoctor/rom/preplus/p1451r0d05182011/ver1z0np1451rod/webosdoctorp101ewwverizonwireless.jar

===== Pixi Plus =====
* P121EWW: P8V20XXXXXXX (Pixi Plus on the Verizon network)
* version 1.3.5.1 <del><nowiki>http://downloads.help.palm.com/webosdoctor/rom/pixi/px1351r0d01082010/ver1z0np1351rod/webosdoctorp121ewwverizonwireless.jar</nowiki></del>
* version 1.4.0 http://downloads.help.palm.com/webosdoctor/rom/pixi/px14r0d02252010/ver1z0np140rod/webosdoctorp121ewwverizonwireless.jar
* version 1.4.1.1 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px1411r0d04282010/ver1z0np1411rod/webosdoctorp121ewwverizonwireless.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px145r0d08302010/ver1z0np145rod/webosdoctorp121ewwverizonwireless.jar
* version 1.4.5.1 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px1451r0d05182011/ver1z0np1451rod/webosdoctorp121ewwverizonwireless.jar

===== Pre 2 =====
* P102EWW: PGVE0XXXXXXX (Pre 2 on the Verizon network)
* version 2.0.1 http://downloads.help.palm.com/webosdoctor/rom/pre2/p201r0d02172011/ver1z0np201rod/webosdoctorp102verizonwireless.jar
* version 2.1.0 http://downloads.help.palm.com/webosdoctor/rom/pre2/p210r0d08162011/ver1z0np210rod/webosdoctorp102verizonwireless.jar

===== Pre 3 =====
* HSTNH-F30CV: MDVPWXXXXXXX (Pre 3 on the verizon network)
* version 2.2.3 http://downloads.help.palm.com/webosdoctor/rom/manta/p223r0d09292011/wdmantaverizon/webosdoctorp223mantaverizon.jar
* version 2.2.4 http://downloads.help.palm.com/webosdoctor/rom/manta/p224r0d12192011/wdmantaverizon/webosdoctorp224mantaverizon.jar

==== AT&T ====
===== Pre Plus =====
* P101UNA : P7CG0XXXXXXX (Pre Plus on the AT&T network)
* version 1.4.2 http://downloads.help.palm.com/webosdoctor/rom/preplus/p142r0d05162010/attp142rod/webosdoctorp101ewwatt.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/preplus/p145r0d09132010/attp145rod/webosdoctorp101ewwatt.jar

===== Pixi Plus =====
* P121UNA: P8WU0XXXXXXX (Pixi Plus on the AT&T network)
* version 1.4.3 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px143r0d06062010/attp143rod/webosdoctorp121ewwatt.jar
* version 1.4.5 http://downloads.help.palm.com/webosdoctor/rom/pixiplus/px145r0d10112010/attp145rod/webosdoctorp121ewwatt.jar

===== Veer =====
* P160UNA: W1BD6XXXXXXX (Veer on the AT&T network)
* version 2.1.2 http://downloads.help.palm.com/webosdoctor/rom/veer/p212r0d05132011/attp212rod/webosdoctorp160unaatt.jar

===== Pre 3 =====
* HSTNH-F30CN: W3BD1XXXXXXX
* version 2.2.3 http://downloads.help.palm.com/webosdoctor/rom/manta/p223r0d09272011/wdmantaatt/webosdoctorp223mantaatt.jar
* version 2.2.4 http://downloads.help.palm.com/webosdoctor/rom/manta/p224r0d12192011/wdmantaatt/webosdoctorp224mantaatt.jar

==== Rogers ====
===== Pre 2 =====
* version 2.0.1 http://downloads.help.palm.com/webosdoctor/rom/pre2/p201r0d11242010/wrep201rod/webosdoctorp102ueuna-wr.jar
* version 2.1.0 http://downloads.help.palm.com/webosdoctor/rom/pre2/p210r0d03082011/wrep210rod/webosdoctorp104ueu-wr.jar (P102UEU/P102UNA,ROW)
* version 2.2.4 http://downloads.help.palm.com/webosdoctor/rom/pre2/p224rod12052011/wrep224rod/webosdoctorp224pre2wr.jar (P102UEU/P102UNA,ROW)

==== Unlocked ====
===== Pre 2 =====
* P102UEU: PG4U0XXXXXXX (Pre 2 on the Unlocked - Europe network)
* P102UNA: PG9U0XXXXXXX (Pre 2 on the Unlocked - North America network)
* version 2.0.0 http://downloads.help.palm.com/webosdoctor/rom/pre2/p20r0d11012010/wrep20rod/webosdoctorp103ueu-wr.jar (P102UEU only)
* version 2.0.0 http://downloads.help.palm.com/webosdoctor/rom/pre2/p20r0d11182010/wrep20rod/webosdoctorp103ueu-wr.jar (P102UEU & P102UNA)
* version 2.0.1 http://downloads.help.palm.com/webosdoctor/rom/pre2/p201r0d11242010/wrep201rod/webosdoctorp102ueuna-wr.jar (P102UEU & P102UNA)
* version 2.1.0 http://downloads.help.palm.com/webosdoctor/rom/pre2/p210sfr03082011/wrep210rod/webosdoctorp103ueuna-wr.jar (P102UEU/P102UNA,ROW)
* version 2.2.4 http://downloads.help.palm.com/webosdoctor/rom/pre2/p224rod12052011/wrep224rod/webosdoctorp224pre2wr.jar (P102UEU/P102UNA,ROW)
''(Palm changed p103ueu to p102ueuna in 2.0.1)''
''(Palm changed p102ueuna to p103ueuna in 2.1.0)''
''(Palm changed p103ueuna to p224pre2 in 2.2.4)''

===== Pre 3 =====
* HSTNH-F30CE: W3RE1XXXXXXX (Pre 3 Unlocked - Europe network - ROW)
* version 2.2.0 http://downloads.help.palm.com/webosdoctor/rom/manta/p220r0d08222011/wdmantarow/webosdoctorp220mantawr.jar
* version 2.2.4 http://downloads.help.palm.com/webosdoctor/rom/manta/p224r0d12192011/wdmantawr/webosdoctorp224mantawr.jar

== License ==

Note that the webOS Doctor package comes with the following license:

RESTRICTIONS: The Software is licensed for use only with the single Palm device you originally purchased, and you may not distribute or make the Software available over a network or for use with multiple devices. The Software and supporting documentation may be copied only as necessary for backup or archive purposes in support of your use of the Software.

So we can't host different versions of it anywhere - the best we can do is record the md5sums of the versions we know about so that individuals can match this to the files they have for use with their Palm device.

== MD5 sums ==

Here is a list of all the versions that we know about (with md5sums for each, and the build date and build number from /etc/palm-build-info):

Date # MD5SUM Filename
20090522 118 4b3e396f8b1f1c5d3388e3c298af0484 webosdoctorp100ewwsprint-1.0.2.jar
20090616 124 0c8027b5a707eb0d02b1997d48021bd5 webosdoctorp100ewwsprint-1.0.3.jar
20090623 129 32852c4b57d938e85f0fc819e57eacb7 webosdoctorp100ewwsprint-1.0.4.jar
20090717 143 fc602490fdd7b3be8c5f727349c6195f webosdoctorp100ewwsprint-1.1.0.jar
20090717 83 ffd1bc50066d8f54d134b7aac194e3ec webosdoctorp100ewwbellmo-1.1.0.jar
20090913 111 c8f80b3cdbb9b96fd73bbb6062950a83 webosdoctorp100ewwbellmo-1.2.0.jar
20090913 171 93c3f106b7a7e5ef572465dcb4488e1c webosdoctorp100ewwsprint-1.2.0.jar
20090924 100 bc29e1144823afc05a50dcdc2c84475d webosdoctorp100eww-wr-1.1.3.jar
20090929 112 52f4a4cd9b182004a7060cfaa5be2c6f webosdoctorp100ewwbellmo-1.2.1.jar
20090929 172 e7600251e12e5b96f3143138ba61b9eb webosdoctorp100ewwsprint-1.2.1.jar
20091008 7 477f6c3d2ff1673aa9a9d1670aa5e88f webosdoctorp100ewwtelcel-1.2.5.jar
20091015 98 1957476e6d9d221413285c6d5ab697d6 webosdoctorp200ewwsprint-1.2.9.1.jar
20091101 112 063c2f66682dd246fa3bf518adae0f53 webosdoctorp200ewwsprint-1.3.1.jar
20091101 122 9bb8e7547996b5b62ce8742198a9d8bb webosdoctorp100ueu-wr-1.3.1.jar
20091101 122 b93f2f6af2c8eefc89f6ccc03b72eeb6 webosdoctorp100eww-wr-1.3.1.jar
20091101 131 c4202a32ca49a1c843f30b77515cac46 webosdoctorp100ewwbellmo-1.3.1.jar
20091101 194 8261682a25ac21bb2f3107ec5c50dc84 webosdoctorp100ewwsprint-1.3.1.jar
20091113 119 eb33e68b07ccad81847d96f546303880 webosdoctorp200ewwsprint-1.3.2.jar
20091125 140 e9a00b0a24a08f4cca4683bc5ec62227 webosdoctorp100ewwbellmo-1.3.5.jar
20091130 134 4af3d5c4a6d0461b95e75b3fadf93435 webosdoctorp100ueu-wr-1.3.5.jar
20091212 147 00b2575415c5645e9840cce4b8d075e6 webosdoctorp200ewwsprint-1.3.5.jar
20091212 219 4daef882c96461dc1c60cc907c4dfbf0 webosdoctorp100ewwsprint-1.3.5.jar
20100103 148 b78ad564fd8dcdfd469ca43285a5cd90 webosdoctorp120ewwsprint-1.3.5.1.jar
20100103 154 ff9784382ef53e491cb4d81015a34135 webosdoctorp100ewwbellmo-1.3.5.1.jar
20100103 220 14e3c4168030498b42370115b33ee278 webosdoctorp100ewwsprint-1.3.5.1.jar
20100103 27 173dea06595c3c2080b0a8522a160d1c webosdoctorp100ewwtelcel-1.3.5.1.jar
20100103 98 257ee7c9751a0ff909d3f81792a9b874 webosdoctorp101ewwverizonwireless-1.3.5.1.jar
20100106 148 a3c7ae6d93409dea9f0461636f5c79c0 webosdoctorp100ueu-wr-1.3.5.2.jar
20100108 140 89cc6fbaff0d0ce4a05ed5bae53793f8 webosdoctorp121ewwverizonwireless-1.3.5.1.jar
20100214 179 0593f3b94ec4050febacea14c8af7b10 webosdoctorp100ueu-wr-1.4.0.jar
20100214 187 646dd275690fcd7b3819ddddc488c2de webosdoctorp100ewwbellmo-1.4.0.jar
20100214 195 46025f5f59c98721dee4ef4214e5f90b webosdoctorp200ewwsprint-1.4.0.jar
20100214 254 7aee384f4fdcc6189a027617efaac983 webosdoctorp100ewwsprint-1.4.0.jar
20100214 52 e9a1d644a447d460e340725869f3ad46 webosdoctorp100ewwtelcel-1.4.0.jar
20100220 136 4bb776010b0b88da25630887d72faa18 webosdoctorp101ewwverizonwireless-1.4.0.jar
20100220 169 f7f3296db9ef0682d98f92354f696ba2 webosdoctorp121ewwverizonwireless-1.4.0.jar
20100313 198 7f7d258ba662dcd3085d76cb67dee906 webosdoctorp101ueu-wr-1.4.1.jar
20100317 208 edf4fa9cbac537f4b734339820b85030 webosdoctorp100ewwbellmo-1.4.1.jar
20100318 121 f9b8aaa955255e9645f833b57010b60a webosdoctorp101ewwatt-1.4.2.jar
20100319 190 bd9d4aca9f1b9657956e29a09648e4b0 webosdoctorp121ueu-wr-1.4.1.jar
20100324 202 63ea69769b8b066f7525cba3d3c2d1bc webosdoctorp100ueu-wr-1.4.1.jar
20100324 278 5f736a8baf27a3ea4d525c30f871f2d2 webosdoctorp100ewwsprint-1.4.1.1.jar
20100325 225 a6779bbdbb34a52cde1104a29dab64ca webosdoctorp200ewwsprint-1.4.1.1.jar
20100401 158 edb45ceebb21de02aecf4ae457e785de webosdoctorp101ewwverizonwireless-1.4.1.1.jar
20100401 199 48912881581fb240e2a27e688b80ac79 webosdoctorp121ewwverizonwireless-1.4.1.1.jar
20100419 222 eba97405cc882687567aa0988a206fb4 webosdoctorp121ewwatt-1.4.3.jar
20100614 299 a55a377dd38fd7a8e94ba9514e1d9e18 webosdoctorp100ewwsprint-1.4.5.jar
20100614 222 ca6a2e3a976b593859b11dee9941a80e webosdoctorp100ueu-wr-1.4.5.jar
20100614 222 dddc78516c6770b475d08bdcf20f22d0 webosdoctorp101ueu-wr-1.4.5.jar
20100614 231 1b0c63976ef3bc783770e35cfad55e5f webosdoctorp121ewweu-wr-1.4.5.jar
20100614 232 e11d44f00d7d9b44e7dcddb3f5b45bee webosdoctorp100ewwbellmo-1.4.5.jar
20100614 171 2e1cbe14267c61941d62d2d7fd82a544 webosdoctorp101ewwverizonwireless-1.4.5.jar
20100615 226 7d25cd1a8dbda76d297a9d4998d8e32a webosdoctorp121ewwverizonwireless-1.4.5.jar
20100722 142 6c0c12ae2585e8f8e1adf3965603ba78 webosdoctorp101ewwatt-1.4.5.jar
20100818 233 957acf91ecc1d126c7062477bd10093c webosdoctorp121ewwatt-1.4.5.jar
20101009 70 5152f9f3f9fd24f5491ac809d1138735 webosdoctorp103ueu-wr-2.0.0.jar (P102UEU)
20101009 70 1aa510de51394e490428cc053d3cdfd0 webosdoctorp103ueu-wr-2.0.0.jar (P102UNA)
20101117 79 e9f7c688266718a319b9fdfd6ef6c599 webosdoctorp102ueuna-wr-2.0.1.jar (P102UEU & P102UNA)
20101222 100 643824a4c103e266fd8e2760b098815c webosdoctorp102verizonwireless-2.0.1.jar (P102EWW)
20110201 284 ed2c394171d19a4af9d9d42c670e9791 webosdoctorp101ueude-wr-2.1.0.jar (P101UEU & P101UNA)
20110202 100 1b9d7d63e0f765647705bac6a867da02 webosdoctorp104ueu-wr-2.1.0.jar (P102UEU & P102UNA)
20110219 4111 fb6ae25e15c809836bbe73931839ccf0 webosdoctorp160una-wr-2.1.1.jar
20110225 108 477f12cc73f5d8a3a00761dcb3751e6b webosdoctorp103ueuna-wr-2.1.0.jar (P102UEU & P102UNA)
20110302 285 03566ac546d72c59d1cdc1af5a4da920 webosdoctorp101ueu-wr-2.1.0.jar (P101UEU & P101UNA)
20110318 231 fdc62b2d6e717dc90b208d52fd6336c0 webosdoctorp101ewwverizonwireless-1.4.5.1.jar
20110415 2296 bb2743f0a30abdb62c03b071d149c5a6 webosdoctorp160unaatt-2.1.2.jar
20110421 276 0cd21b1f65b021787c8c83d7529adfaa webosdoctorp121ewwverizonwireless-1.4.5.1.jar
20110504 124 b586ef0cd8a5b41aa926c4f6f96e1874 webosdoctorp102verizonwireless-2.1.0.jar (P102EWW)
20110609 41 e3931dbc9109a87928fe4e559cdae29f webosdoctorp300hstnhwifi-3.0.0.jar
20110729 68 669db17352726708486491c532a06d9d webosdoctorp302hstnhwifi-3.0.2.jar
20110801 66 2f6bffcd29672cb0930418a722ed9da2 webosdoctorp302hstnhatt-3.0.2.jar (-66)
20110808 3171 319ce80db93a2fc845a004d60fc3735b webosdoctorp220manta-wr-2.2.0.jar
20110909 2207 6453be81a391b78c56c24a77a9853226 webosdoctorp223mantaatt-2.2.3.jar
20110929 1218 b202608666e804f2b4785eb114fd72a3 webosdoctorp223mantaverizon-2.2.3.jar
20111010 74 2e7fbf0bad8b89fbe88e0805c626df02 webosdoctorp302hstnhatt-3.0.2.jar (-74)
20111012 77 c580ad7960fc6ff4fe9559d5ef98c04c webosdoctorp304hstnhwifi-3.0.4.jar
20111012 77 e91bc84ad1ffc7c7681e3ffde467d467 webosdoctorp304hstnhatt-3.0.4.jar
20111129 160 ea0cb312cb92c1e4d7f1d70820923538 webosdoctorp224pre2-wr-2.2.4.jar
20111129 2211 4670a65b6d35e6a4bb73905db79044a3 webosdoctorp224mantaatt-2.2.4.jar
20111129 3175 c4aa5b8bb00cec6079416591f7a8e38c webosdoctorp224manta-wr-2.2.4.jar
20111129 1222 04648bca9d241bc0889ceaf5c8ddf790 webosdoctorp224mantaverizon-2.2.4.jar
20111211 86 ddc055f64b17cc2ed938441558d8a2e7 webosdoctorp305hstnhatt-3.0.5.jar
20111211 86 953a902b1fa931e640a0f29adc2d5477 webosdoctorp305hstnhwifi-3.0.5.jar

== Notes ==

1.0.3 is the last version to contain PmModemFactory

Using a 2.0 doctor will wipe your usb partition, unless you already have 2.0 on your device. For example, 1.4.5 > 2.0.1 will wipe usb, but 2.0.0 > 2.0.1 will not.