WebOS Internals - User contributions [en]

WebOS 2 Upgrade

2011-12-19T04:33:00Z

Abyssul: /* Step 3: Run device-specific MetaDoctor script */

= 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}.
* ''[http://www.webosworld.com/ WebOS World]'' writer Jake Morrison has written a [http://webosworld.com/2011/03/07/my-meta-doctor-to-2-1-experience/ How-To guide] based directly off the [http://www.webos-internals.org/wiki/WebOS_2_Upgrade WebOS Internals 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 [http://developer.palm.com/index.php?option=com_content&view=article&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.

'''Pre- and Pre+ devices will not be upgraded past 2.1.0 until Palm releases the 2.2.4 kernel source code.'''

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

2011-12-19T04:20:09Z

Abyssul:

= 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}.
* ''[http://www.webosworld.com/ WebOS World]'' writer Jake Morrison has written a [http://webosworld.com/2011/03/07/my-meta-doctor-to-2-1-experience/ How-To guide] based directly off the [http://www.webos-internals.org/wiki/WebOS_2_Upgrade WebOS Internals 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 [http://developer.palm.com/index.php?option=com_content&view=article&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.

'''Pre- and Pre+ devices will not be upgraded past 2.1.0 unless Palm releases a compatible kernel (in the form of a 2.2.4 Pre+ doctor)'''

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.

Application:Preware

2011-09-16T16:45:52Z

Abyssul: Change to updating and removing Preware for other options. Removed app catalog bug since the feed is no longer supported.

[[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.7.5 (28 August 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.

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

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.org/
## 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.1.1 or later of [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-1-1-a.html 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.precentral.net/canuck-coding/274461-webos-quick-install-v4-2-3-a.html WebOS Quick Install v4.2.3]'''

# 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
## [http://dl.dropbox.com/u/2774158/WebOSQuickInstall-4.2.3.jar Click Here] to download WebOS Quick Install v4.2.3
# 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.

<source lang="bash">
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/preware-bootstrap.sh
sh /tmp/preware-bootstrap.sh
</source>

 

=== 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 Xecutah on webOS 2.x or lower, hold the Orange button on your keypad and choose Xecutah 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.
 
{| 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.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:Xecutah

2011-09-16T16:41:25Z

Abyssul: /* Installing Xecutah using the official HP/Palm SDK */ Broken link

[[Category:Application]]

{{application
| name=Xecutah
| type=webOS
| version=Version: 0.9.0 (16 September 2011)
| tag=Utilities
| screenshot=Xecutah_ss1.png
| description=
}}

 
== Summary ==

[[image:X.png|frameless|left]]

Xecutah allows you to start an X Windows System server in a webOS card, and run other X applications on that server. This app is available to the Pre, Pixi, Palm Pre2, Veer, and Touchpad (running 3.0.2).

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

 
=== Key features ===

=== Related packages ===

* XServer - Used to display X Windows applications on webOS
* XTerm - Used to provide a Linux command-line interface on webOS.
* Ubuntu Chroot - Provides chroot installation for Ubuntu OS
* Debian Chroot - Provides chroot installation for Debian OS

 
=== Status ===
Xecutah has been upgraded to release status, and is no longer considered beta.
Experimental updates can be found in the [http://www.webos-internals.org/wiki/Testing_Feeds testing feeds]. This are considered beta versions and potentially unstable.

Some milestones worth mentioning in Xecutah's history include:

* Since 16 September 2011, Xecutah was upgraded to public release.
* 27 August 2011, support for Debian chroot (0.8.4)
* 24 August 2011, Tweak support for keyboard and color (0.8.3)
* 17 July 2011, support for Ubuntu chroot (update 0.8.0)
* 14 July 2011, first alpha release (update 0.6.5)

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

Code from Xecutah 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 Xecutah ==

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

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

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Xecutah. 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 Xecutah works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 

=== Installing Xecutah with Preware ===
These instructions are the most recommended for installing Xecutah.

#Open [http://www.webos-internals.org/wiki/Application:Preware Preware]
#Let Preware update the packages
#Type Xecutah (the letters will appear at the top in the header to indicate you are going to search.)
#Press Enter
#Open Xecutah package details by tapping on the Xecutah entry from the search
#Tap Install at the bottom of the screen

 
=== Installing Xecutah with WebOS Quick Install ===
You can use version 4.1.1 or later of [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-3-1-a.html] to install Xecutah 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.precentral.net/canuck-coding/274461-webos-quick-install-v4-3-1-a.html WebOS Quick Install v4.3.1]'''

# 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
# 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 Xecutah
# Click Install.

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

To install Xecutah 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 Xecutah package onto your computer from http://ipkg.preware.org/feeds/webos-internals/
## To install Xecutah on a Pre, Pre2, or Touchpad, download the 'armv7' .ipk file
## To install Xecutah on a Pixi, download the 'armv7' .ipk file
## To install Xecutah on the 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 Xecutah package you downloaded, then type palm-install and.the.package.arm.name.ipk

An example would be:
<source lang="bash">
palm-install org.webosinternals.xecutah_0.9.0_i686.ipk
</source>

 

=== Updating Xecutah ===
To update Xecutah, just run Preware and select "Package Updates" from the main scene. If an update to Xecutah is available, it will appear in the list. Then select the "Update" button. Xecutah 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 Xecutah. Those tools are unable to operate correctly on advanced homebrew packages.

 

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

To remove Xecutah on webOS 2.x or lower, hold the Orange button on your keypad and choose Xecutah 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 ==
=== Main ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Xecutah_Main.png|160px|frameless|left|text-top]]
| valign="top"|You can select which X-Windows application to execute from this screen.
 
| valign="top"|Always start the XServer entry first before selecting your next selection.
|}

 
=== Preferences ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Xecutah_Pref.png|160px|frameless|left|text-top]]
| valign="top"|In the main section on the top bar on the left side is a menu that takes you to the preference screen. On the preference screen, you can select what type of theme for the Xecutah app to display in. The current options are Palm Default and Palm Dark.
|}

=== Known bugs ===

*No support for the ESC key yet

 
== Changelog ==
 
For those interested, the full Changelog can be [http://git.webos-internals.org/applications/xecutah/refs/tags found here]. Listed below is the Changelog since the public release.
 

; 0.9.0
* Public release

 

== Repository ==
Xecutah is housed in the applications/Xecutah 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:Xecutah

2011-09-16T16:40:36Z

Abyssul: Added more related packages and what devices are supported.

[[Category:Application]]

{{application
| name=Xecutah
| type=webOS
| version=Version: 0.9.0 (16 September 2011)
| tag=Utilities
| screenshot=Xecutah_ss1.png
| description=
}}

 
== Summary ==

[[image:X.png|frameless|left]]

Xecutah allows you to start an X Windows System server in a webOS card, and run other X applications on that server. This app is available to the Pre, Pixi, Palm Pre2, Veer, and Touchpad (running 3.0.2).

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

 
=== Key features ===

=== Related packages ===

* XServer - Used to display X Windows applications on webOS
* XTerm - Used to provide a Linux command-line interface on webOS.
* Ubuntu Chroot - Provides chroot installation for Ubuntu OS
* Debian Chroot - Provides chroot installation for Debian OS

 
=== Status ===
Xecutah has been upgraded to release status, and is no longer considered beta.
Experimental updates can be found in the [http://www.webos-internals.org/wiki/Testing_Feeds testing feeds]. This are considered beta versions and potentially unstable.

Some milestones worth mentioning in Xecutah's history include:

* Since 16 September 2011, Xecutah was upgraded to public release.
* 27 August 2011, support for Debian chroot (0.8.4)
* 24 August 2011, Tweak support for keyboard and color (0.8.3)
* 17 July 2011, support for Ubuntu chroot (update 0.8.0)
* 14 July 2011, first alpha release (update 0.6.5)

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

Code from Xecutah 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 Xecutah ==

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

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

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Xecutah. 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 Xecutah works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 

=== Installing Xecutah with Preware ===
These instructions are the most recommended for installing Xecutah.

#Open [http://www.webos-internals.org/wiki/Application:Preware Preware]
#Let Preware update the packages
#Type Xecutah (the letters will appear at the top in the header to indicate you are going to search.)
#Press Enter
#Open Xecutah package details by tapping on the Xecutah entry from the search
#Tap Install at the bottom of the screen

 
=== Installing Xecutah with WebOS Quick Install ===
You can use version 4.1.1 or later of [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-3-1-a.html] to install Xecutah 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.precentral.net/canuck-coding/274461-webos-quick-install-v4-3-1-a.html WebOS Quick Install v4.3.1]'''

# 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
# 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 Xecutah
# Click Install.

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

To install Xecutah 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 Xecutah package onto your computer from http://ipkg.Xecutah.org/feeds/webos-internals/
## To install Xecutah on a Pre, Pre2, or Touchpad, download the 'armv7' .ipk file
## To install Xecutah on a Pixi, download the 'armv7' .ipk file
## To install Xecutah on the 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 Xecutah package you downloaded, then type palm-install and.the.package.arm.name.ipk

An example would be:
<source lang="bash">
palm-install org.webosinternals.xecutah_0.9.0_i686.ipk
</source>

 

=== Updating Xecutah ===
To update Xecutah, just run Preware and select "Package Updates" from the main scene. If an update to Xecutah is available, it will appear in the list. Then select the "Update" button. Xecutah 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 Xecutah. Those tools are unable to operate correctly on advanced homebrew packages.

 

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

To remove Xecutah on webOS 2.x or lower, hold the Orange button on your keypad and choose Xecutah 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 ==
=== Main ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Xecutah_Main.png|160px|frameless|left|text-top]]
| valign="top"|You can select which X-Windows application to execute from this screen.
 
| valign="top"|Always start the XServer entry first before selecting your next selection.
|}

 
=== Preferences ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Xecutah_Pref.png|160px|frameless|left|text-top]]
| valign="top"|In the main section on the top bar on the left side is a menu that takes you to the preference screen. On the preference screen, you can select what type of theme for the Xecutah app to display in. The current options are Palm Default and Palm Dark.
|}

=== Known bugs ===

*No support for the ESC key yet

 
== Changelog ==
 
For those interested, the full Changelog can be [http://git.webos-internals.org/applications/xecutah/refs/tags found here]. Listed below is the Changelog since the public release.
 

; 0.9.0
* Public release

 

== Repository ==
Xecutah is housed in the applications/Xecutah 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:Xecutah

2011-09-16T16:35:22Z

Abyssul: Whole creation of Xecutah page. Missing detailed info on usage and some potential false info

[[Category:Application]]

{{application
| name=Xecutah
| type=webOS
| version=Version: 0.9.0 (16 September 2011)
| tag=Utilities
| screenshot=Xecutah_ss1.png
| description=
}}

 
== Summary ==

[[image:X.png|frameless|left]]

Xecutah allows you to start an X Windows System server in a webOS card, and run other X applications on that server. This app is available to the Palm Pre2, Veer, and Touchpad (running 3.0.2).

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

 
=== Key features ===

=== Related packages ===

* XServer - Used to display X Windows applications on webOS
* XTerm - Used to provide a Linux command-line interface on webOS.

 
=== Status ===
Xecutah has been upgraded to release status, and is no longer considered beta.
Experimental updates can be found in the [http://www.webos-internals.org/wiki/Testing_Feeds testing feeds]. This are considered beta versions and potentially unstable.

Some milestones worth mentioning in Xecutah's history include:

* Since 16 September 2011, Xecutah was upgraded to public release.
* 27 August 2011, support for Debian chroot (0.8.4)
* 24 August 2011, Tweak support for keyboard and color (0.8.3)
* 17 July 2011, support for Ubuntu chroot (update 0.8.0)
* 14 July 2011, first alpha release (update 0.6.5)

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

Code from Xecutah 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 Xecutah ==

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

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

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Xecutah. 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 Xecutah works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 

=== Installing Xecutah with Preware ===
These instructions are the most recommended for installing Xecutah.

#Open [http://www.webos-internals.org/wiki/Application:Preware Preware]
#Let Preware update the packages
#Type Xecutah (the letters will appear at the top in the header to indicate you are going to search.)
#Press Enter
#Open Xecutah package details by tapping on the Xecutah entry from the search
#Tap Install at the bottom of the screen

 
=== Installing Xecutah with WebOS Quick Install ===
You can use version 4.1.1 or later of [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-3-1-a.html] to install Xecutah 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.precentral.net/canuck-coding/274461-webos-quick-install-v4-3-1-a.html WebOS Quick Install v4.3.1]'''

# 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
# 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 Xecutah
# Click Install.

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

To install Xecutah 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 Xecutah package onto your computer from http://ipkg.Xecutah.org/feeds/webos-internals/
## To install Xecutah on a Pre, Pre2, or Touchpad, download the 'armv7' .ipk file
## To install Xecutah on a Pixi, download the 'armv7' .ipk file
## To install Xecutah on the 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 Xecutah package you downloaded, then type palm-install and.the.package.arm.name.ipk

An example would be:
<source lang="bash">
palm-install org.webosinternals.xecutah_0.9.0_i686.ipk
</source>

 

=== Updating Xecutah ===
To update Xecutah, just run Preware and select "Package Updates" from the main scene. If an update to Xecutah is available, it will appear in the list. Then select the "Update" button. Xecutah 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 Xecutah. Those tools are unable to operate correctly on advanced homebrew packages.

 

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

To remove Xecutah on webOS 2.x or lower, hold the Orange button on your keypad and choose Xecutah 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 ==
=== Main ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Xecutah_Main.png|160px|frameless|left|text-top]]
| valign="top"|You can select which X-Windows application to execute from this screen.
 
| valign="top"|Always start the XServer entry first before selecting your next selection.
|}

 
=== Preferences ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Xecutah_Pref.png|160px|frameless|left|text-top]]
| valign="top"|In the main section on the top bar on the left side is a menu that takes you to the preference screen. On the preference screen, you can select what type of theme for the Xecutah app to display in. The current options are Palm Default and Palm Dark.
|}

=== Known bugs ===

*No support for the ESC key yet

 
== Changelog ==
 
For those interested, the full Changelog can be [http://git.webos-internals.org/applications/xecutah/refs/tags found here]. Listed below is the Changelog since the public release.
 

; 0.9.0
* Public release

 

== Repository ==
Xecutah is housed in the applications/Xecutah 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]

File:Xecutah Pref.png

2011-09-16T16:23:30Z

Abyssul: Screenshot of Xecutah's preference scene for 0.9.0 for Pre2

Screenshot of Xecutah's preference scene for 0.9.0 for Pre2

File:Xecutah Main.png

2011-09-16T16:22:58Z

Abyssul: Screenshot of Xecutah's main scene for 0.9.0

Screenshot of Xecutah's main scene for 0.9.0

Hulu Fix

2011-08-25T22:13:47Z

Abyssul:

August 24th, 2011 Hulu decided to block video access to Touchpad users everywhere with no application in sight. This fix allows access to Hulu again, but may impact other Flash objects on the internet. What is affected is unknown at this point.

== Install with WOSQI ==
-Open webOS Quick Install

-Go to tools, then Linux Commandline

Copy/paste/enter each line separately:
<pre><nowiki>
cd /
cp /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' /usr/lib/BrowserServerPlugins/libflashplayer.so
reboot
</nowiki></pre>

== Install with Terminus/Putty/Novacom ==

Copy/paste/enter each line separately:
<pre><nowiki>
cd /
cp /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' /usr/lib/BrowserServerPlugins/libflashplayer.so
reboot
</nowiki></pre>

== Undo Your Changes ==
Copy and paste the following into webOS Quick Install's Linux Commandline, or your Terminus/Putty/Novacom terminal:
<pre><nowiki>
cd /
cp /usr/lib/BrowserServerPlugins/libflashplayer.so.bak /usr/lib/BrowserServerPlugins/libflashplayer.so
reboot
</nowiki></pre>

Hulu Fix

2011-08-25T19:22:55Z

Abyssul:

Hulu Fix

2011-08-25T19:10:32Z

Abyssul:

August 24th, 2011 Hulu decided to block video access to Touchpad users everywhere with no application in sight.

== Install with WOSQI ==
-Open webOS Quick Install

-Go to tools, then Linux Commandline

Copy and paste:
<pre><nowiki>
cd /
mv /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' libflashplayer.so
reboot
</nowiki></pre>

== Install with Terminus/Putty/Novacom ==

Copy and paste:
<pre><nowiki>
cd /
mv /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' libflashplayer.so
reboot
</nowiki></pre>

Hulu Fix

2011-08-25T19:07:53Z

Abyssul:

August 24th, 2011 Hulu decided to block video access to Touchpad users everywhere with no application in sight.

== Install with WOSQI ==
-Open webOS Quick Install

-Go to tools, then Linux Commandline

Copy and paste:
<pre><nowiki>
cd /
mv /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' libflashplayer.so
</nowiki></pre>

== Install with Terminus/Putty/Novacom ==

Copy and paste:
<pre><nowiki>
cd /
mv /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' libflashplayer.so
</nowiki></pre>

Hulu Fix

2011-08-25T19:07:05Z

Abyssul:

August 24th, 2011 Hulu decided to block video access to Touchpad users everywhere with no application in sight.

== Install with WOSQI ==
-Open webOS Quick Install
-Go to tools, then Linux Commandline

Copy and paste:
<pre><nowiki>
cd /
mv /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' libflashplayer.so
</nowiki></pre>

== Install with Terminus/Putty/Novacom ==

Copy and paste:
<pre><nowiki>
cd /
mv /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' libflashplayer.so
</nowiki></pre>

Hulu Fix

2011-08-25T19:05:03Z

Abyssul: Created page with "August 24th, 2011 Hulu decided to block video access to Touchpad users everywhere with no application in sight. == Install with WOSQI == -Open webOS Quick Install -Go to tools,..."

August 24th, 2011 Hulu decided to block video access to Touchpad users everywhere with no application in sight.

== Install with WOSQI ==
-Open webOS Quick Install
-Go to tools, then Linux Commandline

Copy and paste:
<code>
cd /
mv /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' libflashplayer.so
</code>

== Install with Terminus/Putty/Novacom ==

Copy and paste:
<math>
cd /
mv /usr/lib/BrowserServerPlugins/libflashplayer.so /usr/lib/BrowserServerPlugins/libflashplayer.so.bak
sed -i 's/WEB 10/WIN 10/' libflashplayer.so
</math>

WebOS 2 Upgrade

2011-02-24T21:57:58Z

Abyssul: /* Step 5: Restore /etc/palm-build-info */

Application talk:Precorder

2009-12-05T18:53:46Z

Abyssul:

__TOC__

== Page Layout ==

Please place all comments under the appropriate category. If you would like a feature that has already been requested then just add your signature by placing two asterisks and four tilde's <nowiki>**~~~~</nowiki> on the line underneath. It will show up like this.

*Here is a feature request that I will add my signature to.
**[[User:Cryptk|Cryptk]] 19:06, 24 November 2009 (UTC)

Please remember to sign all new entries with four tildes <nowiki>~~~~</nowiki>

I know this is alpha but I want ppl to put their opinions/observations.

== Bug Reports ==

* The sound quality is very low --[[User:En0x|en0x]] 14:31, 24 November 2009 (UTC)
** Microphone is on the opposite side of the camera. Narration from user isn't too bad. Sound is better with playback on computer. Looking into ways to stage a temperary alsa config to boost mic, or level it through a 3rd utility which would require another service --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Both the video only and audio only options produce only audio.--[[User:Gkatsev|Gkatsev]] 16:05, 24 November 2009 (UTC)
** Problem noted, on the map --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Sound is only heard in the left channel --[[User:Gryn|Gryn]] 22:39, 24 November 2009 (UTC)
** This fix would probably also require a 3rd service/utility --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* App saves files "when it wants to" --[[User:Gryn|Gryn]] 12:30, 25 November 2009 (UTC)
** This problem is directly related to the lack of feedback between the pipeline, the service, and the app. This will eventually be resolved once the output and errors get properly filtered down, and it may not happen til/unless the service is converted to C. --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Recording with flash on forces recording to end around 7 seconds in --[[User:Gryn|Gryn]] 12:30, 25 November 2009 (UTC)
** I have heard no other reports of this problem. If it continues, please see me (zsoc) in #webos-internals for debugging. --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* App only seems to save files when the Video application is open. --[[User:Ccolman|Ccolman]] 17:22, 25 November 2009 (UTC)
* When I select audio format to mp3- video will not record. [[User:13brian|13brian]] 03:54, 3 December 2009 (UTC)
* The current .mp4 container the application outputs doesn't allowing the stock Pre video player to scrub through the video --[[User:Abyssul|Abyssul]] December 5, 2009

==Viewfinder discussion ==

The development of a viewfinder for the app is "hard" -- heck the APP was hard until zsoc showed up. If you know what the term "gstreamer sink" means, then you will understand zsoc's explanation that he can not fork a gstreamer sink.

If you do NOT know what that means, then we are forced to talk around the actual problem and to attempt to explain it via analogy. The way that Mojo is built, unlike X-windows or Windows, or other existing GUI's, there is exactly and precisely one "pipe" to move video around. If webOS used "X" as a framework instead of Mojo, the viewfinder app would be trivial. But _inside Luna_ Inside the linux app that runs webos, there isn't a way to "fork" a video stream.

So, when zsoc hooks up the camera to a recording app, he has used up the one and only pipe. There isn't a pipe available to hook the camera up to a display. Some people then had the clever idea, well, the app is //recording// the video, let's play it back, there would be a lag, but that would be better than no viewfinder at all. Nope. one pipe, remember? So if we used the pipe to hook the camera up to the recorder, then there's no pipe to hook the recording up to the display either.

If you are enough of a programmer to look at zsoc's service and understand what he's done, if you have messed with gstreamer internals, we will be happy to have your input, here, or in the #webos-internals chat on IRC. If not, then if you want to discuss this in detail, please go read code first, zsoc has had a '''''lot''''' of naive suggestions, and his response is pretty much consistent, that the suggester doesn't understand the problem. Please do not post suggestions in the thread unless you have researched "gstreamer sink."

If you're enough of a programmer to '''fix''' it, the source repository is listed in the article and we will be eternally grateful.

Thanks for your patience.

== Feature Requests ==

* I would like to have Record New moved to the bottom... It's hard to tap it when you have slider open --[[User:En0x|en0x]] 14:21, 24 November 2009 (UTC)
** done --[[User:Prenos|Prenos]] 17:17, 24 November 2009 (UTC)
* Add option to launch video app from precorder --[[User:En0x|en0x]] 17:04, 24 November 2009 (UTC)
**--[[User:Gryn|Gryn]] 22:37, 24 November 2009 (UTC)
*** This is already implemented, will be released in next version --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Way to show how many minutes I recorded? in precorder --[[User:En0x|en0x]] 17:15, 24 November 2009 (UTC)
I have a count up timer planned --[[User:Prenos|Prenos]] 17:18, 24 November 2009 (UTC)
* Flash toggle on main scene? --[[User:En0x|en0x]] 17:21, 24 November 2009 (UTC)
** I looked into this. The whole graphical UI is changing in the next version. This might be a future option still tho --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Have it show the estimated video recording time remaining based on free space in the /media/internal --[[User:Cryptk|Cryptk]] 18:45, 24 November 2009 (UTC)
**--[[User:ProfJonathan|ProfJonathan]] 19:50, 24 November 2009 (UTC)
*** This isn't practical for a number of reasons, but I'll see if someone else wants to implement it --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Use space on keyboard to start/stop recording --[[User:En0x|en0x]] 19:34, 24 November 2009 (UTC)
**--[[User:ProfJonathan|ProfJonathan]] 19:50, 24 November 2009 (UTC)
*** This is feasable, will consider implemented an API for this option --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
*MP3 audio-only recording, for creating podcasts --[[User:ProfJonathan|ProfJonathan]] 19:52, 24 November 2009 (UTC)
** This will require a minor overhaul of the general video start request, or a new request method. It will be an available option if technically feasable once beta hits --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Allow user to see what is being recorded just like the camera application where you can see the picture being taken. --[[User:thatdude|thatdude]] 00:04 25 November 2009 (EST)
** Consider this impossible for the moment. Look for version 1.0.0 of Precorder or wait till palm releases their app
*** Would it be possible show the video from the camera while not recording? For example to better frame a shot before pressing record?
* If possible have the interface (main scene) look like the camera application where the bottom left icon would open the video application as a new card, the middle button would start/stop recording, and the right button would turn on the flash on/off on the fly. --[[User:thatdude|thatdude]] 00:08 25 November 2009 (EST)
**You mean more buttons? Some UI changes stated above --[[User:Gryn|Gryn]] 21:51, 25 November 2009 (UTC)
* Allow the launch page to orientate the direction the camera needs to be to record. --Mamouton 11:59 pm 28 November 2009
**Formatting the page to the camera orientation --[[User:Gryn|Gryn]] 15:07, 28 November 2009 (UTC)
* Where do we add 'thanks' ? Here? Well, thanks! Really looking forward to this one (now I'll go and find it. Hopefully .ipk.) [[User:FreeTim|FreeTim]] 11:04, 4 December 2009 (UTC)

== im not a programmer just have an ideah don't hurt me ==

To save ur time (that you can be useing to save my digital life) answer this question.
Is it possible to program the pre to capture things that are occuring on the screen (like the examples on themes ect.) if so then this idea may be of use to you.

This is where i don't want you to hurt me. As when the normal still capture camera is running you see a live (digital) renderring of the world.
(2nd and least possible idea) If that digital information could be copied, captured, or intercepted and saved then video could be possible. (1st most propable idea) Use a patch to capture (most likely low resoloution for speed) images in, rappid succession, of the screan while the normal pre camera is displaying on the screan.

I realize that these ideas may be just that and is completely different from the pre-corder, but i do hope that this idea is truely considered and inspires an even better idea.

Fingers Crossed O_o

Me

GStreamer has a Tee tool. That takes in one stream and splits it in two (if that helps)

example and explanation from http://www.vidarholen.net/contents/blog/?p=5

gst-launch-0.10 v4l2src ! tee name=videoout ! queue ! videorate ! video/x-raw-yuv,fps=15 ! queue ! theoraenc quality=60 ! queue ! muxout. pulsesrc ! audio/x-raw-int,rate=22000,channels=1,width=16 ! queue ! audioconvert ! vorbisenc ! queue ! muxout. oggmux name=muxout ! filesink location=lulz.ogg videoout. ! queue ! ffmpegcolorspace ! ximagesink

#Get a v4l2 video source, split it and put one end though a
#theora codec and send the other to videoout (defined later)
v4l2src ! tee name=videoout ! queue ! videorate ! video/x-raw-yuv,fps=15 \
! queue ! theoraenc quality=60 ! queue ! muxout.

#Get audio from a pulseaudio stream, run it through the vorbis encoder
pulsesrc ! audio/x-raw-int,rate=22000,channels=1,width=16 \
! queue ! audioconvert ! vorbisenc ! queue !muxout.

#Mux the audio and video together, and put it in "media.ogg"
oggmux name=muxout ! filesink location=media.ogg

#Put the other end of the video split out on the screen
videoout. ! queue ! ffmpegcolorspace ! ximagesink

Application talk:Precorder

2009-12-05T18:52:40Z

Abyssul:

__TOC__

== Page Layout ==

Please place all comments under the appropriate category. If you would like a feature that has already been requested then just add your signature by placing two asterisks and four tilde's <nowiki>**~~~~</nowiki> on the line underneath. It will show up like this.

*Here is a feature request that I will add my signature to.
**[[User:Cryptk|Cryptk]] 19:06, 24 November 2009 (UTC)

Please remember to sign all new entries with four tildes <nowiki>~~~~</nowiki>

I know this is alpha but I want ppl to put their opinions/observations.

== Bug Reports ==

* The sound quality is very low --[[User:En0x|en0x]] 14:31, 24 November 2009 (UTC)
** Microphone is on the opposite side of the camera. Narration from user isn't too bad. Sound is better with playback on computer. Looking into ways to stage a temperary alsa config to boost mic, or level it through a 3rd utility which would require another service --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Both the video only and audio only options produce only audio.--[[User:Gkatsev|Gkatsev]] 16:05, 24 November 2009 (UTC)
** Problem noted, on the map --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Sound is only heard in the left channel --[[User:Gryn|Gryn]] 22:39, 24 November 2009 (UTC)
** This fix would probably also require a 3rd service/utility --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* App saves files "when it wants to" --[[User:Gryn|Gryn]] 12:30, 25 November 2009 (UTC)
** This problem is directly related to the lack of feedback between the pipeline, the service, and the app. This will eventually be resolved once the output and errors get properly filtered down, and it may not happen til/unless the service is converted to C. --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Recording with flash on forces recording to end around 7 seconds in --[[User:Gryn|Gryn]] 12:30, 25 November 2009 (UTC)
** I have heard no other reports of this problem. If it continues, please see me (zsoc) in #webos-internals for debugging. --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* App only seems to save files when the Video application is open. --[[User:Ccolman|Ccolman]] 17:22, 25 November 2009 (UTC)
* When I select audio format to mp3- video will not record. [[User:13brian|13brian]] 03:54, 3 December 2009 (UTC)

==Viewfinder discussion ==

The development of a viewfinder for the app is "hard" -- heck the APP was hard until zsoc showed up. If you know what the term "gstreamer sink" means, then you will understand zsoc's explanation that he can not fork a gstreamer sink.

If you do NOT know what that means, then we are forced to talk around the actual problem and to attempt to explain it via analogy. The way that Mojo is built, unlike X-windows or Windows, or other existing GUI's, there is exactly and precisely one "pipe" to move video around. If webOS used "X" as a framework instead of Mojo, the viewfinder app would be trivial. But _inside Luna_ Inside the linux app that runs webos, there isn't a way to "fork" a video stream.

So, when zsoc hooks up the camera to a recording app, he has used up the one and only pipe. There isn't a pipe available to hook the camera up to a display. Some people then had the clever idea, well, the app is //recording// the video, let's play it back, there would be a lag, but that would be better than no viewfinder at all. Nope. one pipe, remember? So if we used the pipe to hook the camera up to the recorder, then there's no pipe to hook the recording up to the display either.

If you are enough of a programmer to look at zsoc's service and understand what he's done, if you have messed with gstreamer internals, we will be happy to have your input, here, or in the #webos-internals chat on IRC. If not, then if you want to discuss this in detail, please go read code first, zsoc has had a '''''lot''''' of naive suggestions, and his response is pretty much consistent, that the suggester doesn't understand the problem. Please do not post suggestions in the thread unless you have researched "gstreamer sink."

If you're enough of a programmer to '''fix''' it, the source repository is listed in the article and we will be eternally grateful.

Thanks for your patience.

== Feature Requests ==

* I would like to have Record New moved to the bottom... It's hard to tap it when you have slider open --[[User:En0x|en0x]] 14:21, 24 November 2009 (UTC)
** done --[[User:Prenos|Prenos]] 17:17, 24 November 2009 (UTC)
* Add option to launch video app from precorder --[[User:En0x|en0x]] 17:04, 24 November 2009 (UTC)
**--[[User:Gryn|Gryn]] 22:37, 24 November 2009 (UTC)
*** This is already implemented, will be released in next version --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Way to show how many minutes I recorded? in precorder --[[User:En0x|en0x]] 17:15, 24 November 2009 (UTC)
I have a count up timer planned --[[User:Prenos|Prenos]] 17:18, 24 November 2009 (UTC)
* Flash toggle on main scene? --[[User:En0x|en0x]] 17:21, 24 November 2009 (UTC)
** I looked into this. The whole graphical UI is changing in the next version. This might be a future option still tho --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Have it show the estimated video recording time remaining based on free space in the /media/internal --[[User:Cryptk|Cryptk]] 18:45, 24 November 2009 (UTC)
**--[[User:ProfJonathan|ProfJonathan]] 19:50, 24 November 2009 (UTC)
*** This isn't practical for a number of reasons, but I'll see if someone else wants to implement it --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Use space on keyboard to start/stop recording --[[User:En0x|en0x]] 19:34, 24 November 2009 (UTC)
**--[[User:ProfJonathan|ProfJonathan]] 19:50, 24 November 2009 (UTC)
*** This is feasable, will consider implemented an API for this option --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
*MP3 audio-only recording, for creating podcasts --[[User:ProfJonathan|ProfJonathan]] 19:52, 24 November 2009 (UTC)
** This will require a minor overhaul of the general video start request, or a new request method. It will be an available option if technically feasable once beta hits --[[User:Prenos|Prenos]] 14:45, 25 November 2009 (UTC)
* Allow user to see what is being recorded just like the camera application where you can see the picture being taken. --[[User:thatdude|thatdude]] 00:04 25 November 2009 (EST)
** Consider this impossible for the moment. Look for version 1.0.0 of Precorder or wait till palm releases their app
*** Would it be possible show the video from the camera while not recording? For example to better frame a shot before pressing record?
* If possible have the interface (main scene) look like the camera application where the bottom left icon would open the video application as a new card, the middle button would start/stop recording, and the right button would turn on the flash on/off on the fly. --[[User:thatdude|thatdude]] 00:08 25 November 2009 (EST)
**You mean more buttons? Some UI changes stated above --[[User:Gryn|Gryn]] 21:51, 25 November 2009 (UTC)
* Allow the launch page to orientate the direction the camera needs to be to record. --Mamouton 11:59 pm 28 November 2009
**Formatting the page to the camera orientation --[[User:Gryn|Gryn]] 15:07, 28 November 2009 (UTC)
* Where do we add 'thanks' ? Here? Well, thanks! Really looking forward to this one (now I'll go and find it. Hopefully .ipk.) [[User:FreeTim|FreeTim]] 11:04, 4 December 2009 (UTC)
* The current .mp4 container the application outputs doesn't allowing the stock Pre video player to scrub through the video [[User:Abyssul|Abyssul]] December 5 2009

== im not a programmer just have an ideah don't hurt me ==

To save ur time (that you can be useing to save my digital life) answer this question.
Is it possible to program the pre to capture things that are occuring on the screen (like the examples on themes ect.) if so then this idea may be of use to you.

This is where i don't want you to hurt me. As when the normal still capture camera is running you see a live (digital) renderring of the world.
(2nd and least possible idea) If that digital information could be copied, captured, or intercepted and saved then video could be possible. (1st most propable idea) Use a patch to capture (most likely low resoloution for speed) images in, rappid succession, of the screan while the normal pre camera is displaying on the screan.

I realize that these ideas may be just that and is completely different from the pre-corder, but i do hope that this idea is truely considered and inspires an even better idea.

Fingers Crossed O_o

Me

GStreamer has a Tee tool. That takes in one stream and splits it in two (if that helps)

example and explanation from http://www.vidarholen.net/contents/blog/?p=5

gst-launch-0.10 v4l2src ! tee name=videoout ! queue ! videorate ! video/x-raw-yuv,fps=15 ! queue ! theoraenc quality=60 ! queue ! muxout. pulsesrc ! audio/x-raw-int,rate=22000,channels=1,width=16 ! queue ! audioconvert ! vorbisenc ! queue ! muxout. oggmux name=muxout ! filesink location=lulz.ogg videoout. ! queue ! ffmpegcolorspace ! ximagesink

#Get a v4l2 video source, split it and put one end though a
#theora codec and send the other to videoout (defined later)
v4l2src ! tee name=videoout ! queue ! videorate ! video/x-raw-yuv,fps=15 \
! queue ! theoraenc quality=60 ! queue ! muxout.

#Get audio from a pulseaudio stream, run it through the vorbis encoder
pulsesrc ! audio/x-raw-int,rate=22000,channels=1,width=16 \
! queue ! audioconvert ! vorbisenc ! queue !muxout.

#Mux the audio and video together, and put it in "media.ogg"
oggmux name=muxout ! filesink location=media.ogg

#Put the other end of the video split out on the screen
videoout. ! queue ! ffmpegcolorspace ! ximagesink

Application:Precorder

2009-11-28T16:52:52Z

Abyssul:

{{application
|name=Precorder
|type=webOS
|version=Version: Alpha 0.3.0 (26 Nov 2009)
|tag=Utilities
|screenshot=Precorder_2009-24-11_164136.png
|description=

== Summary ==

Precorder has been developed to bridge the gap between the current revision of WebOS and a future release that will enable video recording. It is capable of recording in multiple combinations of audio and video and includes support for using the built-in LED for lumination while recording in dark areas. Video recorded with Precorder is viewable through Palms built in video application.

== Status ==

Precorder is ALPHA SOFTWARE developed primarily by ZSoc of WebOS Internals with assistance from a number of other developers (as listed in the Maintainers field in the package metadata).

It does not have a viewfinder, cause we technically do not know how to do that (yet?).

== Recent Changes ==

Even though Precorder in alpha state is not available for download in Preware (it will be when it goes into beta), once you install Precorder it appears in the Installed Packages section and you can see the package changelogs there.

== Donations ==

Please see the official PreCentral thread first post at http://forums.precentral.net/2059462-post1.html for the donation link. Since this is a wiki that anyone can edit, we do not put the donation link here.

==Installation==

Note that you cannot install the packages using any other method than the methods below. Specifically, fileCoaster is not able to install these packages.

=== Preware ===

Precorder will be added to Preware once it reaches beta status. Until then, please use the Precorder bootstrap script.

=== Bootstrap Script ===

The easiest (and guaranteed to always be up to date) method of installing the latest packages via the precorder bootstrap script.

Just run the following two commands on your Pre. You can get a command line either via the Terminal application in Preware, or by an SSH connection, or by using the Linux commandline window in WebOS Quick Install. The precorder bootstrap can also be re-run at any time to safely update Precorder to the latest alpha testing version.

 
wget http://bit.ly/precorder-bootstrap
 
sh precorder-bootstrap

=== WebOS Quick Install ===

If you can't use the precorder bootstrap script for some reason, you can also use the following links to download the individual packages and install them with WebOS Quick Install. Note that these links will quickly get out of date, so please use the precorder bootstrap to always get the latest alpha testing version.

Note that to be able to use WebOS Quick Install to install Precorder, you must first have installed Preware on your device. See http://install.preware.org for instructions on how to do that. When Precorder reaches beta status, you will be able to install, update and remove the packages directly in Preware.

You can install the [http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.2.3_armv7.ipk GstService] and [http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.2.3_all.ipk Precorder] ipkg files with [http://www.webos-internals.org/wiki/Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method WebOS Quick Install]. (Note that these links may be out of date if we forget to update them every time we release a new version)

# Save the gstservice and and Precorder ipk's to your local computer.
# Install [[Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method|WebOS Quick Install]]
# Drag the gstservice IPK into the center of the WebOS Quick install window.
# Click the Install button.
# Drag the Precorder application ipk into the center of the WebOS Quick Install window.
# Click the install button.

== License ==

The GStreamer Service package is MIT Open Source licensed. The Precorder application is GPLv2 Open Source licensed.

== Operating notes ==

When precorder is first launched you will see the main screen. Only one button is currently functional. Tapping the 'Record Now' button will begin recording video to the /media/internal location on the pre making these videos available to be copied via USB. They will be located in the root of the USB drive when connected to your computer.
=== Viewfinder ===
Note that you are not able to see the video as it is recording. There is no viewfinder. It is currently technically infeasible to create a viewfinder (but maybe someone will work out how to do it). (For a description of why it is technically infeasible, and to make suggestions, ask questions, please see [http://www.webos-internals.org/wiki/Application_talk:Precorder#Viewfinder_discussion this section in the discussion page].)
=== Controls ===
When you tap the 'Record Now' button the screen will change to notify you that Precorder is currently capturing audio and video. There is a 'Stop recording' button located on the screen. Tapping this button stops the audio/video capture and returns you to the main view.
=== Customization ===
There are several features of Precorder that can be customized. All of these settings are available via the preferences option within the Precorder menu. The table below lists all possible preferences. Options in bold represent defaults.

<Table><TR><TD>
{{{!}} border="1" cellpadding="4"
{{!}}Option
{{!}}Description
{{!}}Possible Selections
{{!}}-
{{!}}Audio Format
{{!}}Select what format you would like the audio stream to be saved in.
{{!}}'''AAC''', AMRNB, MP3
{{!}}-
{{!}}Video Format
{{!}}Select what format you would like the video stream to be saved in.
{{!}}Mpeg-4, H.263, '''H.264/AVC'''
{{!}}-
{{!}}Container
{{!}}Select what multimedia container the audio/video streams will be in.
{{!}}'''mp4''', 3gp
{{!}}-
{{!}}Media Source
{{!}}What would you like Precorder to capture?
{{!}}Audio only, Video only, '''Both'''
{{!}}-
{{!}}Flash
{{!}}Would you like to use the built in LED for illumination?
{{!}}'''Off''', Low, Medium, High
{{!}}}
</TD></TR></Table>

=== Recent enhancements ===

'''0.3.0'''
*LED brightness now selectable
*Launch button added to launch video player
*Videos now are saved in /media/internal/video

'''0.2.3'''
*fixed css bug (correctly pushing the record button to the bottom of the screen)
*added icon for launcher

=== Known bugs ===

Precorder is currently in Alpha stages and as such is in a constant state of flux with new features being added and old functionality being modified. Please use this software at your own risk. Due to the alpha nature of the software, please check the discussion page for a more accurate list of bugs and/or feature requests.

*First run on any phone will cause a blank output.
**Simply start recording, wait a moment, and stop recording, wait a moment. After that, it should be fine.

*Getting the video light to work may cause 2 starts. Should be a 1-time-only process.
*2 minute limitation of recording. Once the video hits 2 minutes, the video data is lost and outputs a blank file.

== Source Code ==

Source at git.webos-internals.org

Packages in the webos-internals testing feed

== Screenshots ==

[[Image:Precorder_2009-24-11_164136.png|alt=Precorder Main View|This is the initial view upon launching Precorder]]
[[Image:Precorder_2009-24-11_164140.png|alt=Precorder Recording View|This is the display during audio/video capture]]
[[Image:Precorder_2009-24-11_164128.png|alt=Precorder Preferences View|This is the preferences selection screen]]
[[Image:Launcher_2009-24-11_164206.png|alt=Palm OEM video app|All videos are viewable on the device via the Palm OEM video application]]

}}

Application:Precorder

2009-11-28T16:52:22Z

Abyssul:

{{application
|name=Precorder
|type=webOS
|version=Version: Alpha 0.2.3 (25 Nov 2009)
|tag=Utilities
|screenshot=Precorder_2009-24-11_164136.png
|description=

== Summary ==

Precorder has been developed to bridge the gap between the current revision of WebOS and a future release that will enable video recording. It is capable of recording in multiple combinations of audio and video and includes support for using the built-in LED for lumination while recording in dark areas. Video recorded with Precorder is viewable through Palms built in video application.

== Status ==

Precorder is ALPHA SOFTWARE developed primarily by ZSoc of WebOS Internals with assistance from a number of other developers (as listed in the Maintainers field in the package metadata).

It does not have a viewfinder, cause we technically do not know how to do that (yet?).

== Recent Changes ==

Even though Precorder in alpha state is not available for download in Preware (it will be when it goes into beta), once you install Precorder it appears in the Installed Packages section and you can see the package changelogs there.

== Donations ==

Please see the official PreCentral thread first post at http://forums.precentral.net/2059462-post1.html for the donation link. Since this is a wiki that anyone can edit, we do not put the donation link here.

==Installation==

Note that you cannot install the packages using any other method than the methods below. Specifically, fileCoaster is not able to install these packages.

=== Preware ===

Precorder will be added to Preware once it reaches beta status. Until then, please use the Precorder bootstrap script.

=== Bootstrap Script ===

The easiest (and guaranteed to always be up to date) method of installing the latest packages via the precorder bootstrap script.

Just run the following two commands on your Pre. You can get a command line either via the Terminal application in Preware, or by an SSH connection, or by using the Linux commandline window in WebOS Quick Install. The precorder bootstrap can also be re-run at any time to safely update Precorder to the latest alpha testing version.

 
wget http://bit.ly/precorder-bootstrap
 
sh precorder-bootstrap

=== WebOS Quick Install ===

If you can't use the precorder bootstrap script for some reason, you can also use the following links to download the individual packages and install them with WebOS Quick Install. Note that these links will quickly get out of date, so please use the precorder bootstrap to always get the latest alpha testing version.

Note that to be able to use WebOS Quick Install to install Precorder, you must first have installed Preware on your device. See http://install.preware.org for instructions on how to do that. When Precorder reaches beta status, you will be able to install, update and remove the packages directly in Preware.

You can install the [http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.2.3_armv7.ipk GstService] and [http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.2.3_all.ipk Precorder] ipkg files with [http://www.webos-internals.org/wiki/Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method WebOS Quick Install]. (Note that these links may be out of date if we forget to update them every time we release a new version)

# Save the gstservice and and Precorder ipk's to your local computer.
# Install [[Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method|WebOS Quick Install]]
# Drag the gstservice IPK into the center of the WebOS Quick install window.
# Click the Install button.
# Drag the Precorder application ipk into the center of the WebOS Quick Install window.
# Click the install button.

== License ==

The GStreamer Service package is MIT Open Source licensed. The Precorder application is GPLv2 Open Source licensed.

== Operating notes ==

When precorder is first launched you will see the main screen. Only one button is currently functional. Tapping the 'Record Now' button will begin recording video to the /media/internal location on the pre making these videos available to be copied via USB. They will be located in the root of the USB drive when connected to your computer.
=== Viewfinder ===
Note that you are not able to see the video as it is recording. There is no viewfinder. It is currently technically infeasible to create a viewfinder (but maybe someone will work out how to do it). (For a description of why it is technically infeasible, and to make suggestions, ask questions, please see [http://www.webos-internals.org/wiki/Application_talk:Precorder#Viewfinder_discussion this section in the discussion page].)
=== Controls ===
When you tap the 'Record Now' button the screen will change to notify you that Precorder is currently capturing audio and video. There is a 'Stop recording' button located on the screen. Tapping this button stops the audio/video capture and returns you to the main view.
=== Customization ===
There are several features of Precorder that can be customized. All of these settings are available via the preferences option within the Precorder menu. The table below lists all possible preferences. Options in bold represent defaults.

<Table><TR><TD>
{{{!}} border="1" cellpadding="4"
{{!}}Option
{{!}}Description
{{!}}Possible Selections
{{!}}-
{{!}}Audio Format
{{!}}Select what format you would like the audio stream to be saved in.
{{!}}'''AAC''', AMRNB, MP3
{{!}}-
{{!}}Video Format
{{!}}Select what format you would like the video stream to be saved in.
{{!}}Mpeg-4, H.263, '''H.264/AVC'''
{{!}}-
{{!}}Container
{{!}}Select what multimedia container the audio/video streams will be in.
{{!}}'''mp4''', 3gp
{{!}}-
{{!}}Media Source
{{!}}What would you like Precorder to capture?
{{!}}Audio only, Video only, '''Both'''
{{!}}-
{{!}}Flash
{{!}}Would you like to use the built in LED for illumination?
{{!}}'''Off''', Low, Medium, High
{{!}}}
</TD></TR></Table>

=== Recent enhancements ===

'''0.3.0'''
*LED brightness now selectable
*Launch button added to launch video player
*Videos now are saved in /media/internal/video

'''0.2.3'''
*fixed css bug (correctly pushing the record button to the bottom of the screen)
*added icon for launcher

=== Known bugs ===

Precorder is currently in Alpha stages and as such is in a constant state of flux with new features being added and old functionality being modified. Please use this software at your own risk. Due to the alpha nature of the software, please check the discussion page for a more accurate list of bugs and/or feature requests.

*First run on any phone will cause a blank output.
**Simply start recording, wait a moment, and stop recording, wait a moment. After that, it should be fine.

*Getting the video light to work may cause 2 starts. Should be a 1-time-only process.
*2 minute limitation of recording. Once the video hits 2 minutes, the video data is lost and outputs a blank file.

== Source Code ==

Source at git.webos-internals.org

Packages in the webos-internals testing feed

== Screenshots ==

[[Image:Precorder_2009-24-11_164136.png|alt=Precorder Main View|This is the initial view upon launching Precorder]]
[[Image:Precorder_2009-24-11_164140.png|alt=Precorder Recording View|This is the display during audio/video capture]]
[[Image:Precorder_2009-24-11_164128.png|alt=Precorder Preferences View|This is the preferences selection screen]]
[[Image:Launcher_2009-24-11_164206.png|alt=Palm OEM video app|All videos are viewable on the device via the Palm OEM video application]]

}}

Patch Launcher Unhide the DeveloperMode App

2009-08-04T06:10:49Z

Abyssul: /* Patching Process */

{{template:patch}}
==Introduction==

This patch will save you the time of not having to type out the code to access the developer mode icon to turn on and off developer mode. After following the steps here you will find the developer mode icon will appear at the bottom of the first page of the launcher.

==Editing Process==

1. Root your Pre. (Follow the [[Portal:Accessing_Linux | Accessing Linux tutorial]] for instructions on how to do this.)

2. SSH in. (Follow [[Next_steps | the Optware Package Feed tutorial]] to install and enable SSH on your phone.)

3. Type in sequence:
<source lang="bash">
sudo mount -o remount,rw /
sudo vi /usr/palm/applications/com.palm.app.devmodeswitcher/appinfo.json
</source>

4. Change the line that says (press 'i' in vi to insert/edit text)
<pre><nowiki>
"visible": false
</nowiki></pre>

to
<pre><nowiki>
"visible": true
</nowiki></pre>

5. Press ESC to exit insert mode, and save and quit vi by typing ':x' (without quotes).

Remount the file system as readonly:
<source lang="bash">
sudo mount -o remount,ro /
</source>

6. Restart your Pre.

==Patching Process==

This patch appear in the webos-internals gitorious repository [[Applying Patches]] but the patch application will not work with 1.1. However following the editing steps above does work.

Patch Phone Edit Dialer Theme

2009-07-25T04:20:39Z

Abyssul: /* Installing the new Dialer Theme */

[[Image:Edit-dialer-theme.png|right]]

This page is for info about changing the theme of the Dialer Application. It is still in development, so please correct any errors.

This guide involves much the same process as demonstrated in the tutorial on [[background-editing|changing the background]].
Most of the text here has been borrowed from that article, as it is written very well.

------

=Installing the new Dialer Theme=

The theme I (Jwborc39963 [palmkernel on IRC]) created is shown to the right. You can download the files I modified [http://www.megaupload.com/?d=ZO2HSPJT here]

Another theme made by Abyssul (on IRC and PreCentral.net). Similar to Jwborc39963, but blue instead of green:
 
[http://i35.photobucket.com/albums/d182/hardwick246/phone_2009-25-07_001356.jpg Screenshot]
 
[http://www.mediafire.com/?sharekey=76a711c2d92272025a3d773badf21430e04e75f6e8ebb871 Theme Download]

This guide assumes that you have already [[Portal:Accessing_Linux | rooted]] your phone.

==STEP ONE:==

Open the SSH session and we'll open this directory (cd - change directory) and look at it's contents (ls - listing)
<pre><nowiki>
cd /usr/palm/applications/com.palm.app.phone/images/
ls
</nowiki></pre>

==STEP TWO:==

You'll see a long list of files that are in this directory.
We'll backup the current images to the USB accessible storage first in case we need to revert back to them (cp - copy)

<pre><nowiki>
cp /usr/palm/applications/com.palm.app.phone/images/dialpad-backspace.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/address-book.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/dialpad-row4dtmf.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/dialpad-row4.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/dialpad-row3dtmf.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/dialpad-row3.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/dialpad-row2dtmf.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/dialpad-row2.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/dialpad-row1dtmf.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/dialpad-row1.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/list-section-line.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/backdrop-phone-scroll-fade.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/backdrop-phone.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-dtmfpad.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-call-log.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-voicemail.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-dtmfpad.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-contactbook.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-addcall.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-addcontact.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-mute.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-redial.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-sms.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-speaker.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-speaker-bluetooth.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-speaker-external.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-speaker-internal.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-icon-unlock.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-popup-bluetooth.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-popup-bluetooth-headset.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-popup-bluetooth-headset-tty.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-popup-bluetooth-internal.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/menu-popup-bluetooth-speaker.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/missed-call-background.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/popup-icon-dropped.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/popup-icon-error.png /media/internal/
cp /usr/palm/applications/com.palm.app.phone/images/popup-icon-missed.png /media/internal/
</nowiki></pre>

==STEP THREE:==

Now click on the USB icon on the Pre's notification area, and switch to USB Storage mode.

You can now copy the files off of the Pre and edit them any way you want, just make sure they have the same properties as the orig (transparency, file extention, etc). The 'background editing' article mentions to keeps these files the same size, however I did not and the phone still worked. I already created a theme (the one pictured above) and will upload the images later today. I changed the colors on the buttons using paint.net and the 'change color' brush. It was time consuming, but I think it was worth it.

Once they are edited to your liking, copy the files back to the Pre in USB mode with the same file name.

Edit & Discussion (by ultraBlack): It might be easier to use [[Setup_SFTP|SFTP]] to do this.

<pre><nowiki>
popup-icon-missed.png
popup-icon-error.png
popup-icon-dropped.png
missed-call-background.png
menu-popup-bluetooth-speaker.png
menu-popup-bluetooth-internal.png
menu-popup-bluetooth-headset-tty.png
menu-popup-bluetooth-headset.png
menu-popup-bluetooth.png
menu-icon-unlock.png
menu-icon-speaker-internal.png
menu-icon-speaker-external.png
menu-icon-speaker-bluetooth.png
menu-icon-speaker.png
menu-icon-sms.png
menu-icon-redial.png
menu-icon-mute.png
menu-icon-addcontact.png
menu-icon-addcall.png
menu-icon-contactbook.png
menu-icon-dtmfpad.png
menu-icon-voicemail.png
menu-icon-call-log.png
menu-icon-dtmfpad.png
backdrop-phone.png
backdrop-phone-scroll-fade.png
list-section-line.png
dialpad-row1.png
dialpad-row1dtmf.png
dialpad-row2.png
dialpad-row2dtmf.png
dialpad-row3.png
dialpad-row3dtmf.png
dialpad-row4.png
dialpad-row4dtmf.png
address-book.png
dialpad-backspace.png
</nowiki></pre>

==STEP FOUR:==

Eject your Pre from your computer, wait for WiFi to log back into your network, and SSH into the Pre again. Your old window probably timed out by now, so you can close it.
We'll need to get the files back to the correct location, so we'll use the copy (cp) command to do this.

<pre><nowiki>
cp /media/internal/popup-icon-missed.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/popup-icon-error.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/popup-icon-dropped.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/missed-call-background.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-popup-bluetooth-speaker.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-popup-bluetooth-internal.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-popup-bluetooth-headset-tty.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-popup-bluetooth-headset.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-popup-bluetooth.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-unlock.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-speaker-internal.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-speaker-external.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-speaker-bluetooth.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-speaker.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-sms.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-redial.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-mute.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-addcontact.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-addcall.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-contactbook.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-dtmfpad.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-voicemail.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-call-log.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/menu-icon-dtmfpad.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/backdrop-phone.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/backdrop-phone-scroll-fade.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/list-section-line.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/dialpad-row1.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/dialpad-row1dtmf.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/dialpad-row2.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/dialpad-row2dtmf.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/dialpad-row3.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/dialpad-row3dtmf.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/dialpad-row4.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/dialpad-row4dtmf.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/address-book.png /usr/palm/applications/com.palm.app.phone/images/
cp /media/internal/dialpad-backspace.png /usr/palm/applications/com.palm.app.phone/images/
</nowiki></pre>

Once this is done, exit the SSH session (type 'exit') and reboot the Pre from the Device Info menu. When it comes back up you should see your new theme on the dialpad screen.

------

Edit: Wouldn't this be a million times easier with wildcards?
Edit: Also might suggest creating a folder in /media/internal rather than putting all this stuff in the root dir. Could get messy. Also if you use a hidden dir on /media/internal I think it will prevent the images from showing up in the photo browser on the phone. Maybe add "mkdir /media/internal/.theme/" and "mkdir /media/internal/.theme/dialer".

Please feel free to edit this page if you think something can be done better. This is how I did it, and I figured people could copy/paste into terminal/PuTTY, however if you see something that you think can be done better in this tutorial, please edit it for the better!

Sorry, my mistake. The change needs to be redone in 1.0.3, but it does work correctly after redoing it. -jhoff80