WebOS Internals - User contributions [en]

Talk:Next steps

2010-01-18T18:52:53Z

Hparsons: /* Palm Pixi Differences? */

This script method does not seem to account for accessing SSH via USB instead of EVDO or Wifi. I don't believe it sets up the firewall correctly to allow USB0. --[[user:SagaciousB|SagaciousB]]

AND WHERE EXACTLY DO I TYPE THIS INTO? WHAT PROGRAM, IF IN CMD WINDOW, WHERE? - [[User:Srlake314|Srlake314]]

I edited the article to include a link to info re: getting the bash correct: "Only the default shell (/bin/ash) will work for ssh. To change your shell to bash (located in /opt/bin/bash after the install), you will have to [http://www.webos-internals.org/wiki/Setup_Bash create] an /etc/shells file, and add the following lines:" [[User:superduperpre|superduperpre]]

When tring to run optware-bootstrap.sh I never get prompted to enter a username. --[[User:Alansned|alansned]] 18:28, 2 October 2009 (UTC)

== Uninstallation before update requirements? ==

I do not see how to uninstall. It appears to me that the Optware instalation should be safe to leave installed as implied by the "we use /opt so as not to be overwritten by an update" statement. Are the Quilt installation steps mentioned here also safe to leave applied during a WebOS update? It does sound like patches and tweaks installed by quilt should be removed prior to an update. If the command `cd / ; quilt applied` found at [[Applying_Patches#Listing_Applied_Patches]] reports that no patches are applied is it safe for an update?

So, If I am correct in my assumptions above then everything found in /opt is safe to leave in place during an update. But perhaps things outside that folder are not? For example I've configured dyndns per [http://palmpre-hacks.com/palm-pre-hacks/how-to-ssh-into-your-palm-pre/] which required a new boot script named ''/etc/ppp/ip-up.d/09update-ddns'', would this cause problems. Similarly per [http://palmpre-hacks.com/palm-pre-hacks/how-to-set-up-google-gps-tracking-on-your-palm-pre/] installing a lighttp service requires the addition of a ''/etc/event.d/optware-lighttpd'' script, would this also cause WebOS update problems?

Thank you for any insights you might have, delaying my 1.2 update till I feel more confident... --[[User:Dolio|Dolio]] 06:49, 1 October 2009 (UTC)

: So I did the 1.2.0 update and it appears that everything I described above was fine including the ddns and lighttpd additions which I left in place during the update. I also performed the 1.2.1 update which initially appeared to be fine, but since then I have been prompted to install the 1.2.1 update multiple times. At this point I have installed the 1.2.1 update at least 3 times and have finally chosen to ignore it by [[Blocking_Updates]] until I figure out what's going on. Oddly enough I believe that after the 1.2.0 update I was still able to ssh into my Pre ''(I could be mistaken)'', but I am sure that the 1.2.1 update is overwriting the password file as I have to use the usb console to add my user after each update. Anyway, that's all neither here not there and I just thought I would let anyone reading this know how things turned out after being spooked by the great [http://forums.precentral.net/palm-pre/205670-palm-profile-login-problems-4.html#post1930274 palm-profile-login-problems] during the initial 1.2.0 update push. --[[User:Dolio|Dolio]] 22:29, 20 October 2009 (UTC)

== Changing Package Installation Target folder ==

Is there any way to tell ipkg-opt not to install packages in the application partition? The packages eat up a lot of space there, getting in the way with installing more apps... --[[User:Phil|Phil]] 10:32, 5 November 2009 (UTC)

: I have not tried this but I suspect you could move the folder to another location and then create a symlink from it's original location. For example this will make a symlink in your home folder named internal.media '''ln -s /media/internal/ ~/internal.media'''. It could be dangerous to move things like bin folders because once moved you might find that you can no longer run those commands (Shrugs)... --[[User:Dolio|Dolio]] 11:22, 7 November 2009 (UTC)

== Palm Pixi Differences? ==
I've run the script (previously optware-bootstrap.sh and now optware-bootstrap-manual.sh) several times on my Pre after running WebOS Doctor, and it's always worked; however, I've tried running it on my wife's Sprint Pixi, and it did not. I chose the WiFi only option, but I'm suspecting the issue has something to do with that. ==15:01, 18 January 2010) [[User:Hparsons|Hparsons]]
: Sprint Pixi, (not the verison pixi+) has no wifi. [[User:Rboatright|rboatright]] 15:49, 18 January 2010 (UTC)
:: Sorry, I mistyped. I enabled EVDO only, but still no connectivity.--[[User:Hparsons|Herb]] 18:52, 18 January 2010 (UTC)

Talk:Next steps

2010-01-18T15:01:15Z

Hparsons:

Update 1.3.5

2009-12-30T16:42:31Z

Hparsons:

Put all information about Update 1.3.5 here, including changes made, current development ideas, etc.

== Disabled ==
No information at this time

== New Applications ==
No information at this time

== Feature changes to existing applications ==
Update 1.3.5 has several add and updated items:

=== App Catalog ===
* App Catalog significantly improves the application download experience.
* A user can now download multiple applications simultaneously.
* Downloads continue in the background if the user moves away from the download screen.
* A user can manually pause, resume, and cancel downloads.
* A user can also download all available updates for the user’s downloaded applications with a single tap.
* App Catalog automatically resumes downloads in cases where a download was paused because it was interrupted—for example, if a user moves out of network coverage and then moves back into coverage.
* Users can now take advantage of the full storage capacity of the phone for downloading applications. This gives the user more control over how to allocate the phone’s storage space across applications, music, photos, and other media. Downloaded applications are now stored on the phone’s USB drive.
* App Catalog lists search results based on an improved search algorithm.
* Locations from which users can purchase paid apps from App Catalog now include U.S. territories.

=== Calendar ===
* In Day view, switching between days happens more quickly.

=== Date & Time ===
* When the user has network time zone enabled, a city and country are no longer displayed.

=== Device Info ===
* A user can perform a full erase by pressing and holding Sym + the orange/Option key + power for 10 seconds.

=== Email ===
* A user can now edit forwarded text for all email account types.
* When the user sets up more than one Yahoo! email account, the account names displayed in Account List view include the associated email address so that the user can distinguish them.
* If an account mailbox is too full to send messages, after the user frees up space in the mailbox on the server, the user can send the messages successfully.
* The default email signature no longer includes the macron over the “e” in “Pre,” so that the product name shows correctly on a recipient’s phone.

=== Messaging ===
* If a user deletes a conversation with a contact, new conversations with that contact are now correctly displayed in Conversations view..

=== Screen & Lock ===
* When the screen is locked, the time displays in a new font.

=== Sprint Navigation ===
* A user can launch Sprint Navigation from an address in an open contact entry in Contacts.

=== System ===
* Users can now take advantage of the full storage capacity of the phone for downloading applications. This gives the user more control over how to allocate the phone’s storage space across applications, music, photos, and other media. Downloaded applications are now stored on the phone’s USB drive.
* This update improves battery life in areas of poor wireless network coverage.
* If the user is working in an application that supports landscape mode (such as Web or Videos), notifications now appear at the bottom of the landscape screen.
* After a user signs in to an existing Palm profile, applications the user installed from App Catalog are restored in the background. The user can use other features of the phone while the apps are being restored.
* Swiping to delete a list item that contains a link no longer causes the link to open in the web browser.

=== Updates ===
* After taking the 1.3.5 update, users can download future updates over a 2G (1xRTT , GPRS , EDGE ) data connection by opening Updates and tapping Download Now.

=== Web ===
* The web browser now supports the display of animated GIFs.
* Audio files with a .3g2 extension play correctly as audio files, not video files.

== Security ==
* This release includes a security fix to the dev portal. Credit to Kris Siegal for reporting the issue.

== Troubleshooting ==
No information at this time

== Package Manifest ==
Not listed at this time

Feel free to annotate, delete, or move this info elsewhere in the wiki as desired.

Update 1.3.5

2009-12-30T16:31:49Z

Hparsons:

Put all information about Update 1.3.5 here, including changes made, current development ideas, etc.

Feel free to annotate, delete, or move this info elsewhere in the wiki as desired.

Update 1.3.5

2009-12-30T16:31:34Z

Hparsons: New page: Put all information about Update 1.3.1 here, including changes made, current development ideas, etc. Feel free to annotate, delete, or move this info elsewhere in the wiki as desired.

Put all information about Update 1.3.1 here, including changes made, current development ideas, etc.

Feel free to annotate, delete, or move this info elsewhere in the wiki as desired.

Portal:Patches to webOS

2009-12-30T16:29:07Z

Hparsons:

__notoc__
{{portal-header
|If you need info on how to properly update webOS, see [[Portal:Updating webOS Versions|Updating webOS Versions]].

'''<nowiki>***THIS PAGE IS OUT OF DATE, PLEASE HELP IN REORGANIZING IT***</nowiki>'''This page lists patches to webOS existing apps which modify the behavior as shipped. '''Note''' that these patches may be version specific and may be broken by future webOS updates. Proceed with caution. If you get one that works please move it under the correct column, alphabetically, and title the page:
'''"Patch [application] [description]"''' (for application specific patches) <br>
'''"Patch webOS [description]"''' (for patches not part of a specific application)<br>

Each page should contain at least the basic headings
*1. '''Introduction''': A brief description to introduce people to the patch.
**1.1 '''Usage''':An explanation if it is needed on how to use the modification see Add/Delete Pages in the Launcher as an example.
*2. '''Editing Process''': Step by step instructions to manually edit.
*3. '''Patching Process''': Details for making the edits with a patch file and pointing people to the [[Applying Patches]] page if the patch is also provided in the webos-internals gitorious repository.

For patches that aren't listed here you'll also want to check out the gitorious repository at http://gitorious.org/webos-internals/modifications/trees/master

Please refer to '''[[MIT_Open_Source_License_-_webOS-Patches| MIT Open Source License - webOS-Patches]]''' for important information regarding patches and licensing.
}}

{{portal-three-columns
|column1=
===webOS Update Information===
* [[Update 1.3.5|Update 1.3.5]]
* [[Update 1.3.1|Update 1.3.1]]
* [[Update 1.2.1|Update 1.2.1]]
* [[Update 1.2.0|Update 1.2]]
* [[Update 1.1.0|Update 1.1]]
* [[Update 1.0.4|Update 1.0.4]]
* [[Update 1.0.3|Update 1.0.3]]

===Patches that Need Work===
* [[Bugs]]

|column2=
===Patch Ideas to be Created or in Progress===

* [[More_Calculator_Functions|Accessing additional built-in calculator functions]]
* [[Add_Ability_To_Choose_Snooze_Length|Add Ability to Choose Snooze Length]]
* [[Add_Icon_To_Quick_Launcher|Add an icon to the quick launcher]]
* [[Changing Clipboard Data From The Shell|Changing Clipboard Data from the Shell]]
* [[Development_%26_Tweak_Ideas | Development & Tweaking Ideas]]
* [[Longer Vibrate|Longer Vibrate]]
* [[Remove/Reduce Drag Radius]]

|column3=
===Notes===
These modifications lack a patch process, please add one to the details to the page and have it added to the webOS-internals gitorious repository. Info for the repository is on [[Applying Patches]].

*Empty
}}
{{portal-three-columns
|column1=
==Current Patches==
===webOS 1.3.1 OK===
* [[Patch Calendar Notification Repeat|Calendar: Notification Repeat]]
* [[Patch Calendar Snooze Duration Selection|Calendar: Snooze Duration Selection]]
* [[Patch Clock Add space between Snooze and Dismiss buttons|Clock: Add space between Snooze and Dismiss buttons]]
* ++[[Patch Enable LED Notifications|Enable LED Notifications]]
* ++[[Patch_Email_Change_Default_Font_for_Replies-Forwards_from_Navy_to_Black|Email: Change default font on replies/forwards from dark blue to black]]
* [[Patch Email DeleteAll|Email: Delete All Read All]]
* [[Patch Email DeleteFromNotificationBar|Email: Delete from notification bar]]
* [[Patch Email Notification Repeat|Email: Notification Repeat]]
* [[Patch Change Carrier String|Change Carrier String]]
* [[Patch Launcher Wrap Pages|Launcher: Wrap Pages]]
* [[Patch Launcher Reset Scroll on Page Change|Launcher: Reset Scroll on Page Change]]
* [[Patch Launcher Reset to First Page|Launcher: Reset to First Page]]
* [[Patch Launcher Reset to Middle Page|Launcher: Reset to Middle Page]]
* [[Patch Messaging Notification Repeat|Messaging: Notification Repeat]]
* [[Patch Phone Notification Repeat|Phone: Notification Repeat]]
* [[Patch webOS Browser: Show All Bookmarks (Not just first 12)]]
* [[Patch webOS Roam Control|Roam Control]]
* [[Patch webOS BypassPINLock]]
===webOS 1.2.1 OK===
* ++[[Patch Browser Global Search Addons|Browser: Global Search Addons]]
* [[Patch Browser Delete Individual History Items|Browser: Delete Individual History Items]]
* [[Patch Calendar Notification Repeat|Calendar: Notification Repeat]]
* [[Patch Calendar Snooze Duration Selection|Calendar: Snooze Duration Selection]]
* [[Patch Clock Add space between Snooze and Dismiss buttons|Clock: Add space between Snooze and Dismiss buttons]]
* [[Patch Clock Enabling the Hidden Theme|Clock: Enabling the Hidden Theme]]
* ++[[Patch Clock Change Alarm Button Order|Clock: Change Alarm Button Order]]
* ++[[Patch Clock Change Alarm Snooze Length|Clock: Change Alarm Snooze Length]]
* [[Patch Camera Easy Shutter Sound Off|Camera: Easy Shutter Sound Off]] - Called: Sound Toggle - Green (and Grey)
** also [[Patch Camera Shutter Sound On-Off Button|Camera: Shutter Sound On-Off Button]]
** also [[Camera Mod Alternate Sound Disable]]
* [[Patch Camera Using Volume Buttons to Take a Picture|Camera: Using Volume Buttons to Take a Picture]]
* [[Patch Email Confirm Deletion|Email: Confirm Deletion]]
* [[Patch Email Change Default Font for Replies-Forwards from Navy to Black|Email: Change Default Font for Replies/Forwards from Navy to Black]]
* [[Patch Email DeleteAll|Email: Delete All Read All]]
* [[Patch Email DeleteFromNotificationBar|Email: Delete from notification bar]]
* [[Patch Email Enable Landscape Viewing|Email: Enable Landscape Viewing]]
* [[Patch Email Notification Repeat|Email: Notification Repeat]]
* [[Patch Launcher Add or Delete Pages|Launcher: Add/Delete Pages]]
* [[Patch Launcher Hide-Delete The NASCAR App|Launcher: Hide/Delete The NASCAR App]]
* ++[[Patch Launcher Hide Media Sync Option|Launcher: Hide Media Sync Option]]
* [[Patch Launcher Unhide the DeveloperMode App|Launcher: Unhide the DeveloperMode App]]
* [[Patch Launcher To Allow More Icons Per Row|Launcher: Allows More Icons Per Row]]
* [[Patch Launcher Wrap Pages|Launcher: Wrap Pages]]
* [[Myavatar In Messaging App|Messaging: Avatar In Messaging App]]
* [[Patch Messaging Character Counter|Messaging: Character Counter]]
* [[Patch Messaging Display Full Status Messages|Messaging: Display Full Status Messages]]
* [[Patch Messaging Change "Enter Key" To Create Newline|Messaging: Change "Enter Key" To Create Newline]]
* [[Patch Messaging Force Offline Send Without Dialog|Messaging: Force Offline Send Without Dialog]]
* [[Patch Messaging Forward Messages|Messaging: Forward Messages]]
* [[Patch Messaging Jump Forward, Backward One Word at a Time|Messaging: Jump Forward, Backward One Word at a Time]]
* [[Patch Messaging Landscape Orientation|Messaging: Landscape Orientation]]
* [[Patch Messaging New Cards For Each Conversation|Messaging: New Cards For Each Conversation]]
* [[Patch Messaging Adding Timestamps to All Received Messages|Messaging: Adding Timestamps to All Received Messages]] - Three Options: Builtin, Clean, and Fancy
* [[Patch Messaging Notification Repeat|Messaging: Notification Repeat]]
* [[Patch Messaging Sounds|Messaging: Message Sound]] - Called SMS Tone Per Contact
* ++[[Patch MediaPlayer Ignore 'A', 'An', and 'The' In Artist and Album names|Music Player: Ignore 'A', 'An', and 'The' in Artist and Album Names]]
* [[Patch PDF Viewer Change Orientation|PDF Viewer: Change Orientation]]
* [[Patch Phone Show Call Duration in the Call Log|Phone: Show Call Duration in the Call Log]]
* [[Patch Phone Disable Various Call Sounds|Phone: Disable Various Call Sounds]]
* [[Patch Phone Notification Repeat|Phone: Notification Repeat]]
* [[Patch Tasks Always Show Details of New Tasks|Tasks: Always Show Details of New Tasks]]
* ++[[Patch Youtube Landscape Orientation|Youtube: Landscape Orientation]]

===webOS Patches===
* [[Patch Enable LED Notifications|Enable LED Notifications]]
* [[On Screen Keyboard]]
* [[Patch webOS Brightness|Brightness]]
* [[Change_the_default_notification.wav_Sound|Change the Default notification.wav Sound]] - use SMS Tone Per Contact
** Also [[Changes_Alert/Notification_Sounds|Changes Alert/Notification Sounds]]
* [[Patch webOS Changing the "Turn off after X" time|Changing the "Turn off after X" Time]]
* [[Patch webOS Disable Charging Event Sounds|Disable Charging Event Sounds]]
* [[Patch webOS Workaround for Touchstone Charging Event Problem|Workaround for Touchstone Charging Event Problem]]
* [[Patch webOS Add Words to AutoCorrect Dictionary|Modify AutoCorrect Dictionary]]
* [[Patch webOS Radio Power Switch|Radio Power Switch]]
* [[Patch webOS Roam Control|Roam Control]]
* [[Patch webOS Show Actual Battery Percentage | Show Actual Battery Percentage]]
* [[Patch webOS Turning Off Dialpad Noise|Turning Off Dialpad Noise]]

|column2=

==Previous Patches==
===webOS 1.2 OK===
++ Indicates needs to be added to the git repository. Please help add them and remove the notation when added.
* ++[[Patch Phone Edit Dialer Theme|Phone: Edit Dialer Theme]]
* [[Patch MediaPlayer Bookmarking|Music Player: Bookmarking]] only works in 1.2.1 podcast, speech, spoken word, netcast, or audiobook genres

===Fixed in 1.2 - No longer needed===
* [[Patch Amazon Download Music over EVDO|Amazon: Download Music over EVDO]]
* [[Patch Browser Downloading Files|Browser: Downloading Files]]

===webOS 1.1 OK===
* [[Patch Calendar Show All-Day Events in Month View|Calendar: Show All-Day Events in Month View]]
* ++[[Patch Camera 10 Second Countdown Timer|Camera: 10 Second Countdown Timer]]
* ++[[Patch Email Change "Running Late" Message|Email: Change "Running Late" Message]]
* ++[[Patch MCraig Enabling Personals Category|mCraig: Enabling Personals Category]]
* ++[[Patch Phone Editing the Lock Screen|Phone: Editing the Lock Screen]]
* ++[[Patch WebOS Bypassing Lock Screen|Unlock: Bypass the Passcode Entry Screen]]

===Fixed in 1.1 - No longer needed===
* [[Patch Email Fix Broken Formatting|Email: Fix Broken Formatting for E-mails]]

===Not 1.1 compatible===
* [[Patch Camera Remote View|Camera: Remote View]]
* [[Patch Email Fix Attachments|Email: Fix Attachments]]
* [[Patch Sudoku Disable Zooming|Sudoku: Disable Zooming]]

===webOS 1.1 OK===
++ Indicates needs to be added to the git repository. Please help add them and remove the notation when added.
* ++[[Patch webOS Boot Themes|Boot Themes]]
* ++[[Patch webOS Bypassing Activation|Bypassing Activation]]
* ++[[Patch webOS CPU Frequency or Voltage Scaling|CPU Frequency or Voltage Scaling]]
* ++[[Patch webOS GPS Tracking|GPS Tracking]]
* ++[[Patch webOS Graphics|Graphics]]
* ++[[Patch webOS Hourly Chime|Hourly Chime]]
* ++[[Patch webOS Keep Phone Awake While in Remote Session|Keep Phone Awake While in Remote Session]]
* [[Patch webOS Logging Information from Within Scripts|Logging Information from Within Scripts]]
* [[Patch webOS Modifying a Stock App While Keeping the Original|Modifying a Stock App While Keeping the Original]]
* ++[[Patch webOS Random Wallpaper Switching|Random Wallpaper Switching]]
* [[Patch webOS Reverse Tunnel|Reverse Tunnel]]
* [[Screenlock On When Connected|Stay On While Connected]]
* [[Make USB Partition Writable via SFTP|Make USB Partition writable via SFTP]]

===Fixed in 1.1 - No longer needed===
* Empty

===Not 1.1 compatible===
* [[Patch webOS Email App Patch to Prompt for IPK Installation|Email App Patch to Prompt for IPK Installation]]

|column3=
==== The following have not been checked for compatibility with webOS 1.1. ====
* [[Browser_Plugins|Browser Plugins]]
* [[Photos Slideshow|Photos Slideshow]]

==== The following are deprecated. They have been replaced with methods which are easier or are moot in 1.1 ====

* [[Installing Homebrew Apps With A Rooted Pre|Installing Homebrew Apps With A Linux Accessed Pre]]
* [[Packaging Homebrew Apps for Stock Pre without Rooting|Packaging Homebrew Apps for Stock Pre without Accessing Linux]]
* [[Modifying Stock Applications|Modifying Stock Applications]]

}}

Next steps

2009-12-30T14:45:47Z

Hparsons:

{{deprecated|
If all you want to do is install an SFTP server, then just go to the Optware section in [[Preware]] and install it from there. Then go to the OpenSSH package homepage and read the instructions there to create an SSH key for use when accessing your phone via ssh or sftp.
}}

=Automated Setup of Optware, Users and Access=
The webOS community asks that users who have obtained access to the Linux subsystem install a standard set of software to ensure everyone has the necessary tools in place to use the resources the community is providing.

In particular, this includes the Optware package manager. Palm's webOS uses the ''ipkg'' package manager internally. The community has a version of ''ipkg'' called ''ipkg-opt'' which accesses the Optware library of over 1300 Linux programs available for installation on the Pre.

Palm has indicated that they have no intention of using the /opt directory, so we direct our installs to /opt/bin rather than /bin to avoid being overwritten by future Palm software upgrades.

In addition, the standard package creates a non-root user, installs ''sudo'', and includes a SSH program (''Dropbear'') and SFTP program.

For your convenience, we've packaged all this up into a simple script.

==Optware Setup (Manual)==

===Installing Optware in the Emulator?===
If you're attempting to install these packages to your emulator, you must first add sufficient space by [[Adding_Disks_to_the_Emulator|enabling a virtual disk]].

After completing the process of obtaining access to your Pre, do the following:

'''Type each line exactly as it appears. Copying and pasting is probably a good idea.'''
''' This is confirmed to work with webOS 1.3.1 '''
''Note to Windows Putty users: To paste in putty, simply right-click and the program pastes into the terminal whatever you have copied to the clipboard.''

<div style="font-size:100%;">
<source lang=bash>
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/optware-bootstrap-manual.sh
chmod 755 ./optware-bootstrap-manual.sh
sh optware-bootstrap-manual.sh
source /etc/profile.d/optware
</source></div>

Follow the on-screen instructions.

If you want to review the script before you run it, you can look here:

[http://gitorious.org/webos-internals/bootstrap/blobs/master/optware-bootstrap.sh http://gitorious.org/webos-internals/bootstrap/blobs/master/optware-bootstrap.sh]

Note that using the WiFi connection for the above steps is to be highly recommended over the 3G or GSM options, which are reported as sometimes failing. (Turn on aeroplane mode then turn on and connect to WiFi)

As part of this process, you will be creating an unprivileged user account that you can later use to log in to your device. The username that you pick must be lowercase, longer than 3 characters, contain at least one letter, and may only be letters, numbers, dashes (-), and underscores (_). Once you enter your username, you will enter a password. Make sure to pick a strong password for your own security. If you make a typo when entering your password, don't panic. Once the script has finished running, simply type:

<div style="font-size:100%;">
<source lang=bash>
passwd username
</source></div>

"username" should, of course, be the username that you created. This will allow you to re-enter your password correctly.

==Quilt setup==

Optionally, you can then install the ''quilt'' patch manager which allows multiple-file patches. (Yes, the pun was intentional. Quilt manages multiple patches.) This installation process has also been packaged into a simple script. It will install quilt, and all of its dependencies, and create a local clone of the WebOS-Internals patch repository. [[Applying_Patches | Applying Patches]] provides a more thorough guide on the use of quilt.

'''Again, type each line exactly as it appears. Copying and pasting is probably a good idea.'''

<div style="font-size:100%;">
<source lang=bash>
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/quilt-bootstrap.sh
sh quilt-bootstrap.sh
</source></div>

If you want to review the script before you run it, you can look here:

[http://gitorious.org/webos-internals/bootstrap/blobs/master/quilt-bootstrap.sh http://gitorious.org/webos-internals/bootstrap/blobs/master/quilt-bootstrap.sh]

==Finishing==

To finish off, turn Developer Mode back to "Off" (which will reboot your Pre).

Once you are finished, you may SSH into your Pre with an SSH client like [http://www.chiark.greenend.org.uk/~sgtatham/putty/ Putty]:
*Find your IP address on your Pre with [http://checkmyip.com/ CheckMyIP.com]
**In many cases, you are in a local network, but checkmyip.com gives you the WAN addess. Install whatismyip from the homebrew catalog to get your pre's ip address within the local network and use that
*SSH to that IP address on port 222
**If you're doing this over EVDO, there may be a lot of latency. Be patient.
**You can optionally install [[Avahi]] and SSH to <tt>castle.local.</tt>
**[[Tutorials_Linux_DDNS_for_EVDO|Dynamic DNS]] is helpful for consistently accessing the Pre over EVDO with a simple name.
*Log in with the username and password you created during the Optware installation
**Many operations cannot be carried out with the permissions of that username. You'll need to [[Basic_Linux_Use#sudo|sudo]] those operations with the new username's password

Only the default shell (/bin/ash) will work for ssh. To change your shell to bash (which will be located in /opt/bin/bash, once you've completed the quilt install procedure above), you will have to [http://www.webos-internals.org/wiki/Setup_Bash create] an /etc/shells file, and add the following lines:

/bin/ash
/bin/sh
/opt/bin/bash

Then you will be able to edit /etc/passwd and change the shell parameter for the user you created. Note that if you try to change your shell without adding an /etc/shells the SSH server (Dropbear) will look like it is rejecting your password on subsequent connections.

=Install Preware=
To start getting the most out of your new webOS Device you should install Preware. Continue on to the [[Application:Preware|Preware]] page. There you will see all the ways to install Preware on your device. Including stand-alone installers, package installation and an automated script like you did here.

Talk:Portal:Accessing Linux

2009-12-30T14:40:02Z

Hparsons: New section: Installing via Preware

= Accuracy in Terminology =
If we really are caring about accuracy in terms now, we should be calling this page "Accessing GNU/Linux" [http://www.gnu.org/gnu/linux-and-gnu.html], since it's about getting to the mostly GNU userland. I'm not sure what "accessing (the kernel called) linux" would mean, but I assume it would involve a debugger. This is actually also an important distinction between the Palm Pre and Android/Linux based phones, since the Pre seems pretty "normal" to anyone who has used other GNU/Linux distributions from the command line, whereas the Android userland is pretty completely different, both in license (Apache) and use. If there aren't any objections here by the weekend, I'll take a stab at fixing terminology on this page and other pages that refer to it. -- [[User:Djbclark|djbclark]] 23:39, 20 July 2009 (UTC)

== Installing via Preware ==

Downloading the optware-bootstrap.sh script (as instructed) no longer works, and references using an automated method from Preware. Can we get some information on how it's installed from Preware?
--[[User:Hparsons|Herb]] 14:40, 30 December 2009 (UTC)

Talk:Update 1.3.1

2009-11-29T06:32:18Z

Hparsons: New page: I've taken the liberty of reformatting this to match previous pages, and to make it more easily read. If the original author takes issue, please change it back. --~~~~

I've taken the liberty of reformatting this to match previous pages, and to make it more easily read. If the original author takes issue, please change it back.
--[[User:Hparsons|Herb]] 06:32, 29 November 2009 (UTC)

Update 1.3.1

2009-11-29T06:30:49Z

Hparsons:

Put all information about Update 1.3.1 here, including changes made, current development ideas, etc.

== Disabled ==
No information at this time

== New Applications ==
No new applications were introduced

== Feature changes to existing applications ==
Update 1.3.1 has several add and updated items:

=== Backup ===
* Backup now includes browser cookies, so that after a restart, for example, if you stored your username and password on a web-based email site, you can continue to access the site without needing to log in.
* Backup no longer saves online account passwords. If you perform a partial or full erase or buy a replacement phone, after signing in to your Palm profile, you are prompted to enter the password for each of your online accounts. If you choose to skip this step, to continuing synchronizing this account, you must open an app that syncs with the account (Calendar, Contacts, Email) > application menu > Preferences & Accounts > tap the account name > enter your username and password.

=== Calendar ===
* Yahoo! now appears as a Calendar synchronization account. You can synchronize Yahoo! calendar events by opening Calendar > application menu > Preferences & Accounts > Add An Account > Yahoo!
* An event's location now appears with the same formatting in Day view and in the event notification.
* Calendar notifications no longer reappear after being dismissed.
* All-day events that span more than one day now appear correctly in all Calendar views.
* If you create a Google calendar event on the phone and the event location contains an apostrophe, the event now correctly synchronizes with Google online.

=== Camera ===
* After taking a picture, if you tap the picture thumbnail in the lower-left corner of the camera screen, the picture now opens in full-screen view, not Thumbnails view. Making the back gesture returns you to the camera.

=== Contacts ===
* Yahoo! now appears as a Contacts synchronization account. You can download contacts from Yahoo! online to the phone by opening Contacts > application menu > Preferences & Accounts > Add An Account > Yahoo!
* Automatic contact linking based on name matches occurs only if the first and last name fields are populated with the same names. If either field is blank, the Contacts app no longer links the contacts. In addition, the Contacts app no longer automatically links contacts with the same name but with different suffixes (such as Jr. and Sr.).
* Contact phone numbers in an Exchange account display the same label that is used for the number in Outlook.
* If you set up Contacts to synchronize with a Google account, the account synchronizes only entries in Google's My Contacts, not all contacts.
* If a contact entry includes a linked Google instant message that contains a special character (such as an apostrophe or ampersand), the special character now displays correctly.

=== Device Info ===
* If you copy a music file to the phone and then delete it, Device Info now shows the correct amount of available memory after the deletion.

=== Email ===
* Forwarded and replied-to messages include improved formatting, such as the original sender's email address in forwarded messages and correct inline image display in replies.
* The list of mail types available in manual setup now includes Google Apps (Hosted Google Domains) and Yahoo! Small Business Domain email accounts. Selecting one of these types automatically enters the correct settings for these accounts.
* If you have multiple Exchange accounts, doing a Global Address List (GAL) contact lookup searches all the accounts.
* When you set up more than one email account from the same provider-for example, two Gmail or two Yahoo! accounts-in Account List view, the account names display the associated email address so that you can distinguish them.
* A new Select All menu item selects message body text so that you can cut or copy it. A new Copy All menu item copies the entire message contents-sender, date, recipient, subject, and body text-so that you can paste it elsewhere. These menu items appear only when a message is open.
* If you turn the All Inboxes preference off, email notifications now show how many new messages are in each of your email accounts.
* Performing a message search in the All Flagged folder returns flagged messages only.
* If an Exchange 2003 implementation requires a password, you can select an alphanumeric (strong) password even if the server does not require a strong password.
* If an Exchange implementation allows use of a simple PIN (numbers only), the phone supports entry of a PIN that is longer than four characters.
* If a notification appears for an incoming email message whose subject line contains an ampersand, the ampersand appears correctly in the notification.

=== Messaging ===
* Yahoo! IM is available as an instant messaging account.
* You can select a unique ringtone for new message alerts: Open Messaging > application menu > Preferences & Accounts > Sound > Ringtone.
* You can forward a text or multimedia message by tapping the message > Forward.
* You can copy the text of a text or multimedia message by tapping the message > Copy Text.
* If you receive a message from an email address, the sender's name (if in Contacts) or email address (if not) shows up correctly on the new message notification and on the open message in Messaging.
* If you copy a conversation using the Copy All menu item and then pastes the conversation text, the pasted text now appears correctly as plain text, without any HTML tags.
* Messaging notifications now show the number of senders and the number of conversations.
* If you enter a message and start it with a standalone letter-for example, "R" or "r" for "are"-when the auto-correct feature expands the letter to a word, the word is correctly capitalized ("Are").

=== Music ===
* While listening to a song with album art displayed, you can tap the screen below the art to display a playback slider. Dragging the slider jumps forward or backward in the song.

=== Phone ===
* If you are on a call, calendar notifications no longer partially cover the End Call icon.

=== Screen & Lock ===
* A new Secure Unlock preference allows you to set the time interval the phone is idle before the phone locks, requiring you to enter the PIN/password to unlock the phone. This can be the same as or different from the interval after which the screen turns off. To set the preference: Open Screen & Lock > Lock After.
* If you select the Simple PIN Secure Unlock option, you can now enter a numeric PIN of more than four digits.
* If you press power to turn off the screen, the screen locks at the same time. Previously, there was a gap of a few seconds before the screen locked.

=== Sounds & Ringtones ===
* If you select a new ringtone and throw the card off the screen, the phone saves the new ringtone selection.
* If you set the Ringer Switch Off setting to Mute and turn the ringer switch off at any time, the ringer is muted and the phone does not vibrate,regardless of any other Sounds & Ringtones settings.

=== System ===
* The application information dialog box (accessed by pressing and holding the orange key/Option and tapping an app icon) displays the total (uncompressed) size of the app, including the amount of storage the app requires. For apps you installed, this number represents the amount of memory you free up on the phone by deleting the app.
* If you change the apps in Quick Launch, after a backup and partial erase, the new apps still appear in Quick Launch. Previously, Quick Launch reverted to the default apps.
* You can access USB Drive mode by pressing and holding the orange key/Option + Sym + U after connecting the phone to the computer. This enables you to access USB drive mode if the screen is broken or stops responding to taps.
* A new option is available for restarting the phone: press and hold power > Power > Restart. The prior restart method (Device Info > Reset Options > Restart) is still available.
* You have two options for shutting down the phone completely:
# press and hold power > Power > Shut Down/Swap Battery > Shut Down;
# open Device Info > Reset Options > Shut Down > Shut Down.

=== Tasks ===
* If a task notification shows a single task, tapping the notification now opens the details screen for that task, not the task list screen.

=== Videos ===
* Widescreen videos now display in widescreen mode on the phone by default, instead of being cropped.

=== Web ===
* Backup now includes browser cookies, so that after a restart, for example, if you stored your username and password on a web-based email site, you can continue to access the site without needing to log in.
* If you tap to play a YouTube video embedded on a web page, the YouTube application launches and the video plays in the app.

=== YouTube ===
* Widescreen videos now display in widescreen mode on the phone by default, instead of being cropped.
* If you tap to play a YouTube video embedded on a web page, the YouTube application launches and the video plays in the app.

== Security ==
This release addresses several security issues with Palm webOS software.

== Troubleshooting ==
No information at this time

== Package Manifest ==
Not listed at this time

Feel free to annotate, delete, or move this info elsewhere in the wiki as desired.

Update 1.3.1

2009-11-29T06:29:44Z

Hparsons: Reformatted information to match previous pages, and for easier reading.

Put all information about Update 1.3.1 here, including changes made, current development ideas, etc.

== Disabled ==

== No New Applications ==

== Feature changes to existing applications ==
Update 1.3.1 has several add and updated items:

=== Backup ===
* Backup now includes browser cookies, so that after a restart, for example, if you stored your username and password on a web-based email site, you can continue to access the site without needing to log in.
* Backup no longer saves online account passwords. If you perform a partial or full erase or buy a replacement phone, after signing in to your Palm profile, you are prompted to enter the password for each of your online accounts. If you choose to skip this step, to continuing synchronizing this account, you must open an app that syncs with the account (Calendar, Contacts, Email) > application menu > Preferences & Accounts > tap the account name > enter your username and password.

=== Calendar ===
* Yahoo! now appears as a Calendar synchronization account. You can synchronize Yahoo! calendar events by opening Calendar > application menu > Preferences & Accounts > Add An Account > Yahoo!
* An event's location now appears with the same formatting in Day view and in the event notification.
* Calendar notifications no longer reappear after being dismissed.
* All-day events that span more than one day now appear correctly in all Calendar views.
* If you create a Google calendar event on the phone and the event location contains an apostrophe, the event now correctly synchronizes with Google online.

=== Camera ===
* After taking a picture, if you tap the picture thumbnail in the lower-left corner of the camera screen, the picture now opens in full-screen view, not Thumbnails view. Making the back gesture returns you to the camera.

=== Contacts ===
* Yahoo! now appears as a Contacts synchronization account. You can download contacts from Yahoo! online to the phone by opening Contacts > application menu > Preferences & Accounts > Add An Account > Yahoo!
* Automatic contact linking based on name matches occurs only if the first and last name fields are populated with the same names. If either field is blank, the Contacts app no longer links the contacts. In addition, the Contacts app no longer automatically links contacts with the same name but with different suffixes (such as Jr. and Sr.).
* Contact phone numbers in an Exchange account display the same label that is used for the number in Outlook.
* If you set up Contacts to synchronize with a Google account, the account synchronizes only entries in Google's My Contacts, not all contacts.
* If a contact entry includes a linked Google instant message that contains a special character (such as an apostrophe or ampersand), the special character now displays correctly.

=== Device Info ===
* If you copy a music file to the phone and then delete it, Device Info now shows the correct amount of available memory after the deletion.

=== Email ===
* Forwarded and replied-to messages include improved formatting, such as the original sender's email address in forwarded messages and correct inline image display in replies.
* The list of mail types available in manual setup now includes Google Apps (Hosted Google Domains) and Yahoo! Small Business Domain email accounts. Selecting one of these types automatically enters the correct settings for these accounts.
* If you have multiple Exchange accounts, doing a Global Address List (GAL) contact lookup searches all the accounts.
* When you set up more than one email account from the same provider-for example, two Gmail or two Yahoo! accounts-in Account List view, the account names display the associated email address so that you can distinguish them.
* A new Select All menu item selects message body text so that you can cut or copy it. A new Copy All menu item copies the entire message contents-sender, date, recipient, subject, and body text-so that you can paste it elsewhere. These menu items appear only when a message is open.
* If you turn the All Inboxes preference off, email notifications now show how many new messages are in each of your email accounts.
* Performing a message search in the All Flagged folder returns flagged messages only.
* If an Exchange 2003 implementation requires a password, you can select an alphanumeric (strong) password even if the server does not require a strong password.
* If an Exchange implementation allows use of a simple PIN (numbers only), the phone supports entry of a PIN that is longer than four characters.
* If a notification appears for an incoming email message whose subject line contains an ampersand, the ampersand appears correctly in the notification.

=== Messaging ===
* Yahoo! IM is available as an instant messaging account.
* You can select a unique ringtone for new message alerts: Open Messaging > application menu > Preferences & Accounts > Sound > Ringtone.
* You can forward a text or multimedia message by tapping the message > Forward.
* You can copy the text of a text or multimedia message by tapping the message > Copy Text.
* If you receive a message from an email address, the sender's name (if in Contacts) or email address (if not) shows up correctly on the new message notification and on the open message in Messaging.
* If you copy a conversation using the Copy All menu item and then pastes the conversation text, the pasted text now appears correctly as plain text, without any HTML tags.
* Messaging notifications now show the number of senders and the number of conversations.
* If you enter a message and start it with a standalone letter-for example, "R" or "r" for "are"-when the auto-correct feature expands the letter to a word, the word is correctly capitalized ("Are").

=== Music ===
* While listening to a song with album art displayed, you can tap the screen below the art to display a playback slider. Dragging the slider jumps forward or backward in the song.

=== Phone ===
* If you are on a call, calendar notifications no longer partially cover the End Call icon.

=== Screen & Lock ===
* A new Secure Unlock preference allows you to set the time interval the phone is idle before the phone locks, requiring you to enter the PIN/password to unlock the phone. This can be the same as or different from the interval after which the screen turns off. To set the preference: Open Screen & Lock > Lock After.
* If you select the Simple PIN Secure Unlock option, you can now enter a numeric PIN of more than four digits.
* If you press power to turn off the screen, the screen locks at the same time. Previously, there was a gap of a few seconds before the screen locked.

=== Sounds & Ringtones ===
* If you select a new ringtone and throw the card off the screen, the phone saves the new ringtone selection.
* If you set the Ringer Switch Off setting to Mute and turn the ringer switch off at any time, the ringer is muted and the phone does not vibrate,regardless of any other Sounds & Ringtones settings.

=== System ===
* The application information dialog box (accessed by pressing and holding the orange key/Option and tapping an app icon) displays the total (uncompressed) size of the app, including the amount of storage the app requires. For apps you installed, this number represents the amount of memory you free up on the phone by deleting the app.
* If you change the apps in Quick Launch, after a backup and partial erase, the new apps still appear in Quick Launch. Previously, Quick Launch reverted to the default apps.
* You can access USB Drive mode by pressing and holding the orange key/Option + Sym + U after connecting the phone to the computer. This enables you to access USB drive mode if the screen is broken or stops responding to taps.
* A new option is available for restarting the phone: press and hold power > Power > Restart. The prior restart method (Device Info > Reset Options > Restart) is still available.
* You have two options for shutting down the phone completely:
# press and hold power > Power > Shut Down/Swap Battery > Shut Down;
# open Device Info > Reset Options > Shut Down > Shut Down.

=== Tasks ===
* If a task notification shows a single task, tapping the notification now opens the details screen for that task, not the task list screen.

=== Videos ===
* Widescreen videos now display in widescreen mode on the phone by default, instead of being cropped.

=== Web ===
* Backup now includes browser cookies, so that after a restart, for example, if you stored your username and password on a web-based email site, you can continue to access the site without needing to log in.
* If you tap to play a YouTube video embedded on a web page, the YouTube application launches and the video plays in the app.

=== YouTube ===
* Widescreen videos now display in widescreen mode on the phone by default, instead of being cropped.
* If you tap to play a YouTube video embedded on a web page, the YouTube application launches and the video plays in the app.

== Security ==
This release addresses several security issues with Palm webOS software.

== Troubleshooting ==

== Package Manifest ==

Feel free to annotate, delete, or move this info elsewhere in the wiki as desired.

Talk:Solution to App Catalog Installation Limit

2009-10-09T16:19:57Z

Hparsons: /* Confirmed Section */

== A call to port this script to a webOS app ==

This is just a proof of concept script, which I didn't intend to mature to this level. Ideally this would be ported as a standalone webOS app for App Management or included in PreWare and other homebrew app installers.

If you are interested in porting (or applying the basic symbolic link concept), please post your interest here.

--[[User:Xorg|Xorg]] 01:26, 5 October 2009 (UTC)

== Modified the APP variable in the script ==

Modified the script to change<br>
<code>APP=$1</code><br>
to<br>
<code>APP=/var/usr/palm/applications/$1</code><br>
I'm no script writer, and wouldn't normally change someone else's code, but the script did not work as originally written unless you were already in that directory. I tested it with the changes, and it works properly now.

--[[User:Hparsons|Herb]] 14:31, 30 September 2009 (UTC)

Not sure why it didn't work for you as your change didn't work for me. Are you using a different shell? I added a line to force #!/bin/sh and altered the code back with a note about your change.

--[[User:Xorg|Xorg]] 03:12, 1 October 2009 (UTC)

My bad. The way the code was originally formatted, I couldn't cut and paste, and when entering it, I somehow missed the <code>cd $ORG</code> command. You're right, it should (and does) work in the original format.

--[[User:Hparsons|Herb]] 06:01, 1 October 2009 (UTC)

== Changing app directory to .app ==

I had noticed that with the 1.2 update, all of the graphics on the USB directory were being scanned as if they were photos. This was pretty much a mess, and hand planned on coming back here to suggest that the "app" directory be changed to ".app" so it would be hidden. I noticed the altered code already had that change, but the original intro did not. Assuming this was the intent, I changed that.

--[[User:Hparsons|Herb]] 14:36, 30 September 2009 (UTC)

== Restructured script to use functions ==

I've restructured the script to use functions. This allows anyone to post in their own functions and additional features.

--[[User:Xorg|Xorg]] 19:50, 2 October 2009 (UTC)

== Suggestion for the script ==

Perhaps in preparation for the "unlink" command, the "link" command can also create a full backup of the app (.tgz) which will contain the full permissions and any symbolic links that will be lost when copying the app to the /media/internal/.apps directory. That way if we find that the app does not run correctly from the linked version on /media/internal/.apps, we can restore it fully to /var with no loss of data.

--[[User:Plee3|plee3]] 21:46, 2 October 2009 (UTC)

I just added tar backups. It's an option that currently is on by default. You need to change the flag in variable setup to turn off.

--[[User:Xorg|Xorg]] 20:53, 5 October 2009 (UTC)

== Versioning ==

Possibly could those modifying the script start using some sort of versioning, with the version at the front of the script, with information about what the new version does added to the main article page?

--[[User:Hparsons|Herb]] 00:22, 5 October 2009 (UTC)

Added

--[[User:Xorg|Xorg]] 01:17, 5 October 2009 (UTC)

== cp -rp? ==

Why do you not use cp -rp to link the app? This would save the permissions needed.
--

^Because /media is a FAT filesystem and permissions will be lost. I suppose it wouldn't hurt to code -rp though.

== Confirmed Section ==

Added a section for confirmed files, with subsections for confirmed to work, and confirmed not to work. Feel free to delete or change as you see appropriate Xorg.

--[[User:Hparsons|Herb]] 16:19, 9 October 2009 (UTC)

Talk:Solution to App Catalog Installation Limit

2009-10-09T16:19:25Z

Hparsons: New section: Confirmed Section

Solution to App Catalog Installation Limit

2009-10-09T16:17:44Z

Hparsons:

Based on rwhitby's findings that temporarily moving /var/usr/palm/applications will allow installing apps from the App Catalog, here's a permanent way to keep the apps on (much larger) /media/internal by using links. This will permanently save space on /var.

It's unfortunate that Palm has not resolved the issue in the 1.2 update. This is a tactical workaround that could potentially work long term, also saving space on /var, but this needs support by the homebrew community to add in the homebrew installer apps.

== Overview ==
This solution involves creating a (hidden) directory in the /media/internal area, moving selected applications to the newly created directory, and then creating a symbolic link in the /var/usr/palm/applications directory pointing to the new location. This frees up the disk space from the relatively limited /var volume to the larger /media/internal. The included script (which must be created) will move the files and create the appropriate link. It will also provide information on the size of the applications stored in the /var/usr/palm/applications directory.

== Solution (symbolic link method) ==

Create a script to move apps to new home and create link. You can use an editor or use the following cat command to paste the code, for those not familiar with editors.

Here's how to do it for those comfortable with accessing Linux...

- Enter Linux mode on Pre through a computer (linux commands are in bold)

- Set read/write to allow creating script<br>
<code>'''mount -o remount,rw / '''</code>

- create a script using cat command, paste the code below and then do 'ctrl c' on the keyboard to break out.<br>
<code>'''cat >/usr/bin/mvapp''' </code>

- paste the code below here, press ctrl-c on keyboard to exit after pasting the code.

- when you see a linux prompt, set command to be executable<br>
<code> '''chmod 755 /usr/bin/mvapp''' </code>

----
code:
<pre>
#!/bin/sh

# This code is open for re-use with no restrictions. xorg
# This is a working proof of concept script still in development.
# Intent is for someone to port to a webOS app.
# Use at your own risk.

#-------------------------------------------------------------------------#
# versions:
# 0.1.0 - original (xorg)
# 0.1.1 - added unlink and clean functions (daventx)
# 0.1.2 - added bulkmv function, allows moving many apps (xorg)
# 0.1.3 - added option for tar backups (xorg)
# 0.1.4 - added listmoved function to show apps already moved (xorg)
# 0.1.5 - added restoreall function, couple cleanup items (xorg)
# 0.1.6 - fixed to show usage if no appname supplied to link/unlink (xorg)
# 0.1.7 - added cleanexit (w/mount ro /)
# - added exit code documentation for javascripts calling this (xorg)
#-------------------------------------------------------------------------#

#-------------------------------------------------------------------------#
# variables: these are globally available to all functions
#-------------------------------------------------------------------------#
COMMAND=$1
APP=$2
MEDIA=/media/internal/.apps
VAR=/var/usr/palm/applications

# Backup keeps file attributes but uses more /media space. Recommend doing backups.
BACKUP=1 # set to 1 for tar backups, 0 to disable
BACKUPDIR=/media/internal/.appbackups

#-------------------------------------------------------------------------#
# exit codes for javascripts:
# function usage:
# 1 - normal usage error
#
# function cleanapp:
# 0 - normal exit
#
# function linkapp:
# 10 - app name not supplied
# 11 - link already exists
# 12 - app does not exit in VAR
# 13 - copy failed from VAR to MEDIA
# 14 - removing app from VAR failed
#
# function unlinkapp:
# 20 - app name not supplied
# 21 - app doesn't exit on MEDIA
# 22 - tar restore failed
# 23 - copy failed
# 24 - remove failed
#
#-------------------------------------------------------------------------#

#-------------------------------------------------------------------------#
# function: cleanexit - exit with cleanup items
#-------------------------------------------------------------------------#

cleanexit () {
code=$1

# put / back to read only
mount -o remount,ro /

# Uncomment if you want verbose exit codes
# echo "exit code: $code"

exit $code
}
# end of cleanexit function

#-------------------------------------------------------------------------#
# function: usage - show command usage options
#-------------------------------------------------------------------------#
usage () {
exitcode=$1
if [ ! $exitcode ]
then
exitcode=1 # default exit code for usage, otherwise exit with incode
fi

echo "Usage: mvapp link domain.appname - move app to media and link"
echo "Usage: mvapp unlink domain.appname - restore app to var, remove link"
echo "Usage: mvapp clean domain.appname - remove app dir and links"
echo "Usage: mvapp list - list all apps sorted by size"
echo "Usage: mvapp bulkmv - move/link bulk apps"
echo "Usage: mvapp listmoved - list apps that have been moved"
echo "Usage: mvapp restoreall - restore all apps to original"

cleanexit $exitcode
}
# end of usage function

#-------------------------------------------------------------------------#
# function: cleanapp - removes symbolic links and folder in media and var
#-------------------------------------------------------------------------#

cleanapp () {

mount -o remount,rw /

# exit to usage if no app name supplied
if [ ! $APP ]
then
usage
fi

# Optional
echo "This will remove $APP from both $VAR and $MEDIA."
echo "You should first attempt to remove the app using the official Pre methods."
echo "Are you sure you want to remove $APP? [y/N]: "
read answer
case $answer in
[Yy]*) continue;;
*) cleanexit 0;;
esac

if [ -h $VAR/$APP ]
then
echo "Removing all traces of $APP."
else
echo "$APP does not exist..."
usage 10
fi

echo "Size of $VAR before cleanup... "
du -sh $VAR

if [ -d $MEDIA/$APP ]
then
rm -r $MEDIA/$APP
echo "Removed directory" $MEDIA/$APP
fi
if [ -d $VAR/$APP ]
then
rm -r $VAR/$APP
echo "Removed directory" $VAR/$APP
fi
if [ -L $VAR/$APP ]
then
rm -r $VAR/$APP
echo "Removed link" $VAR/$APP
fi
if [ -f $BACKUPDIR/$APP.tgz ]
then
rm -r $BACKUPDIR/$APP.tgz
echo "Removed tar backup" $BACKUPDIR/$APP.tgz
fi

# rescan luna in case it's needed
luna-send -n 1 palm://com.palm.applicationManager/rescan {} >/dev/null 2>&1
echo "$APP directories and links removed."
echo "Size of $VAR after cleanup... "
du -sh $VAR
cleanexit 0
}
# end of cleanup function

#-------------------------------------------------------------------------#
# function: listapps - list the size of each app, sort showing largest last
#-------------------------------------------------------------------------#
listapps () {
du -s $VAR/* | sort -n
cleanexit 0
}
# end of listapps function

#-------------------------------------------------------------------------#
# function: listmoved - list apps moved/linked, sort showing largest last
#-------------------------------------------------------------------------#
listmoved () {
du -sk $MEDIA/* | sort -n
cleanexit 0
}
# end of listmoved function

#-------------------------------------------------------------------------#
# function: linkapp - move the app to media and create symbolic link
#-------------------------------------------------------------------------#
linkapp () {

if [ ! $APP ]
then
echo "No application supplied..."
usage 10
fi

if [ ! -d $MEDIA ]
then
mkdir $MEDIA
fi

if [ -h $VAR/$APP ]
then
echo "Link already exists for... ${APP}"
cleanexit 11
fi

mount -o remount,rw /

if [ -d $VAR/$APP ]
then
echo "Moving $APP to $MEDIA..."
else
echo "$APP does not exist..."
usage 12
fi

# Backup using tar if enabled
if [ $BACKUP ]
then
if [ ! -d $BACKUPDIR ]
then
mkdir $BACKUPDIR
fi
echo "Backing up $APP to $BACKUPDIR..."
tar czf $BACKUPDIR/${APP}.tgz $VAR/$APP
fi

mount -o remount,rw /

echo "Size of $VAR before move... "
du -sh $VAR

# move over to USB drive
cp -rp $VAR/$APP $MEDIA
if [ $? != 0 ]
then
echo "Copy failed. Leaving app in $VAR."
rm -r $MEDIA/$APP
cleanexit 13
fi

rm -r $VAR/$APP
if [ $? != 0 ]
then
echo "Remove failed. Leaving app in $VAR."
rm -r $MEDIA/$APP
cleanexit 14
fi

# create the symbolic link
ln -s $MEDIA/$APP $VAR/$APP

# rescan luna in case it's needed
luna-send -n 1 palm://com.palm.applicationManager/rescan {} >/dev/null 2>&1

echo "$APP moved and linked."
echo "Size of $VAR after move... "
du -sh $VAR
}
# end of linkapp function

#-------------------------------------------------------------------------#
# function: unlinkapp - restore the app to var and remove symbolic link
#-------------------------------------------------------------------------#
unlinkapp () {

if [ ! $APP ]
then
echo "No application supplied..."
usage 20
fi

mount -o remount,rw /

if [ -d $MEDIA/$APP ]
then
echo "Restoring $APP..."
else
echo "$APP does not exist..."
usage 21
fi

echo "Size of $VAR before move... "
du -sh $VAR

# remove the old symbolic link
rm -r $VAR/$APP

# move to original location or restore from tar if it exists
if [ -f $BACKUPDIR/$APP.tgz ]
then
cd /
tar xzf $BACKUPDIR/$APP.tgz
if [ $? != 0 ]
then
echo "Tar restore failed. Remove and restore app using official webOS/Pre methods."
cleanexit 22
else
rm -r $BACKUPDIR/$APP.tgz
fi
else
cp -r $MEDIA/$APP $VAR
if [ $? != 0 ]
then
echo "Copy failed. Leaving app in $MEDIA."
cleanexit 23
fi
fi

rm -r $MEDIA/$APP
if [ $? != 0 ]
then
echo "Remove failed. Leaving app in $MEDIA."
rm -r $VAR/$APP
cleanexit 24
fi

# rescan luna in case it's needed
luna-send -n 1 palm://com.palm.applicationManager/rescan {} >/dev/null 2>&1

echo "$APP moved and unlinked."
echo "Size of $VAR after move... "
du -sh $VAR
}
# end of unlinkapp function

#-------------------------------------------------------------------------#
# function: bulkvm - move/link many apps
#-------------------------------------------------------------------------#
bulkmv() {
echo
echo
echo "This allows moving many apps, asking which you'd like to move."
echo "Starting with the largest apps."
echo

mount -o remount,rw /
cd $VAR

for i in `du -s * | sort -nr |cut -f 2`
do
export APP=$i
SIZE=`du -sh $APP |cut -f 1`
echo "Size of $APP is $SIZE."
echo "Would you like to move and link $APP ? [y/N/q]: "
read answer
case $answer in
[Yy]*) linkapp;;
[Qq]*) cleanexit 0;;
*) echo "$APP not moved."
continue;;
esac

echo
done
}
# end of bulkmv function

#-------------------------------------------------------------------------#
# function: restoreall - restore all apps, back to /var
#-------------------------------------------------------------------------#
restoreall() {
echo "This will restore all applications back to original location"
echo "and remove the links. Are you sure you want to continue? [y/N]:"
read answer
case $answer in
[Yy]*) continue;;
*) cleanexit 0;;
esac

ls $MEDIA | while read APP
do
echo "Restoring $APP and unlinking..."
unlinkapp
done
}
# end of restoreall function

#-------------------------------------------------------------------------#
# main - begins here
#-------------------------------------------------------------------------#

case $COMMAND in
"clean")
cleanapp
;;
"list")
listapps
;;
"listmoved")
listmoved
;;
"link")
linkapp
;;
"unlink")
unlinkapp
;;
"bulkmv")
bulkmv
;;
"restoreall")
restoreall
;;
*)
usage 0
;;
esac

cleanexit 0

</pre>

----

- Be sure to set execute permissions if you missed the step above...
<code>chmod 755 /usr/bin/mvapp</code>

== Precautions ==

So far, no one has reported an app that has issues due to linking. These are best practices to avoid issues.

- Be selective about what you move. You may not want to move apps that store important information to you such as password lockers, memo apps, EverNote, Agenda, etc. Games, web content apps and information viewing apps should be safer to move as there is no data at risk.

- Close apps before moving them. Do not move an app while it is open and running. I actually tested this and figured some apps would break but none have yet. It is still not wise to move apps while they are open and running.

== Commands ==

'''To find the largest apps in /var/usr/palm/applications'''

<code>mvapp list</code>

It shows the largest apps last... IE....<br>
<code>
8352 com.apnews.webos<br>
8512 com.fandango.app.fandango<br>
8672 com.palm.app.musicplayerremix<br>
10304 com.shortcovers.palm.pre<br>
10432 com.fusioncreativestudios.deadman<br>
10656 com.ulocate.app.where<br>
</code>

'''To move and link an app to /media'''

<code>mvapp link domain.appname</code>

Example: mvapp link com.ulocate.app.where

The app should now work in the new location thanks to the link. Test each app to make sure it works before doing another. Looping the script to do every app in the dir or to link the entire app dir is not recommended. File attributes are lost on the move, which some apps may need. You need to test each app after a move.

Continue moving apps until it reports that /var.../applications is about 25MB or less.

There is an option to turn on/off tar-based backups. See the BACKUP variable in the script. If set to 1, it will perform a tar backup. This takes up more space on /media but if you need to restore, it puts it back with full file attributes. Recommend keeping this on.

'''To move and link many apps'''

<code>mvapp bulkmv</code>

This will show largest app first, ask if you want to move/link and then moves on to the next largest app. If you answer no to an app, it will skip to the next. Answer 'q' to quit. Is easiest to use this method directly on a device using the Terminal app.

'''To revert the move and delete the link'''

<code>mvapp unlink domain.appname</code>

The application will be moved back to the original directory. File attributes are lost on the move if tar backup is turned off, which some apps may need. You need to test each app after a move. If tar backup is turned on (default - see BACKUP variable in script), file attributes will be restored.

'''To list apps that have been moved and linked...'''

<code>mvapp listmoved</code>

This shows a list of apps that have been moved and linked to /media.

'''To restore all moved apps back to original location'''

<code>mvapp restoreall</code>

If backup was turned on, this will restore ALL applications that have been moved/linked, back to the original location in /var with original attributes (using tar). If backup was not turned on, it will still attempt to move the applications back to /var using the files in /media, but without original file attributes. This may take several minutes to complete. It will show each application progress.

'''To cleanup and remove directories and symlinks'''

<code>mvapp clean domain.appname</code>

If you have any issues, first attempt to remove the app from the App Catalog or Homebrew app installer. Then issue the 'clean' command to remove the applications directories at both locations and also the symlink. You can then reinstall the app from the App Catalog or any Homebrew App installer.

== Contingency Plan==

If you have problems with an application, follow these steps...<br>
-- Close the application if open<br>
-- mvapp unlink domain.appname<br>
-- Try using the App<br>

If the application still does now work correctly...<br>
-- Remove the App using official methods<br>
-- mvapp clean domain.appname<br>
-- Reinstall through the App Catalog or Homebrew installer app<br>

== Proposal to Dev Community ==

This is a formal proposal to the Dev Community suggesting that PreWare, WebOS Quick Install and other Pre installer apps provide an option to move any app in /var to the /media fs and create a link similar to the code above.

The Homebrew Community somewhat created part of the storage problem so needs to come up with their own solution. The symbolic link proponents propose that Homebrew apps be moved with a link to /media/internal by default and physically use /var only if needed (per conditions stated below). The developer would put a flag in the package (or some other method during submission) to state their app is able to run linked to /media or if it specifically needs to physically be on /var. Will propose additions to Packing Standards to support /media links. The homebrew installer apps could then automatically do the move/link if the package is flagged for it.

Candidate apps for moving to /media<br>
- apps that do not depend on file attributes (such as executable bit)<br>
- apps that do not perform data operations to home app directory when device is USB mounted<br>

Exceptions for maintaining apps on /var<br>
- apps that depend on file attributes<br>
- apps that won't work well when device is USB mounted, such as performing data or DB operations in home app directory<br>

(Please update with other known candidates/exceptions)

== Benefits over other methods ==

''Resizing /var'' <br>
One challenge with resizing /var is that it will still have a fixed static limit - how do you decide how much to increase it? Many will still probably hit the limit or waste space if setting too high. There is also the warning from Palm that resizing var may interfere with future updates. The link method allows to dynamically use the /media partition, so there is no need to set a specific size dedicated to apps. If the USB drive is filled, users can decide if they use the space for media or apps on the fly.

''AppPath in /etc/luna.conf'' <br>
I proposed a while back adding an AppPath to luna.conf to include apps stored on /media. Some apps would not work because some apparently reference /var. IE, the vampire/mafia/quest series could not access graphics. The symbolic link fixed this because apps think they are in /var.

''Link/mount [[all]] of /var/usr/palm/applications/ to /media/internal'' <BR>
If some apps rely on file attributes this won't work since file attributes are lost when moved to FAT fs. While this is rare, it probably isn't wise to force all /var apps to /media. Selectively moving apps one at a time is less risky. Update: Have found that "PDF View" app does not allow to be linked, so it appears that selectively moving apps is necessary.

''Creating a loopback filesystem to a virtual file located on /media/internal'' <br>
This has been worked on [http://www.webos-internals.org/wiki/Tutorials_Linux_opt_on_loopback here] and still has potential. Unfortunately it locks out USB mount and media sync altogether. If a workaround can be found with low risk, this may be the most ideal solution.

== Risks, Issues, Dependencies ==

- File attributes of linux fs are not copied over to fat fs. May not work with apps that rely on file attributes. In general, javascript apps will likely work fine located on /media. No one has reported an app (yet) that does not work.

- Some apps may not behave well if USB drive is mounted to computer, though I've tested several that behaved fine. Linux type background services probably would not work well so probably should not be moved. Apps that do IO to the home directory of the app while USB mounted may have issues when located on /media.

- Jason Robitaille has indicated that a future version of WebOS Quick Install will include a routine to resize the /var partition. He has also indicated that doing so will wipe the /media/internal area, so any applications stored there would need to be backed up first. It might be good to be able to reverse the process of this solution. This could be done either by adding to this <code>mvapp</code> script, or creating a new one.

== Future Versions ==

Plans for future versions...

- The script will soon be modified to be friendly for javascript calls... no prompting and no output, just result codes. Will still maintain user interaction capability as well.

== Confirmed Files ==
=== Files Confirmed to Work ===
:com.accuweather.palm
:com.asc.funfactsw
:com.biocandy.prejeweled
:com.bitsofgodsoftware.simplebible
:com.bytesequencing.pre.balls
:com.bytesequencing.pre.spades
:com.cakefight.sudoku
:com.deliciousmorsel.twee
:com.engineequalscar.games.mines
:com.fandango.app.fandango
:com.flixster.app.movies
:com.friendsflow.friendsflowbeta
:com.fusioncreativestudios.deadman
:com.jackintheboxsoftwareinc.app.mobios
:com.landgrabgames.zilch.lite
:com.longbeachit.gototoollite
:com.mediafly.mediafly-pre
:com.mrjspeed.toppleball
:com.myappcatalog.cardmessagesbeta
:com.myappcatalog.guitaristsreference
:com.myappcatalog.superhangmanbeta
:com.orbsix.app.magic8ball
:com.palm.app.agenda
:com.palm.pandora
:com.palm.repomanager
:com.quigley-jones.preopoly
:com.sachersoft.wordwhirllite
:com.splashdata.app.mcraig
:com.stickywhipit.yatz
:com.tj.solitaire
:com.wikihow.wikihowapp
:net.keenstudios.app.checkers
:ws.junk.blocked
:ws.junk.dotgame

=== Files Confirmed ''Not'' to Work ===
:com.palm.app.pdfviewer

== Discuss ==
Discuss in the Discussion tab or PreCentral...

http://forums.precentral.net/web-os-development/205649-resolution-app-catalog-install-limit-proposal.html

'''Your Experiences'''

Please post your experiences, good or bad. I'd like to get any kinks worked out before attempting to turn this into a webOS app.

- How many apps did you move? <br>
- Did you find an app that won't work linked? <br>
- Did you move any back? (please test)<br>
- How far down did you have to get /var.../applications down in MB before you could start adding apps from the App Catalog?<br>

== Credits ==
xorg - initially developed script and proposal. maintainer of this page.<br>
daventx - added unlink and clean functions.

Solution to App Catalog Installation Limit

2009-10-09T16:15:44Z

Hparsons: /* Files Confirmed ''Not'' to Work */

Based on rwhitby's findings that temporarily moving /var/usr/palm/applications will allow installing apps from the App Catalog, here's a permanent way to keep the apps on (much larger) /media/internal by using links. This will permanently save space on /var.

It's unfortunate that Palm has not resolved the issue in the 1.2 update. This is a tactical workaround that could potentially work long term, also saving space on /var, but this needs support by the homebrew community to add in the homebrew installer apps.

== Overview ==
This solution involves creating a (hidden) directory in the /media/internal area, moving selected applications to the newly created directory, and then creating a symbolic link in the /var/usr/palm/applications directory pointing to the new location. This frees up the disk space from the relatively limited /var volume to the larger /media/internal. The included script (which must be created) will move the files and create the appropriate link. It will also provide information on the size of the applications stored in the /var/usr/palm/applications directory.

== Solution (symbolic link method) ==

Create a script to move apps to new home and create link. You can use an editor or use the following cat command to paste the code, for those not familiar with editors.

Here's how to do it for those comfortable with accessing Linux...

- Enter Linux mode on Pre through a computer (linux commands are in bold)

- Set read/write to allow creating script<br>
<code>'''mount -o remount,rw / '''</code>

- create a script using cat command, paste the code below and then do 'ctrl c' on the keyboard to break out.<br>
<code>'''cat >/usr/bin/mvapp''' </code>

- paste the code below here, press ctrl-c on keyboard to exit after pasting the code.

- when you see a linux prompt, set command to be executable<br>
<code> '''chmod 755 /usr/bin/mvapp''' </code>

----
code:
<pre>
#!/bin/sh

# This code is open for re-use with no restrictions. xorg
# This is a working proof of concept script still in development.
# Intent is for someone to port to a webOS app.
# Use at your own risk.

#-------------------------------------------------------------------------#
# versions:
# 0.1.0 - original (xorg)
# 0.1.1 - added unlink and clean functions (daventx)
# 0.1.2 - added bulkmv function, allows moving many apps (xorg)
# 0.1.3 - added option for tar backups (xorg)
# 0.1.4 - added listmoved function to show apps already moved (xorg)
# 0.1.5 - added restoreall function, couple cleanup items (xorg)
# 0.1.6 - fixed to show usage if no appname supplied to link/unlink (xorg)
# 0.1.7 - added cleanexit (w/mount ro /)
# - added exit code documentation for javascripts calling this (xorg)
#-------------------------------------------------------------------------#

#-------------------------------------------------------------------------#
# variables: these are globally available to all functions
#-------------------------------------------------------------------------#
COMMAND=$1
APP=$2
MEDIA=/media/internal/.apps
VAR=/var/usr/palm/applications

# Backup keeps file attributes but uses more /media space. Recommend doing backups.
BACKUP=1 # set to 1 for tar backups, 0 to disable
BACKUPDIR=/media/internal/.appbackups

#-------------------------------------------------------------------------#
# exit codes for javascripts:
# function usage:
# 1 - normal usage error
#
# function cleanapp:
# 0 - normal exit
#
# function linkapp:
# 10 - app name not supplied
# 11 - link already exists
# 12 - app does not exit in VAR
# 13 - copy failed from VAR to MEDIA
# 14 - removing app from VAR failed
#
# function unlinkapp:
# 20 - app name not supplied
# 21 - app doesn't exit on MEDIA
# 22 - tar restore failed
# 23 - copy failed
# 24 - remove failed
#
#-------------------------------------------------------------------------#

#-------------------------------------------------------------------------#
# function: cleanexit - exit with cleanup items
#-------------------------------------------------------------------------#

cleanexit () {
code=$1

# put / back to read only
mount -o remount,ro /

# Uncomment if you want verbose exit codes
# echo "exit code: $code"

exit $code
}
# end of cleanexit function

#-------------------------------------------------------------------------#
# function: usage - show command usage options
#-------------------------------------------------------------------------#
usage () {
exitcode=$1
if [ ! $exitcode ]
then
exitcode=1 # default exit code for usage, otherwise exit with incode
fi

echo "Usage: mvapp link domain.appname - move app to media and link"
echo "Usage: mvapp unlink domain.appname - restore app to var, remove link"
echo "Usage: mvapp clean domain.appname - remove app dir and links"
echo "Usage: mvapp list - list all apps sorted by size"
echo "Usage: mvapp bulkmv - move/link bulk apps"
echo "Usage: mvapp listmoved - list apps that have been moved"
echo "Usage: mvapp restoreall - restore all apps to original"

cleanexit $exitcode
}
# end of usage function

#-------------------------------------------------------------------------#
# function: cleanapp - removes symbolic links and folder in media and var
#-------------------------------------------------------------------------#

cleanapp () {

mount -o remount,rw /

# exit to usage if no app name supplied
if [ ! $APP ]
then
usage
fi

# Optional
echo "This will remove $APP from both $VAR and $MEDIA."
echo "You should first attempt to remove the app using the official Pre methods."
echo "Are you sure you want to remove $APP? [y/N]: "
read answer
case $answer in
[Yy]*) continue;;
*) cleanexit 0;;
esac

if [ -h $VAR/$APP ]
then
echo "Removing all traces of $APP."
else
echo "$APP does not exist..."
usage 10
fi

echo "Size of $VAR before cleanup... "
du -sh $VAR

if [ -d $MEDIA/$APP ]
then
rm -r $MEDIA/$APP
echo "Removed directory" $MEDIA/$APP
fi
if [ -d $VAR/$APP ]
then
rm -r $VAR/$APP
echo "Removed directory" $VAR/$APP
fi
if [ -L $VAR/$APP ]
then
rm -r $VAR/$APP
echo "Removed link" $VAR/$APP
fi
if [ -f $BACKUPDIR/$APP.tgz ]
then
rm -r $BACKUPDIR/$APP.tgz
echo "Removed tar backup" $BACKUPDIR/$APP.tgz
fi

# rescan luna in case it's needed
luna-send -n 1 palm://com.palm.applicationManager/rescan {} >/dev/null 2>&1
echo "$APP directories and links removed."
echo "Size of $VAR after cleanup... "
du -sh $VAR
cleanexit 0
}
# end of cleanup function

#-------------------------------------------------------------------------#
# function: listapps - list the size of each app, sort showing largest last
#-------------------------------------------------------------------------#
listapps () {
du -s $VAR/* | sort -n
cleanexit 0
}
# end of listapps function

#-------------------------------------------------------------------------#
# function: listmoved - list apps moved/linked, sort showing largest last
#-------------------------------------------------------------------------#
listmoved () {
du -sk $MEDIA/* | sort -n
cleanexit 0
}
# end of listmoved function

#-------------------------------------------------------------------------#
# function: linkapp - move the app to media and create symbolic link
#-------------------------------------------------------------------------#
linkapp () {

if [ ! $APP ]
then
echo "No application supplied..."
usage 10
fi

if [ ! -d $MEDIA ]
then
mkdir $MEDIA
fi

if [ -h $VAR/$APP ]
then
echo "Link already exists for... ${APP}"
cleanexit 11
fi

mount -o remount,rw /

if [ -d $VAR/$APP ]
then
echo "Moving $APP to $MEDIA..."
else
echo "$APP does not exist..."
usage 12
fi

# Backup using tar if enabled
if [ $BACKUP ]
then
if [ ! -d $BACKUPDIR ]
then
mkdir $BACKUPDIR
fi
echo "Backing up $APP to $BACKUPDIR..."
tar czf $BACKUPDIR/${APP}.tgz $VAR/$APP
fi

mount -o remount,rw /

echo "Size of $VAR before move... "
du -sh $VAR

# move over to USB drive
cp -rp $VAR/$APP $MEDIA
if [ $? != 0 ]
then
echo "Copy failed. Leaving app in $VAR."
rm -r $MEDIA/$APP
cleanexit 13
fi

rm -r $VAR/$APP
if [ $? != 0 ]
then
echo "Remove failed. Leaving app in $VAR."
rm -r $MEDIA/$APP
cleanexit 14
fi

# create the symbolic link
ln -s $MEDIA/$APP $VAR/$APP

# rescan luna in case it's needed
luna-send -n 1 palm://com.palm.applicationManager/rescan {} >/dev/null 2>&1

echo "$APP moved and linked."
echo "Size of $VAR after move... "
du -sh $VAR
}
# end of linkapp function

#-------------------------------------------------------------------------#
# function: unlinkapp - restore the app to var and remove symbolic link
#-------------------------------------------------------------------------#
unlinkapp () {

if [ ! $APP ]
then
echo "No application supplied..."
usage 20
fi

mount -o remount,rw /

if [ -d $MEDIA/$APP ]
then
echo "Restoring $APP..."
else
echo "$APP does not exist..."
usage 21
fi

echo "Size of $VAR before move... "
du -sh $VAR

# remove the old symbolic link
rm -r $VAR/$APP

# move to original location or restore from tar if it exists
if [ -f $BACKUPDIR/$APP.tgz ]
then
cd /
tar xzf $BACKUPDIR/$APP.tgz
if [ $? != 0 ]
then
echo "Tar restore failed. Remove and restore app using official webOS/Pre methods."
cleanexit 22
else
rm -r $BACKUPDIR/$APP.tgz
fi
else
cp -r $MEDIA/$APP $VAR
if [ $? != 0 ]
then
echo "Copy failed. Leaving app in $MEDIA."
cleanexit 23
fi
fi

rm -r $MEDIA/$APP
if [ $? != 0 ]
then
echo "Remove failed. Leaving app in $MEDIA."
rm -r $VAR/$APP
cleanexit 24
fi

# rescan luna in case it's needed
luna-send -n 1 palm://com.palm.applicationManager/rescan {} >/dev/null 2>&1

echo "$APP moved and unlinked."
echo "Size of $VAR after move... "
du -sh $VAR
}
# end of unlinkapp function

#-------------------------------------------------------------------------#
# function: bulkvm - move/link many apps
#-------------------------------------------------------------------------#
bulkmv() {
echo
echo
echo "This allows moving many apps, asking which you'd like to move."
echo "Starting with the largest apps."
echo

mount -o remount,rw /
cd $VAR

for i in `du -s * | sort -nr |cut -f 2`
do
export APP=$i
SIZE=`du -sh $APP |cut -f 1`
echo "Size of $APP is $SIZE."
echo "Would you like to move and link $APP ? [y/N/q]: "
read answer
case $answer in
[Yy]*) linkapp;;
[Qq]*) cleanexit 0;;
*) echo "$APP not moved."
continue;;
esac

echo
done
}
# end of bulkmv function

#-------------------------------------------------------------------------#
# function: restoreall - restore all apps, back to /var
#-------------------------------------------------------------------------#
restoreall() {
echo "This will restore all applications back to original location"
echo "and remove the links. Are you sure you want to continue? [y/N]:"
read answer
case $answer in
[Yy]*) continue;;
*) cleanexit 0;;
esac

ls $MEDIA | while read APP
do
echo "Restoring $APP and unlinking..."
unlinkapp
done
}
# end of restoreall function

#-------------------------------------------------------------------------#
# main - begins here
#-------------------------------------------------------------------------#

case $COMMAND in
"clean")
cleanapp
;;
"list")
listapps
;;
"listmoved")
listmoved
;;
"link")
linkapp
;;
"unlink")
unlinkapp
;;
"bulkmv")
bulkmv
;;
"restoreall")
restoreall
;;
*)
usage 0
;;
esac

cleanexit 0

</pre>

----

- Be sure to set execute permissions if you missed the step above...
<code>chmod 755 /usr/bin/mvapp</code>

== Precautions ==

So far, no one has reported an app that has issues due to linking. These are best practices to avoid issues.

- Be selective about what you move. You may not want to move apps that store important information to you such as password lockers, memo apps, EverNote, Agenda, etc. Games, web content apps and information viewing apps should be safer to move as there is no data at risk.

- Close apps before moving them. Do not move an app while it is open and running. I actually tested this and figured some apps would break but none have yet. It is still not wise to move apps while they are open and running.

== Commands ==

'''To find the largest apps in /var/usr/palm/applications'''

<code>mvapp list</code>

It shows the largest apps last... IE....<br>
<code>
8352 com.apnews.webos<br>
8512 com.fandango.app.fandango<br>
8672 com.palm.app.musicplayerremix<br>
10304 com.shortcovers.palm.pre<br>
10432 com.fusioncreativestudios.deadman<br>
10656 com.ulocate.app.where<br>
</code>

'''To move and link an app to /media'''

<code>mvapp link domain.appname</code>

Example: mvapp link com.ulocate.app.where

The app should now work in the new location thanks to the link. Test each app to make sure it works before doing another. Looping the script to do every app in the dir or to link the entire app dir is not recommended. File attributes are lost on the move, which some apps may need. You need to test each app after a move.

Continue moving apps until it reports that /var.../applications is about 25MB or less.

There is an option to turn on/off tar-based backups. See the BACKUP variable in the script. If set to 1, it will perform a tar backup. This takes up more space on /media but if you need to restore, it puts it back with full file attributes. Recommend keeping this on.

'''To move and link many apps'''

<code>mvapp bulkmv</code>

This will show largest app first, ask if you want to move/link and then moves on to the next largest app. If you answer no to an app, it will skip to the next. Answer 'q' to quit. Is easiest to use this method directly on a device using the Terminal app.

'''To revert the move and delete the link'''

<code>mvapp unlink domain.appname</code>

The application will be moved back to the original directory. File attributes are lost on the move if tar backup is turned off, which some apps may need. You need to test each app after a move. If tar backup is turned on (default - see BACKUP variable in script), file attributes will be restored.

'''To list apps that have been moved and linked...'''

<code>mvapp listmoved</code>

This shows a list of apps that have been moved and linked to /media.

'''To restore all moved apps back to original location'''

<code>mvapp restoreall</code>

If backup was turned on, this will restore ALL applications that have been moved/linked, back to the original location in /var with original attributes (using tar). If backup was not turned on, it will still attempt to move the applications back to /var using the files in /media, but without original file attributes. This may take several minutes to complete. It will show each application progress.

'''To cleanup and remove directories and symlinks'''

<code>mvapp clean domain.appname</code>

If you have any issues, first attempt to remove the app from the App Catalog or Homebrew app installer. Then issue the 'clean' command to remove the applications directories at both locations and also the symlink. You can then reinstall the app from the App Catalog or any Homebrew App installer.

== Contingency Plan==

If you have problems with an application, follow these steps...<br>
-- Close the application if open<br>
-- mvapp unlink domain.appname<br>
-- Try using the App<br>

If the application still does now work correctly...<br>
-- Remove the App using official methods<br>
-- mvapp clean domain.appname<br>
-- Reinstall through the App Catalog or Homebrew installer app<br>

== Proposal to Dev Community ==

This is a formal proposal to the Dev Community suggesting that PreWare, WebOS Quick Install and other Pre installer apps provide an option to move any app in /var to the /media fs and create a link similar to the code above.

The Homebrew Community somewhat created part of the storage problem so needs to come up with their own solution. The symbolic link proponents propose that Homebrew apps be moved with a link to /media/internal by default and physically use /var only if needed (per conditions stated below). The developer would put a flag in the package (or some other method during submission) to state their app is able to run linked to /media or if it specifically needs to physically be on /var. Will propose additions to Packing Standards to support /media links. The homebrew installer apps could then automatically do the move/link if the package is flagged for it.

Candidate apps for moving to /media<br>
- apps that do not depend on file attributes (such as executable bit)<br>
- apps that do not perform data operations to home app directory when device is USB mounted<br>

Exceptions for maintaining apps on /var<br>
- apps that depend on file attributes<br>
- apps that won't work well when device is USB mounted, such as performing data or DB operations in home app directory<br>

(Please update with other known candidates/exceptions)

== Benefits over other methods ==

''Resizing /var'' <br>
One challenge with resizing /var is that it will still have a fixed static limit - how do you decide how much to increase it? Many will still probably hit the limit or waste space if setting too high. There is also the warning from Palm that resizing var may interfere with future updates. The link method allows to dynamically use the /media partition, so there is no need to set a specific size dedicated to apps. If the USB drive is filled, users can decide if they use the space for media or apps on the fly.

''AppPath in /etc/luna.conf'' <br>
I proposed a while back adding an AppPath to luna.conf to include apps stored on /media. Some apps would not work because some apparently reference /var. IE, the vampire/mafia/quest series could not access graphics. The symbolic link fixed this because apps think they are in /var.

''Link/mount [[all]] of /var/usr/palm/applications/ to /media/internal'' <BR>
If some apps rely on file attributes this won't work since file attributes are lost when moved to FAT fs. While this is rare, it probably isn't wise to force all /var apps to /media. Selectively moving apps one at a time is less risky. Update: Have found that "PDF View" app does not allow to be linked, so it appears that selectively moving apps is necessary.

''Creating a loopback filesystem to a virtual file located on /media/internal'' <br>
This has been worked on [http://www.webos-internals.org/wiki/Tutorials_Linux_opt_on_loopback here] and still has potential. Unfortunately it locks out USB mount and media sync altogether. If a workaround can be found with low risk, this may be the most ideal solution.

== Risks, Issues, Dependencies ==

- File attributes of linux fs are not copied over to fat fs. May not work with apps that rely on file attributes. In general, javascript apps will likely work fine located on /media. No one has reported an app (yet) that does not work.

- Some apps may not behave well if USB drive is mounted to computer, though I've tested several that behaved fine. Linux type background services probably would not work well so probably should not be moved. Apps that do IO to the home directory of the app while USB mounted may have issues when located on /media.

- Jason Robitaille has indicated that a future version of WebOS Quick Install will include a routine to resize the /var partition. He has also indicated that doing so will wipe the /media/internal area, so any applications stored there would need to be backed up first. It might be good to be able to reverse the process of this solution. This could be done either by adding to this <code>mvapp</code> script, or creating a new one.

== Future Versions ==

Plans for future versions...

- The script will soon be modified to be friendly for javascript calls... no prompting and no output, just result codes. Will still maintain user interaction capability as well.
== Files Confirmed to Work ==
:com.accuweather.palm
:com.asc.funfactsw
:com.biocandy.prejeweled
:com.bitsofgodsoftware.simplebible
:com.bytesequencing.pre.balls
:com.bytesequencing.pre.spades
:com.cakefight.sudoku
:com.deliciousmorsel.twee
:com.engineequalscar.games.mines
:com.fandango.app.fandango
:com.flixster.app.movies
:com.friendsflow.friendsflowbeta
:com.fusioncreativestudios.deadman
:com.jackintheboxsoftwareinc.app.mobios
:com.landgrabgames.zilch.lite
:com.longbeachit.gototoollite
:com.mediafly.mediafly-pre
:com.mrjspeed.toppleball
:com.myappcatalog.cardmessagesbeta
:com.myappcatalog.guitaristsreference
:com.myappcatalog.superhangmanbeta
:com.orbsix.app.magic8ball
:com.palm.app.agenda
:com.palm.pandora
:com.palm.repomanager
:com.quigley-jones.preopoly
:com.sachersoft.wordwhirllite
:com.splashdata.app.mcraig
:com.stickywhipit.yatz
:com.tj.solitaire
:com.wikihow.wikihowapp
:net.keenstudios.app.checkers
:ws.junk.blocked
:ws.junk.dotgame

== Files Confirmed ''Not'' to Work ==
:com.palm.app.pdfviewer

== Discuss ==
Discuss in the Discussion tab or PreCentral...

http://forums.precentral.net/web-os-development/205649-resolution-app-catalog-install-limit-proposal.html

'''Your Experiences'''

Please post your experiences, good or bad. I'd like to get any kinks worked out before attempting to turn this into a webOS app.

- How many apps did you move? <br>
- Did you find an app that won't work linked? <br>
- Did you move any back? (please test)<br>
- How far down did you have to get /var.../applications down in MB before you could start adding apps from the App Catalog?<br>

== Credits ==
xorg - initially developed script and proposal. maintainer of this page.<br>
daventx - added unlink and clean functions.

Solution to App Catalog Installation Limit

2009-10-09T16:15:01Z

Hparsons:

Based on rwhitby's findings that temporarily moving /var/usr/palm/applications will allow installing apps from the App Catalog, here's a permanent way to keep the apps on (much larger) /media/internal by using links. This will permanently save space on /var.

It's unfortunate that Palm has not resolved the issue in the 1.2 update. This is a tactical workaround that could potentially work long term, also saving space on /var, but this needs support by the homebrew community to add in the homebrew installer apps.

== Overview ==
This solution involves creating a (hidden) directory in the /media/internal area, moving selected applications to the newly created directory, and then creating a symbolic link in the /var/usr/palm/applications directory pointing to the new location. This frees up the disk space from the relatively limited /var volume to the larger /media/internal. The included script (which must be created) will move the files and create the appropriate link. It will also provide information on the size of the applications stored in the /var/usr/palm/applications directory.

== Solution (symbolic link method) ==

Create a script to move apps to new home and create link. You can use an editor or use the following cat command to paste the code, for those not familiar with editors.

Here's how to do it for those comfortable with accessing Linux...

- Enter Linux mode on Pre through a computer (linux commands are in bold)

- Set read/write to allow creating script<br>
<code>'''mount -o remount,rw / '''</code>

- create a script using cat command, paste the code below and then do 'ctrl c' on the keyboard to break out.<br>
<code>'''cat >/usr/bin/mvapp''' </code>

- paste the code below here, press ctrl-c on keyboard to exit after pasting the code.

- when you see a linux prompt, set command to be executable<br>
<code> '''chmod 755 /usr/bin/mvapp''' </code>

----
code:
<pre>
#!/bin/sh

# This code is open for re-use with no restrictions. xorg
# This is a working proof of concept script still in development.
# Intent is for someone to port to a webOS app.
# Use at your own risk.

#-------------------------------------------------------------------------#
# versions:
# 0.1.0 - original (xorg)
# 0.1.1 - added unlink and clean functions (daventx)
# 0.1.2 - added bulkmv function, allows moving many apps (xorg)
# 0.1.3 - added option for tar backups (xorg)
# 0.1.4 - added listmoved function to show apps already moved (xorg)
# 0.1.5 - added restoreall function, couple cleanup items (xorg)
# 0.1.6 - fixed to show usage if no appname supplied to link/unlink (xorg)
# 0.1.7 - added cleanexit (w/mount ro /)
# - added exit code documentation for javascripts calling this (xorg)
#-------------------------------------------------------------------------#

#-------------------------------------------------------------------------#
# variables: these are globally available to all functions
#-------------------------------------------------------------------------#
COMMAND=$1
APP=$2
MEDIA=/media/internal/.apps
VAR=/var/usr/palm/applications

# Backup keeps file attributes but uses more /media space. Recommend doing backups.
BACKUP=1 # set to 1 for tar backups, 0 to disable
BACKUPDIR=/media/internal/.appbackups

#-------------------------------------------------------------------------#
# exit codes for javascripts:
# function usage:
# 1 - normal usage error
#
# function cleanapp:
# 0 - normal exit
#
# function linkapp:
# 10 - app name not supplied
# 11 - link already exists
# 12 - app does not exit in VAR
# 13 - copy failed from VAR to MEDIA
# 14 - removing app from VAR failed
#
# function unlinkapp:
# 20 - app name not supplied
# 21 - app doesn't exit on MEDIA
# 22 - tar restore failed
# 23 - copy failed
# 24 - remove failed
#
#-------------------------------------------------------------------------#

#-------------------------------------------------------------------------#
# function: cleanexit - exit with cleanup items
#-------------------------------------------------------------------------#

cleanexit () {
code=$1

# put / back to read only
mount -o remount,ro /

# Uncomment if you want verbose exit codes
# echo "exit code: $code"

exit $code
}
# end of cleanexit function

#-------------------------------------------------------------------------#
# function: usage - show command usage options
#-------------------------------------------------------------------------#
usage () {
exitcode=$1
if [ ! $exitcode ]
then
exitcode=1 # default exit code for usage, otherwise exit with incode
fi

echo "Usage: mvapp link domain.appname - move app to media and link"
echo "Usage: mvapp unlink domain.appname - restore app to var, remove link"
echo "Usage: mvapp clean domain.appname - remove app dir and links"
echo "Usage: mvapp list - list all apps sorted by size"
echo "Usage: mvapp bulkmv - move/link bulk apps"
echo "Usage: mvapp listmoved - list apps that have been moved"
echo "Usage: mvapp restoreall - restore all apps to original"

cleanexit $exitcode
}
# end of usage function

#-------------------------------------------------------------------------#
# function: cleanapp - removes symbolic links and folder in media and var
#-------------------------------------------------------------------------#

cleanapp () {

mount -o remount,rw /

# exit to usage if no app name supplied
if [ ! $APP ]
then
usage
fi

# Optional
echo "This will remove $APP from both $VAR and $MEDIA."
echo "You should first attempt to remove the app using the official Pre methods."
echo "Are you sure you want to remove $APP? [y/N]: "
read answer
case $answer in
[Yy]*) continue;;
*) cleanexit 0;;
esac

if [ -h $VAR/$APP ]
then
echo "Removing all traces of $APP."
else
echo "$APP does not exist..."
usage 10
fi

echo "Size of $VAR before cleanup... "
du -sh $VAR

if [ -d $MEDIA/$APP ]
then
rm -r $MEDIA/$APP
echo "Removed directory" $MEDIA/$APP
fi
if [ -d $VAR/$APP ]
then
rm -r $VAR/$APP
echo "Removed directory" $VAR/$APP
fi
if [ -L $VAR/$APP ]
then
rm -r $VAR/$APP
echo "Removed link" $VAR/$APP
fi
if [ -f $BACKUPDIR/$APP.tgz ]
then
rm -r $BACKUPDIR/$APP.tgz
echo "Removed tar backup" $BACKUPDIR/$APP.tgz
fi

# rescan luna in case it's needed
luna-send -n 1 palm://com.palm.applicationManager/rescan {} >/dev/null 2>&1
echo "$APP directories and links removed."
echo "Size of $VAR after cleanup... "
du -sh $VAR
cleanexit 0
}
# end of cleanup function

#-------------------------------------------------------------------------#
# function: listapps - list the size of each app, sort showing largest last
#-------------------------------------------------------------------------#
listapps () {
du -s $VAR/* | sort -n
cleanexit 0
}
# end of listapps function

#-------------------------------------------------------------------------#
# function: listmoved - list apps moved/linked, sort showing largest last
#-------------------------------------------------------------------------#
listmoved () {
du -sk $MEDIA/* | sort -n
cleanexit 0
}
# end of listmoved function

#-------------------------------------------------------------------------#
# function: linkapp - move the app to media and create symbolic link
#-------------------------------------------------------------------------#
linkapp () {

if [ ! $APP ]
then
echo "No application supplied..."
usage 10
fi

if [ ! -d $MEDIA ]
then
mkdir $MEDIA
fi

if [ -h $VAR/$APP ]
then
echo "Link already exists for... ${APP}"
cleanexit 11
fi

mount -o remount,rw /

if [ -d $VAR/$APP ]
then
echo "Moving $APP to $MEDIA..."
else
echo "$APP does not exist..."
usage 12
fi

# Backup using tar if enabled
if [ $BACKUP ]
then
if [ ! -d $BACKUPDIR ]
then
mkdir $BACKUPDIR
fi
echo "Backing up $APP to $BACKUPDIR..."
tar czf $BACKUPDIR/${APP}.tgz $VAR/$APP
fi

mount -o remount,rw /

echo "Size of $VAR before move... "
du -sh $VAR

# move over to USB drive
cp -rp $VAR/$APP $MEDIA
if [ $? != 0 ]
then
echo "Copy failed. Leaving app in $VAR."
rm -r $MEDIA/$APP
cleanexit 13
fi

rm -r $VAR/$APP
if [ $? != 0 ]
then
echo "Remove failed. Leaving app in $VAR."
rm -r $MEDIA/$APP
cleanexit 14
fi

# create the symbolic link
ln -s $MEDIA/$APP $VAR/$APP

# rescan luna in case it's needed
luna-send -n 1 palm://com.palm.applicationManager/rescan {} >/dev/null 2>&1

echo "$APP moved and linked."
echo "Size of $VAR after move... "
du -sh $VAR
}
# end of linkapp function

#-------------------------------------------------------------------------#
# function: unlinkapp - restore the app to var and remove symbolic link
#-------------------------------------------------------------------------#
unlinkapp () {

if [ ! $APP ]
then
echo "No application supplied..."
usage 20
fi

mount -o remount,rw /

if [ -d $MEDIA/$APP ]
then
echo "Restoring $APP..."
else
echo "$APP does not exist..."
usage 21
fi

echo "Size of $VAR before move... "
du -sh $VAR

# remove the old symbolic link
rm -r $VAR/$APP

# move to original location or restore from tar if it exists
if [ -f $BACKUPDIR/$APP.tgz ]
then
cd /
tar xzf $BACKUPDIR/$APP.tgz
if [ $? != 0 ]
then
echo "Tar restore failed. Remove and restore app using official webOS/Pre methods."
cleanexit 22
else
rm -r $BACKUPDIR/$APP.tgz
fi
else
cp -r $MEDIA/$APP $VAR
if [ $? != 0 ]
then
echo "Copy failed. Leaving app in $MEDIA."
cleanexit 23
fi
fi

rm -r $MEDIA/$APP
if [ $? != 0 ]
then
echo "Remove failed. Leaving app in $MEDIA."
rm -r $VAR/$APP
cleanexit 24
fi

# rescan luna in case it's needed
luna-send -n 1 palm://com.palm.applicationManager/rescan {} >/dev/null 2>&1

echo "$APP moved and unlinked."
echo "Size of $VAR after move... "
du -sh $VAR
}
# end of unlinkapp function

#-------------------------------------------------------------------------#
# function: bulkvm - move/link many apps
#-------------------------------------------------------------------------#
bulkmv() {
echo
echo
echo "This allows moving many apps, asking which you'd like to move."
echo "Starting with the largest apps."
echo

mount -o remount,rw /
cd $VAR

for i in `du -s * | sort -nr |cut -f 2`
do
export APP=$i
SIZE=`du -sh $APP |cut -f 1`
echo "Size of $APP is $SIZE."
echo "Would you like to move and link $APP ? [y/N/q]: "
read answer
case $answer in
[Yy]*) linkapp;;
[Qq]*) cleanexit 0;;
*) echo "$APP not moved."
continue;;
esac

echo
done
}
# end of bulkmv function

#-------------------------------------------------------------------------#
# function: restoreall - restore all apps, back to /var
#-------------------------------------------------------------------------#
restoreall() {
echo "This will restore all applications back to original location"
echo "and remove the links. Are you sure you want to continue? [y/N]:"
read answer
case $answer in
[Yy]*) continue;;
*) cleanexit 0;;
esac

ls $MEDIA | while read APP
do
echo "Restoring $APP and unlinking..."
unlinkapp
done
}
# end of restoreall function

#-------------------------------------------------------------------------#
# main - begins here
#-------------------------------------------------------------------------#

case $COMMAND in
"clean")
cleanapp
;;
"list")
listapps
;;
"listmoved")
listmoved
;;
"link")
linkapp
;;
"unlink")
unlinkapp
;;
"bulkmv")
bulkmv
;;
"restoreall")
restoreall
;;
*)
usage 0
;;
esac

cleanexit 0

</pre>

----

- Be sure to set execute permissions if you missed the step above...
<code>chmod 755 /usr/bin/mvapp</code>

== Precautions ==

So far, no one has reported an app that has issues due to linking. These are best practices to avoid issues.

- Be selective about what you move. You may not want to move apps that store important information to you such as password lockers, memo apps, EverNote, Agenda, etc. Games, web content apps and information viewing apps should be safer to move as there is no data at risk.

- Close apps before moving them. Do not move an app while it is open and running. I actually tested this and figured some apps would break but none have yet. It is still not wise to move apps while they are open and running.

== Commands ==

'''To find the largest apps in /var/usr/palm/applications'''

<code>mvapp list</code>

It shows the largest apps last... IE....<br>
<code>
8352 com.apnews.webos<br>
8512 com.fandango.app.fandango<br>
8672 com.palm.app.musicplayerremix<br>
10304 com.shortcovers.palm.pre<br>
10432 com.fusioncreativestudios.deadman<br>
10656 com.ulocate.app.where<br>
</code>

'''To move and link an app to /media'''

<code>mvapp link domain.appname</code>

Example: mvapp link com.ulocate.app.where

The app should now work in the new location thanks to the link. Test each app to make sure it works before doing another. Looping the script to do every app in the dir or to link the entire app dir is not recommended. File attributes are lost on the move, which some apps may need. You need to test each app after a move.

Continue moving apps until it reports that /var.../applications is about 25MB or less.

There is an option to turn on/off tar-based backups. See the BACKUP variable in the script. If set to 1, it will perform a tar backup. This takes up more space on /media but if you need to restore, it puts it back with full file attributes. Recommend keeping this on.

'''To move and link many apps'''

<code>mvapp bulkmv</code>

This will show largest app first, ask if you want to move/link and then moves on to the next largest app. If you answer no to an app, it will skip to the next. Answer 'q' to quit. Is easiest to use this method directly on a device using the Terminal app.

'''To revert the move and delete the link'''

<code>mvapp unlink domain.appname</code>

The application will be moved back to the original directory. File attributes are lost on the move if tar backup is turned off, which some apps may need. You need to test each app after a move. If tar backup is turned on (default - see BACKUP variable in script), file attributes will be restored.

'''To list apps that have been moved and linked...'''

<code>mvapp listmoved</code>

This shows a list of apps that have been moved and linked to /media.

'''To restore all moved apps back to original location'''

<code>mvapp restoreall</code>

If backup was turned on, this will restore ALL applications that have been moved/linked, back to the original location in /var with original attributes (using tar). If backup was not turned on, it will still attempt to move the applications back to /var using the files in /media, but without original file attributes. This may take several minutes to complete. It will show each application progress.

'''To cleanup and remove directories and symlinks'''

<code>mvapp clean domain.appname</code>

If you have any issues, first attempt to remove the app from the App Catalog or Homebrew app installer. Then issue the 'clean' command to remove the applications directories at both locations and also the symlink. You can then reinstall the app from the App Catalog or any Homebrew App installer.

== Contingency Plan==

If you have problems with an application, follow these steps...<br>
-- Close the application if open<br>
-- mvapp unlink domain.appname<br>
-- Try using the App<br>

If the application still does now work correctly...<br>
-- Remove the App using official methods<br>
-- mvapp clean domain.appname<br>
-- Reinstall through the App Catalog or Homebrew installer app<br>

== Proposal to Dev Community ==

This is a formal proposal to the Dev Community suggesting that PreWare, WebOS Quick Install and other Pre installer apps provide an option to move any app in /var to the /media fs and create a link similar to the code above.

The Homebrew Community somewhat created part of the storage problem so needs to come up with their own solution. The symbolic link proponents propose that Homebrew apps be moved with a link to /media/internal by default and physically use /var only if needed (per conditions stated below). The developer would put a flag in the package (or some other method during submission) to state their app is able to run linked to /media or if it specifically needs to physically be on /var. Will propose additions to Packing Standards to support /media links. The homebrew installer apps could then automatically do the move/link if the package is flagged for it.

Candidate apps for moving to /media<br>
- apps that do not depend on file attributes (such as executable bit)<br>
- apps that do not perform data operations to home app directory when device is USB mounted<br>

Exceptions for maintaining apps on /var<br>
- apps that depend on file attributes<br>
- apps that won't work well when device is USB mounted, such as performing data or DB operations in home app directory<br>

(Please update with other known candidates/exceptions)

== Benefits over other methods ==

''Resizing /var'' <br>
One challenge with resizing /var is that it will still have a fixed static limit - how do you decide how much to increase it? Many will still probably hit the limit or waste space if setting too high. There is also the warning from Palm that resizing var may interfere with future updates. The link method allows to dynamically use the /media partition, so there is no need to set a specific size dedicated to apps. If the USB drive is filled, users can decide if they use the space for media or apps on the fly.

''AppPath in /etc/luna.conf'' <br>
I proposed a while back adding an AppPath to luna.conf to include apps stored on /media. Some apps would not work because some apparently reference /var. IE, the vampire/mafia/quest series could not access graphics. The symbolic link fixed this because apps think they are in /var.

''Link/mount [[all]] of /var/usr/palm/applications/ to /media/internal'' <BR>
If some apps rely on file attributes this won't work since file attributes are lost when moved to FAT fs. While this is rare, it probably isn't wise to force all /var apps to /media. Selectively moving apps one at a time is less risky. Update: Have found that "PDF View" app does not allow to be linked, so it appears that selectively moving apps is necessary.

''Creating a loopback filesystem to a virtual file located on /media/internal'' <br>
This has been worked on [http://www.webos-internals.org/wiki/Tutorials_Linux_opt_on_loopback here] and still has potential. Unfortunately it locks out USB mount and media sync altogether. If a workaround can be found with low risk, this may be the most ideal solution.

== Risks, Issues, Dependencies ==

- File attributes of linux fs are not copied over to fat fs. May not work with apps that rely on file attributes. In general, javascript apps will likely work fine located on /media. No one has reported an app (yet) that does not work.

- Some apps may not behave well if USB drive is mounted to computer, though I've tested several that behaved fine. Linux type background services probably would not work well so probably should not be moved. Apps that do IO to the home directory of the app while USB mounted may have issues when located on /media.

- Jason Robitaille has indicated that a future version of WebOS Quick Install will include a routine to resize the /var partition. He has also indicated that doing so will wipe the /media/internal area, so any applications stored there would need to be backed up first. It might be good to be able to reverse the process of this solution. This could be done either by adding to this <code>mvapp</code> script, or creating a new one.

== Future Versions ==

Plans for future versions...

- The script will soon be modified to be friendly for javascript calls... no prompting and no output, just result codes. Will still maintain user interaction capability as well.
== Files Confirmed to Work ==
:com.accuweather.palm
:com.asc.funfactsw
:com.biocandy.prejeweled
:com.bitsofgodsoftware.simplebible
:com.bytesequencing.pre.balls
:com.bytesequencing.pre.spades
:com.cakefight.sudoku
:com.deliciousmorsel.twee
:com.engineequalscar.games.mines
:com.fandango.app.fandango
:com.flixster.app.movies
:com.friendsflow.friendsflowbeta
:com.fusioncreativestudios.deadman
:com.jackintheboxsoftwareinc.app.mobios
:com.landgrabgames.zilch.lite
:com.longbeachit.gototoollite
:com.mediafly.mediafly-pre
:com.mrjspeed.toppleball
:com.myappcatalog.cardmessagesbeta
:com.myappcatalog.guitaristsreference
:com.myappcatalog.superhangmanbeta
:com.orbsix.app.magic8ball
:com.palm.app.agenda
:com.palm.pandora
:com.palm.repomanager
:com.quigley-jones.preopoly
:com.sachersoft.wordwhirllite
:com.splashdata.app.mcraig
:com.stickywhipit.yatz
:com.tj.solitaire
:com.wikihow.wikihowapp
:net.keenstudios.app.checkers
:ws.junk.blocked
:ws.junk.dotgame

== Files Confirmed ''Not'' to Work ==

== Discuss ==
Discuss in the Discussion tab or PreCentral...

http://forums.precentral.net/web-os-development/205649-resolution-app-catalog-install-limit-proposal.html

'''Your Experiences'''

Please post your experiences, good or bad. I'd like to get any kinks worked out before attempting to turn this into a webOS app.

- How many apps did you move? <br>
- Did you find an app that won't work linked? <br>
- Did you move any back? (please test)<br>
- How far down did you have to get /var.../applications down in MB before you could start adding apps from the App Catalog?<br>

== Credits ==
xorg - initially developed script and proposal. maintainer of this page.<br>
daventx - added unlink and clean functions.

Talk:Solution to App Catalog Installation Limit

2009-10-05T00:22:45Z

Hparsons: /* Versioning */

== Modified the APP variable in the script ==

Modified the script to change<br>
<code>APP=$1</code><br>
to<br>
<code>APP=/var/usr/palm/applications/$1</code><br>
I'm no script writer, and wouldn't normally change someone else's code, but the script did not work as originally written unless you were already in that directory. I tested it with the changes, and it works properly now.

--[[User:Hparsons|Herb]] 14:31, 30 September 2009 (UTC)

Not sure why it didn't work for you as your change didn't work for me. Are you using a different shell? I added a line to force #!/bin/sh and altered the code back with a note about your change.

--[[User:Xorg|Xorg]] 03:12, 1 October 2009 (UTC)

My bad. The way the code was originally formatted, I couldn't cut and paste, and when entering it, I somehow missed the <code>cd $ORG</code> command. You're right, it should (and does) work in the original format.

--[[User:Hparsons|Herb]] 06:01, 1 October 2009 (UTC)

== Changing app directory to .app ==

I had noticed that with the 1.2 update, all of the graphics on the USB directory were being scanned as if they were photos. This was pretty much a mess, and hand planned on coming back here to suggest that the "app" directory be changed to ".app" so it would be hidden. I noticed the altered code already had that change, but the original intro did not. Assuming this was the intent, I changed that.

--[[User:Hparsons|Herb]] 14:36, 30 September 2009 (UTC)

== Restructured script to use functions ==

I've restructured the script to use functions. This allows anyone to post in their own functions and additional features.

--[[User:Xorg|Xorg]] 19:50, 2 October 2009 (UTC)

== Suggestion for the script ==

Perhaps in preparation for the "unlink" command, the "link" command can also create a full backup of the app (.tgz) which will contain the full permissions and any symbolic links that will be lost when copying the app to the /media/internal/.apps directory. That way if we find that the app does not run correctly from the linked version on /media/internal/.apps, we can restore it fully to /var with no loss of data.

--[[User:Plee3|plee3]] 21:46, 2 October 2009 (UTC)

== Versioning ==

Possibly could those modifying the script start using some sort of versioning, with the version at the front of the script, with information about what the new version does added to the main article page?

--[[User:Hparsons|Herb]] 00:22, 5 October 2009 (UTC)

Talk:Solution to App Catalog Installation Limit

2009-10-05T00:22:33Z

Hparsons: New section: Versioning

Solution to App Catalog Installation Limit

2009-10-02T18:00:39Z

Hparsons: /* Risks, Issues, Dependencies */

Solution to App Catalog Installation Limit

2009-10-02T17:50:14Z

Hparsons:

Talk:Solution to App Catalog Installation Limit

2009-10-01T06:01:49Z

Hparsons:

Talk:Solution to App Catalog Installation Limit

2009-09-30T14:36:42Z

Hparsons: New section: Changing app directory to .app

Talk:Solution to App Catalog Installation Limit

2009-09-30T14:34:04Z

Hparsons: New section: Modified the APP variable in the script

Talk:Solution to App Catalog Installation Limit

2009-09-30T14:33:30Z

Hparsons: Removing all content from page

Solution to App Catalog Installation Limit

2009-09-30T14:32:33Z

Hparsons:

Talk:Solution to App Catalog Installation Limit

2009-09-30T14:31:25Z

Hparsons: New page: Modified the script to change<br> <code>APP=$1</code><br> to<br> <code>APP=/var/usr/palm/applications/$1</code><br> I'm no script writer, and wouldn't normally change someone else's code, ...

Modified the script to change<br>
<code>APP=$1</code><br>
to<br>
<code>APP=/var/usr/palm/applications/$1</code><br>
I'm no script writer, and wouldn't normally change someone else's code, but the script did not work as originally written unless you were already in that directory. I tested it with the changes, and it works properly now.

--[[User:Hparsons|Herb]] 14:31, 30 September 2009 (UTC)

Solution to App Catalog Installation Limit

2009-09-30T14:27:39Z

Hparsons:

Solution to App Catalog Installation Limit

2009-09-30T05:59:50Z

Hparsons:

Talk:Patch Phone Edit Dialer Theme

2009-09-29T18:52:58Z

Hparsons:

===Skinning===
Its seems like this method of "skinning" could be simplified and applied to all applications. Obviously I dont think we are at the point of changing the themes live from within the phone, but until then there could at least be a directory hosted that has app skins, or maybe use the quilt directory.

If the default skin was included with all the user created skins, all you would need to do is tar up the skins, and extract them into the directory overwriting the existing png files. Users could then grab the default from the site if they want to revert. essentially cuts the time, and ease down to 2 commands. copy the tar to / and extract. Done. The best part is you could apply this to files other than png's too. Say you wanted to make a skin for the mail app that changes the app colors to dark shades with a white or light colored font, you could override the existing files ( js, css, xml, etc).

The only conflict i see is if you get into the realm of multiple patches for the same app that touch the same file. Does quilt manage this/have some kind of smart merge functionality?
===WebOS 1.2===
What has changed in the dialer themes in WebOS 1.2? If you use any of the previous themes, when you go to the phone call list, the fader is incorrect; however, none of the sizes changed, and looking at the images, I can't see what the changed entailed; however, they now don't work correctly. Anyone have any clues?

--[[User:Hparsons|Herb]] 18:52, 29 September 2009 (UTC)

Talk:Patch Enable LED Notifications

2009-09-29T18:46:17Z

Hparsons:

Interesting. Did
''/usr/palm/applications/com.app.screenlock''
become
''/usr/palm/applications/com.'''palm'''.app.screenlock''
after the original leaked WebOSDoctor, or was that just a typo in the original?

--[[User:Hparsons|Herb]] 18:44, 29 September 2009 (UTC)

Talk:Patch Enable LED Notifications

2009-09-29T18:45:17Z

Hparsons:

Interesting. Did
'''/usr/palm/applications/com.app.screenlock'''
become
'''/usr/palm/applications/com.palm.app.screenlock'''
after the original leaked WebOSDoctor, or was that just a typo in the original?

--[[User:Hparsons|Herb]] 18:44, 29 September 2009 (UTC)

Talk:Patch Enable LED Notifications

2009-09-29T18:44:57Z

Hparsons: New page: Interesting. Did '''/usr/palm/applications/com.app.screenlock''' become '''/usr/palm/applications/com.palm.app.screenlock''' after the original leaked WebOSDoctor, or was that just a typo ...

Interesting. Did
'''/usr/palm/applications/com.app.screenlock'''
become
'''/usr/palm/applications/com.palm.app.screenlock'''
after the original leaked WebOSDoctor, or was that just a typo in the original
--[[User:Hparsons|Herb]] 18:44, 29 September 2009 (UTC)

Patch Enable LED Notifications

2009-09-29T18:39:39Z

Hparsons:

This patch needs a rooted Pre to manually make these changes though a command line.

Two files need to be modified.

/usr/palm/applications/com.palm.app.screenlock/app/controllers/securityconfig-assistant.js

Uncomment lines 54,55,248-251.

Here is what the files should look like:
<source lang=text>
Lines 54/55:
//this.controller.setupWidget('blinkAlerts', this.onOffToggleOpt, this.ledThrobberToggleModel);
//Mojo.Event.listen($('blinkAlerts'),'mojo-property-change', this.toggleLEDThrobber.bindAsEventListener(this));

Should be changed to:
this.controller.setupWidget('blinkAlerts', this.onOffToggleOpt, this.ledThrobberToggleModel);
Mojo.Event.listen($('blinkAlerts'),'mojo-property-change', this.toggleLEDThrobber.bindAsEventListener(this));
</source>

<source lang=text>
Lines 248-251:
/*if (payload.LEDThrobberEnabled != undefined) {
this.ledThrobberToggleModel.value = payload.LEDThrobberEnabled;
this.controller.modelChanged(this.ledThrobberToggleModel, this);
}*/

Should be changed to:
if (payload.LEDThrobberEnabled != undefined) {
this.ledThrobberToggleModel.value = payload.LEDThrobberEnabled;
this.controller.modelChanged(this.ledThrobberToggleModel, this);
}

</source>

/usr/palm/applications/com.palm.app.screenlock/app/views/securityconfig/securityconfig-scene.html:

Uncomment 92-97 and 101-103.

<source lang=text>
Lines 92-97:


Should be changed to:
<div class="palm-row last">
<div class="palm-row-wrapper">
<div x-mojo-element="ToggleButton" id="blinkAlerts"></div>
<div class="title capitalize" x-mojo-loc=''>Blink notifications</div>
</div>
</div>

</source>

<source lang=text>
Lines 101-103:


Should be changed to:
<div class="palm-info-text single" x-mojo-loc=''>
The gesture area blinks when new notifications arrive.
</div>
</source>

Talk:Update 1.2.0

2009-09-06T08:31:44Z

Hparsons:

Could I get some others to verify the information about Quick Install not working? I used it to install File Coaster on my Pre with 1.2, and it worked.<br>
--[[User:Hparsons|Herb]] 08:31, 6 September 2009 (UTC)

Talk:Update 1.2.0

2009-09-06T08:31:22Z

Hparsons:

Could I get some others to verify the information about Quick Install not working? I used it to install File Coaster on my Pre with 1.2, and it worked.
--[[User:Hparsons|Herb]] 08:31, 6 September 2009 (UTC)

Talk:Update 1.2.0

2009-09-06T08:31:05Z

Hparsons: New page: Could I get some others to verify the information about Quick Install not working? I used it to install File Coaster on my Pre with 1.2, and it worked.

Could I get some others to verify the information about Quick Install not working? I used it to install File Coaster on my Pre with 1.2, and it worked.

Update 1.2.0

2009-09-06T08:29:37Z

Hparsons:

Put all information about Update 1.2 here, including changes made, current development ideas, etc.

== Disabled ==
* A vary of patches including the OnScreen Keyboard.
* Flashlight app does not work anymore.
* All of the messaging mods, patches, and edits don't work anymore. However, thing such as forwarding a message, you can copy-paste to forward.
* Latest version of Quick Install does not recognize the Pre.

== Changes ==

* Find-as-you-type search support in Email
* App Catalog updated to support purchasing apps
* Web browser enhanced
* auto zooms to forms
* download in browser enabled (including opening pdfs)
* better rendering of mobile pages
* Orange+click context menu on links
* save images
* "Real" copy and paste
* shift tap to select areas of text in the browser allows for copy and paste.
* Select All option in Edit menu
* Save images in browser(Not GIF, assuming JPG and PNG only, Orange+click to do this)
* Clock app allows you to turn off alarms when mute switch is on
* The full Facebook page now saves your login info, and is much easier to use because of auto zooming to text boxes
* Speed increases across the board, notifications are much snappier
* Dialer is snappy, minimal to no lag on anything
* Selecting text and scrolling through text boxes is smoother, more accurate, and selects full words now
* Can now disable Data(EVDO) and use WiFi in conjunction with standard voice service(Major battery saver, though there is an issue with it, you cannot make WiFi stay active when the screen is off and the phone isn't plugged in)
* Can now copy entire conversations in Messager
* Displays phone number when using the phone, instead of just Mobile or Home etc
* If you are on the main screen or launcher.. in you press gesture+v to paste, it will start a global search with whatever you pasted.
* Tasks now gives the option to sort in "My Order" (how things were entered), by due date, or priority.
* Email search, though it only searches subject and sender right now
* No more having to manually link AIM contacts to people if you already have that AIM name in the Google profile
* The default Pre Ringtone has changed
* Text Notifications now include a contact picture
* Pinch to expand emails has been removed.
* Updated mojo framework (200.18) on 1.1 it was 191.15(Probably responsible for the performance increases across the board)
* Sprint Configuration is now v1.8
* There is a "Send all to Car Kit" option in the Contacts Application now
* Calendar now has additional preference setting for "Calendar View Options" to set the color of your calendars and to show them in the "All Calendars" view.

If you find anything missing your are welcome to add it.

== Troubleshooting ==

== Package Manifest ==

Update 1.2.0

2009-09-05T21:54:51Z

Hparsons: My change was incorrect. The phone wasn't seated properly.

Put all information about Update 1.2 here, including changes made, current development ideas, etc.

== Disabled ==

== Changes ==

== Troubleshooting ==

== Package Manifest ==

Update 1.2.0

2009-09-05T21:48:18Z

Hparsons: /* Changes */

Put all information about Update 1.2 here, including changes made, current development ideas, etc.

== Disabled ==

== Changes ==
* It appears that the device "goes to sleep" even when on the Touchstone.

== Troubleshooting ==

== Package Manifest ==

Portal:Patches to webOS

2009-09-05T21:44:32Z

Hparsons:

__notoc__
{{portal-header
|This page lists patches to webOS existing apps which modify the behavior as shipped. '''Note''' that these patches may be version specific and may be broken by future webOS updates. Proceed with caution. If you get one that works please move it under the correct column, alphabetically, and title the page:
'''"Patch [application] [description]"''' (for application specific patches) <br>
'''"Patch webOS [description]"''' (for patches not part of a specific application)
}}
This page is undergoing structuring please contribute moving or adding new entries under the appropriate headings. For now put pages in alphabetical order. Each page should contain at least the basic headings
*1. '''Introduction''': A brief description to introduce people to the patch.
**1.1 '''Usage''':An explanation if it is needed on how to use the modification see Add/Delete Pages in the Launcher as an example.
*2. '''Editing Process''': Step by step instructions to manually edit.
*3. '''Patching Process''': Details for making the edits with a patch file and pointing people to the [[Applying Patches]] page if the patch is also provided in the webos-internals gitorious repository.

{{portal-three-columns
|column1=
===webOS Update Information===
* [[Update 1.2.0|Update 1.2]]<br>'''''Note''' ''the 1.2 update is not official yet, but has been "leaked"''
* [[Update 1.1.0|Update 1.1]]
* [[Update 1.0.4|Update 1.0.4]]
* [[Update 1.0.3|Update 1.0.3]]

===Patches that Need Work===
* [[Bugs]]

|column2=
===Patch Ideas to be Created or in Progress===

* [[More_Calculator_Functions|Accessing additional built-in calculator functions]]
* [[Add_Ability_To_Choose_Snooze_Length|Add Ability to Choose Snooze Length]]
* [[Add_Icon_To_Quick_Launcher|Add an icon to the quick launcher]]
* [[Changing Clipboard Data From The Shell|Changing Clipboard Data from the Shell]]
* [[Development_%26_Tweak_Ideas | Development & Tweaking Ideas]]
* [[Longer Vibrate|Longer Vibrate]]

|column3=
===Notes===
These modifications lack a patch process, please add one to the details to the page and have it added to the webOS-internals gitorious repository. Info for the repository is on [[Applying Patches]].

*Empty
}}
{{portal-three-columns
|column1=
==Patches to webOS apps==
===webOS 1.1 OK===

* [[Patch Amazon Download Music over EVDO|Amazon: Download Music over EVDO]]
* [[Patch Browser Global Search Addons|Browser: Global Search Addons]]
* [[Patch Browser Delete Individual History Items|Browser: Delete Individual History Items]]
* [[Patch Browser Downloading Files|Browser: Downloading Files]]
* [[Patch Calendar Show All-Day Events in Month View|Calendar: Show All-Day Events in Month View]]
* [[Patch Camera 10 Second Countdown Timer|Camera: 10 Second Countdown Timer]]
* [[Patch Camera Shutter Sound On-Off Button|Camera: Shutter Sound On-Off Button]]
* [[Patch Camera Using Volume Buttons to Take a Picture|Camera: Using Volume Buttons to Take a Picture]]
* [[Patch Clock Changing Alarm Button Order and Snooze Duration|Clock: Changing Alarm Button Order and Snooze Duration]]
* [[Patch Clock Enabling the Hidden Theme|Clock: Enabling the Hidden Theme]]
* [[Patch Email Change "Running Late" Message|Email: Change "Running Late" Message]]
* [[Patch Email Confirm Deletion|Email: Confirm Deletion]]
* [[Patch Email Change Default Font for Replies-Forwards from Navy to Black|Email: Change Default Font for Replies/Forwards from Navy to Black]]
* [[Patch Email DeleteAll|Email: Delete All]]
* [[Patch Launcher Add or Delete Pages|Launcher: Add/Delete Pages]]
* [[Patch Launcher To Allow More Icons Per Row|Launcher: Allows More Icons Per Row]]
* [[Patch Launcher Hide-Delete The NASCAR App|Launcher: Hide/Delete The NASCAR App]]
* [[Patch Launcher Hide Media Sync Option|Launcher: Hide Media Sync Option]]
* [[Patch Launcher Reset Scroll on Page Change|Launcher: Reset Scroll on Page Change]]
* [[Patch Launcher Unhide the DeveloperMode App|Launcher: Unhide the DeveloperMode App]]
* [[Patch Messaging Adding Timestamps to All Received Messages|Messaging: Adding Timestamps to All Received Messages]]
* [[Patch Messaging Change "Enter Key" To Create Newline|Messaging: Change "Enter Key" To Create Newline]]
* [[Patch Messaging Character Counter|Messaging: Character Counter]]
* [[Patch Messaging Display Full Status Messages|Messaging: Display Full Status Messages]]
* [[Patch Messaging Force Offline Send Without Dialog|Messaging: Force Offline Send Without Dialog]]
* [[Patch Messaging Forward Messages|Messaging: Forward Messages]]
* [[Patch Messaging Jump Forward, Backward One Word at a Time|Messaging: Jump Forward, Backward One Word at a Time]]
* [[Patch Messaging Landscape Orientation|Messaging: Landscape Orientation]]
* [[Patch Messaging Sounds|Messaging: Message Sound]]
* [[Patch Messaging New Cards For Each Conversation|Messaging: New Cards For Each Conversation]]
* [[Patch MCraig Enabling Personals Category|mCraig: Enabling Personals Category]]
* [[Patch MediaPlayer Bookmarking|Music Player: Bookmarking]]
* [[Patch MediaPlayer Ignore 'A', 'An', and 'The' In Artist and Album names|Music Player: Ignore 'A', 'An', and 'The' in Artist and Album Names]]
* [[Patch PDF Viewer Change Orientation|PDF Viewer: Change Orientation]]
* [[Patch Phone Disable Various Call Sounds|Phone: Disable Various Call Sounds]]
* [[Patch Phone Edit Dialer Theme|Phone: Edit Dialer Theme]]
* [[Patch Phone Editing the Lock Screen|Phone: Editing the Lock Screen]]
* [[Patch Phone Show Call Duration in the Call Log|Phone: Show Call Duration in the Call Log]]
* [[Patch Tasks Always Show Details of New Tasks|Tasks: Always Show Details of New Tasks]]
* [[Patch WebOS Bypassing Lock Screen|Unlock: Bypass the Passcode Entry Screen]]

===Fixed in 1.1 - No longer needed===
* [[Patch Email Fix Broken Formatting|Email: Fix Broken Formatting for E-mails]]

===Not 1.1 compatible===
* [[Patch Camera Remote View|Camera: Remote View]]
* [[Patch Email Enable Landscape Viewing|Email: Enable Landscape Viewing]]
* [[Patch Email Fix Attachments|Email: Fix Attachments]]
* [[Patch Sudoku Disable Zooming|Sudoku: Disable Zooming]]

|column2=
==Patches not part of a specific app==
===webOS 1.1 OK===
* [[Patch webOS Boot Themes|Boot Themes]]
* [[Patch webOS Brightness|Brightness]]
* [[Patch webOS Bypassing Activation|Bypassing Activation]]
* [[Patch webOS Change Carrier String|Change Carrier String]]
* [[Change_the_default_notification.wav_Sound|Change the Default notification.wav Sound]]
* [[Patch webOS Changing the "Turn off after X" time|Changing the "Turn off after X" Time]]
* [[Patch webOS CPU Frequency or Voltage Scaling|CPU Frequency or Voltage Scaling]]
* [[Patch webOS Disable Charging Event Sounds|Disable Charging Event Sounds]]
* [[Patch webOS GPS Tracking|GPS Tracking]]
* [[Patch webOS Graphics|Graphics]]
* [[Patch webOS Hourly Chime|Hourly Chime]]
* [[Patch webOS Turning Off Dialpad Noise|Turning Off Dialpad Noise]]
* [[Patch webOS Keep Phone Awake While in Remote Session|Keep Phone Awake While in Remote Session]]
* [[Patch webOS Logging Information from Within Scripts|Logging Information from Within Scripts]]
* [[Patch webOS Modifying a Stock App While Keeping the Original|Modifying a Stock App While Keeping the Original]]
* [[Patch webOS Add Words to AutoCorrect Dictionary|Modify AutoCorrect Dictionary]]
* [[On Screen Keyboard]]
* [[Patch webOS Radio Power Switch|Radio Power Switch]]
* [[Patch webOS Random Wallpaper Switching|Random Wallpaper Switching]]
* [[Patch webOS Reverse Tunnel|Reverse Tunnel]]
* [[Patch webOS Roam Control|Roam Control]]
* [[Patch webOS Show Actual Battery Percentage | Show Actual Battery Percentage]]
* [[Screenlock On When Connected|Stay On While Connected]]
* [[Make USB Partition Writable via SFTP|Make USB Partition writable via SFTP]]

===Fixed in 1.1 - No longer needed===
* Empty

===Not 1.1 compatible===
* [[Patch webOS Email App Patch to Prompt for IPK Installation|Email App Patch to Prompt for IPK Installation]]

|column3=
==== The following have not been checked for compatibility with webOS 1.1. ====

* [[Browser_Plugins|Browser Plugins]]
* [[Camera Mod Alternate Sound Disable]]
* [[Changes_Alert/Notification_Sounds|Changes Alert/Notification Sounds]]
* [[Myavatar In Messaging App|Myavatar In Messaging App]]
* [[Photos Slideshow|Photos Slideshow]]

==== The following are deprecated. They have been replaced with methods which are easier or are moot in 1.1 ====

* [[Installing Homebrew Apps With A Rooted Pre|Installing Homebrew Apps With A Linux Accessed Pre]]
* [[Packaging Homebrew Apps for Stock Pre without Rooting|Packaging Homebrew Apps for Stock Pre without Accessing Linux]]
* [[Modifying Stock Applications|Modifying Stock Applications]]

}}

Update 1.2.0

2009-09-05T21:40:56Z

Hparsons: New page: Put all information about Update 1.2 here, including changes made, current development ideas, etc. == Disabled == == Changes == == Troubleshooting == == Package Manifest ==

Put all information about Update 1.2 here, including changes made, current development ideas, etc.

== Disabled ==

== Changes ==

== Troubleshooting ==

== Package Manifest ==

Talk:Patch webOS GPS Tracking

2009-08-18T14:42:39Z

Hparsons:

Another Idea to use this hack with would be to save your current location to a file throughout a poling period, and then using that info to geotag photos taken with a camera. (Other than the Pre's obviously).

Did we lose some information in moving this from one site to another? I see information about enabling cron, but it's only a link. I don't see the information about how cron relates to this script. I seem to remember previously, you called the script every 5 minutes, but not sure.
[[User:Hparsons|Herb]]

I saw no response on this, so I did some comparisons and found the deleted cron entry (5 minutes), and readded it.
[[User:Hparsons|Herb]]

Talk:Patch webOS GPS Tracking

2009-08-13T22:27:49Z

Hparsons:

Another Idea to use this hack with would be to save your current location to a file throughout a poling period, and then using that info to geotag photos taken with a camera. (Other than the Pre's obviously).

Did we lose some information in moving this from one site to another? I see information about enabling cron, but it's only a link. I don't see the information about how cron relates to this script. I seem to remember previously, you called the script every 5 minutes, but not sure.

I saw no response on this, so I did some comparisons and found the deleted cron entry (5 minutes), and readded it.

Patch webOS GPS Tracking

2009-08-13T22:24:46Z

Hparsons: This corrects the omissin of the entry in the "root" crontab

{{template:patch}}
Here is my super happy awesome tracker script!

== Script code ==
<pre><nowiki>
SECRET=make up any secret code here
DEST=put your e-mail address here

track()
{
export IFS=$'\n'
for loc in $(luna-send -n 3 palm://com.palm.location/startTracking '{"appId": "ILovePalm", "subscribe": true}' 2>&1); do
send $(echo $loc|cut -f3- -d,)
done
}

send()
{
echo "Sending Message: $1"
msg=$(echo $1| sed s/\"/\\\\\"/g)
luna-send -n 1 palm://com.palm.messaging/sendMessageFromCompose '{"recipientJSONArray": [{"value": "'${DEST}'", "contactDisplay": "'${DEST}'", "prefix": "to$A", "identifier": "palm_anon_element_8"}], "messageText": "'"$msg"'"}'
}

checkmsg()
{
echo ".timeout 30000" > /tmp/trackersql
cmd='SELECT messageText FROM com_palm_pim_FolderEntry WHERE timeStamp > (strftime("%s000", "now")-600000);'
# output=$(echo $cmd|sqlite3 /var/luna/data/dbdata/PalmDatabase.db3)
output=$(echo $cmd|sqlite3 -init /tmp/trackersql /var/luna/data/dbdata/PalmDatabase.db3)
echo $output|grep $SECRET 2> /dev/null > /dev/null
status=$?

if [ $status = 0 ]; then
track
fi
}

checkmsg

</nowiki></pre>

== Installation==
# mkdir -p /home/scripts
# Let's say you put the script in /home/scripts/track.sh
# rootfs_open -w
# Go [[Crond | here ]] to enable crond.
# Add the following line to /etc/cron/crontabs/root<pre><nowiki>*/5 * * * * /home/scripts/track.sh</nowiki></pre>
# Now just send the secret code you set in the script to $YOURNUMBER@messaging.sprintpcs.com (without dollar sign but as a ten digit number with area code prefix)
> Ex: 3335554444@messaging.sprintpcs.com where 333 is your area code, and 5554444 the rest of your phone number.
and it will send $DEST the GPS data for the device.

Now, just take the latitude and longitude data and generate the URL. As to the other GPS parameter data available we'll have to investigate to see if Google Maps can take those parameters and how they map to the URL. ~Robi

<pre><nowiki>
luna-send -n 1 palm://com.palm.location/getCurrentPosition {}
** Message: serviceResponse Handling: 2, {"errorCode":0,"timestamp":1.245799702311E12,"latitude":37.48660683631897,"longitude":-122.23269581794739,"horizAccuracy":37.947330474853516,"heading":178,"velocity":0.75,"altitude":-13,"vertAccuracy":24}
</nowiki></pre>

which means we can transpose some of that to a Google Maps link:

<pre><nowiki>
http://maps.google.com/?ie=UTF8&q=37.48660683631897,-122.23269581794739+(Heading:%20178%0DSpeed:%200.75%20mph)
</nowiki></pre>

If you know more about the GPS parameters, let us know by updating the page. ~Robi

* Added heading and speed parameters to the URL. If you hover over the pinpoint on the google map, you can see the information, as well as in the info window if you click on the pinpoint. -xluryan

"If [ll=] is used without a query, then the map is centered at the point but no marker or info window is displayed." To get around this, use q=[Lon,Lat] instead of ll=[Lon,Lat]. I changed the maps link above. -hopspitfire

'''Troubleshooting Tip:''' Make sure track.sh has the correct file permissions set. To encompass all possibilities, try 'chmod 755 /home/scripts/track.sh'. You can restrict permissions later if you wish. On Windows it's probably easiest to do this through WinSCP (right click>Properties>Permissions).

== Development Ideas==
1. Send response as a google maps link that clicked on shows the phones position on a map.
2. Find a way to put a hook into message reception so that messages don't have to be checked with a cron job. Even better if the message could be intercepted before appearing on the phone, it would be a useful way to track a stolen phone.
3. After implementing the script that emails me every 20 minutes, it occured to me that the following would be great:
3a. The ability to log the entries instead of just sending an email, and maintain a preset number of logged entries (say the last 24 entries).
3b. Using the original implementation - send a message to the device to have the logged information emailed. This would show a "track" of where the device has been.
3c. Control of the number of log entries, and the frequency.
== Another Simple Method==
Why not use this script:
<pre><nowiki>
#!/bin/sh

pos=$(luna-send -n 2 palm://com.palm.location/startTracking '{"appId": "ILovePalm", "subscribe": true}' 2>&1 | tail -1 | cut -d, -f4,5,8 | sed -r 's/[^-\.0-9,]//g')

lat=$(echo $pos | cut -d, -f1)
lon=$(echo $pos | cut -d, -f2)
spd=$(echo $pos | cut -d, -f3)
bat=$(grep BATTERY: /var/log/messages | tail -1 | awk '{print $8}' | sed 's/%,//')

ret=$(wget -qO- "http://yoursite.com/trackme/$1/requests.php?lat=$lat&lon=$lon&speed=$spd&batt=$bat" | egrep -o '[0-9]+$')
exit $ret
</nowiki></pre>

I have a web server setup with //requests.php// taking '''//lat//''', '''//lon//''', '''//speed//''', and '''//batt//''' arguments. Then it writes them to a file. Use the data however you want. I have mine plug into a google map and show me the data.

Just set up a cron job to call the script every 20 minutes or so. Hardly effects battery life at all :)

Credit to ddoc for info on how to grab battery status. I would still like to find a more efficient way of grabbing battery level rather than searching through the entire message log. Though for now, it works exactly like it should.

Here's the Method for getting battery status:
<pre><nowiki>Mojo.Service.Request('palm://com.palm.power/com/palm/power/', {method: 'batteryStatusQuery',});</nowiki></pre>
-pEEf

== Email a URL to open Google Maps showing location of phone.==
Below is a code snippet that will send an email with working URL to open Google Map and show you the location of your phone.
The cron job mentioned above is setup to call this script every 20 minutes on my machine...works great. I let GMAIL archive them.
If the phone gets stolen, I can find it as long as it has service.

The larger Accuracy is, the further away the coordinates output will be from your actual position.

Added speed & heading to Google URL. Is there any way to have the sent messages not appear in the Text Messaging app, or to use the shell to email the output via mailx? Until I figure out a built-in mail function, you can use an alternative I'm testing that uses a server's mailx command: echo "$msg2" | /opt/bin/ssh -x user@server /bin/mailx $DEST -hopspitfire

<pre><nowiki>
#!/bin/sh
DEST=YOUR_USERID@DOMAIN.com

pos=$(luna-send -n 2 palm://com.palm.location/startTracking '{"appId": "ILovePalm", "subscribe": true}' 2>&1 | tail -1 | cut -d, -f4,5,6,7,8 | sed -r 's/[^-\.0-9,]//g')

lat=$(echo $pos | cut -d, -f1)
lon=$(echo $pos | cut -d, -f2)
acc=$(echo $pos | cut -d, -f3)
dir=$(echo $pos | cut -d, -f4)
spd=$(echo $pos | cut -d, -f5)
bat=$(grep BATTERY: /var/log/messages | tail -1 | awk '{print $8}' | sed 's/%,//')

now=$(date)

# Enable this below if you want to keep logs - not sure where to write them /var/home/root not the best place.
# echo $now,$lat,$lon,$acc,$dir,$spd,$bat >>mygpsdata.log

#Build a message variable for all the data to be logged.
msg=$(echo $now,$lat,$lon,$acc,$dir,$spd,$bat )

#Build message content to be sent
msg2=$(echo $now Battery:$bat Accuracy:$acc "http://maps.google.com/maps?q=$lat%2C$lon+(Heading:%20$dir%0DSpeed:%20$spd)")

ret1=$(luna-send -n 1 palm://com.palm.messaging/sendMessageFromCompose '{"recipientJSONArray": [{"value": "'${DEST}'", "contactDisplay": "'${DEST}'", "prefix": "to$A", "identifier": "palm_anon_element_8"}], "messageText": "'"$msg2"'"}' 2>&1)

exit
</nowiki></pre>
This has been running every 20 minutes on my phone for the last 4 days, no problem.
-dld121

Patch webOS Random Wallpaper Switching

2009-08-04T19:19:31Z

Hparsons:

{{template:patch}}
===Homebrew App for Random Wallpaper Switching===

There is now a homebrew application (no rooting required) that allows this same function without performing the patch below. It can be found at http://forums.precentral.net/homebrew-apps/195990-switcharoo-random-wallpaper-switching-v0-9-0-7-30-a.html

=== Goal===

On my desktop I have installed desktop drapes and my wallpaper switches every few hours to a random image in a wallpapers folder. I wanted to have the same functionality on my pre.

=== Requirements===

* [[Portal:Accessing_Linux | Access to Linux]] on your Pre.
* [[Next_steps | Installed backdoor with sudo]]
* The PATH variable should be set up in your .profile in your backdoor account, for example mine is set as follows:
<pre><nowiki>export PATH=$PATH:/bin:/sbin:/usr/bin:/usr/sbin/:/usr/local/bin:/opt/bin:/opt/sbin</nowiki></pre>

=== Procedure===

Note: I prefer doing everything with sudo and not logging in as root via the backdoor. I would recommend getting into the same habit.

==== Transfering Wallpapers====

* Connect your Pre to your computer as a USB drive.
* Create a folder named 'wallpapers' on the Pre (if its not already there).
* Put all your wallpapers there.
* Disconnect the Pre from your PC. You might want to make sure to disconnect it safely so everything writes to storage okay.

Make sure to remove any wallpapers which you don't want to show up, though, since the switcher will pick a random one.

==== Enable Write Access====

<pre><nowiki>sudo mount -o remount,rw /</nowiki></pre>

==== Enabling Cron====

Go [[Crond | here ]] to enable crond.

==== The Wallpaper Switcher Script====

First lets make a place for the script:

<pre><nowiki>sudo mkdir /opt/share/wallswitcher</nowiki></pre>

Edit wallswitcher.sh inside /opt/share/wallswitcher directory and place the following code there:

<pre><nowiki>
#!/bin/sh

main()
{
DIR='/media/internal/wallpapers/'
IFS="
"
NUM_FILES=0
for cur in `ls -1 $DIR`; do
if [ -f "$DIR$cur" ]
then
NUM_FILES=$((NUM_FILES+1))
eval "FILE_$NUM_FILES=$cur"
fi
done

RANDOM_NUMBER=`awk "BEGIN{srand();print int($NUM_FILES * rand()) + 1;}"`
eval "RANDOM_FILE=\$FILE_$((RANDOM_NUMBER))"
IMPORT_STRING="{ \"target\": \"$DIR$RANDOM_FILE\" }"
SET_STRING="{ \"wallpaper\": { \"wallpaperName\": \"$RANDOM_FILE\", \"wallpaperFile\": \"$DIR$RANDOM_FILE\" } }"

echo "Found $NUM_FILES in $DIR"
echo "Using random file: $RANDOM_FILE"
echo "JSON Import String: $IMPORT_STRING"
echo "JSON Set String: $SET_STRING"

eval "luna-send -n 1 palm://com.palm.systemservice/wallpaper/importWallpaper '$IMPORT_STRING'"

eval "luna-send -n 1 palm://com.palm.systemservice/setPreferences '$SET_STRING'"
}

main
</nowiki></pre>

Save the file and make sure it has execute permissions. The following command will insure that:

<pre><nowiki>sudo chmod 755 /opt/share/wallswitcher/wallswitcher.sh</nowiki></pre>

Some notes on the script:
* I am a Java/Groovy developer mostly and am not as good at shell scripting as I would like. Any improvements on the script itself are welcome
* The main piece of code that performs the switch are the two luna-send commands. T he first command is required if a wallpaper has never been used before and will generate some thumbnails and copy the main image into /media/internal/.wallpapers. The second luna-send command actually performs the switch.
* This method currently only supports wallpapers sized to exactly 320 x 480 px. The import luna-send call can take more parameters in its JSON string, such as scaling and x/y offsets from center. I have not used these yet since all my wallpapers are correctly sized.
* Again, being a not-so-good shell developer, the way I obtain random numbers and use them is a bit wrong. Awk is used to get a random number. Instead of arrays (as in bash), dynamic variable naming is used.
* The DIR variable controls where the script looks for wallpapers—you can change it to where your pictures are instead. Currently the scan is not recursive.

==== Testing the Script====

If you have more then one wallpaper in /media/internal/wallpapers, you can test the switcher with the following command:

<pre><nowiki>sudo /opt/share/wallswitcher/wallswitcher.sh</nowiki></pre>

The response should look something like this:

<pre><nowiki>
Found 24 in /media/internal/wallpapers/
Using random file: wall_409.jpg
JSON Import String: { "target": "/media/internal/wallpapers/wall_409.jpg" }
JSON Set String: { "wallpaper": { "wallpaperName": "wall_409.jpg", "wallpaperFile": "/media/internal/wallpapers/wall_409.jpg" } }
** Message: serviceResponse Handling: 2, { "returnValue": true, "wallpaper": { "wallpaperName": "wall_409.jpg", "wallpaperFile": "\/media\/internal\/.wallpapers\/wall_409.jpg", "wallpaperThumbFile": "\/media\/internal\/.wallpapers\/thumbs\/wall_409.jpg" } }
** Message: serviceResponse Handling: 2, { "returnValue": true }
</nowiki></pre>

If the two service calls are not returning correctly, something is wrong. Contact me (fxdemolisher[at]gmail[dawt]com) if you are stuck debugging it.

==== Schedule the Script====

This step is pretty easy. Since you have an empty root crontab set up all that needs to be done is a scheduling command. Edit /etc/cron/crontabs/root and place the following scheduling test line:
<pre><nowiki>*/1 * * * * /opt/share/wallswitcher/wallswitcher.sh > /opt/share/wallswitcher/wallswitcher.log 2>&1</nowiki></pre>

This will execute the switcher every minute and log to the /opt/share/wallswitcher/wallswitcher.log log. After you have it switching correctly every minute you can edit the cron definition to run as often as you like. Mine is set to run at the top of the hour using this line:

<pre><nowiki>0 * * * * /opt/share/wallswitcher/wallswitcher.sh > /opt/share/wallswitcher/wallswitcher.log 2>&1</nowiki></pre>

NOTE: Do not use crontab -e as this does not really write to /etc/cron/crontabs/root and will be overriden when the device restarts.

==== Restore Read-Only Filesystem====

<pre><nowiki>sudo mount -o remount,ro /</nowiki></pre>

Tested and verified as written by optik678.

=== Alternate Uses===
Modifications to original script for other uses
==== "Missing Pre" Wallpaper ====
This is a simple alternate use to create a wallpaper indicating the Pre is "missing" ("stolen" sounds rather harsh...)

'''1.''' Create a PNG file and put in a directory of your choosing ( <YOUR-DIRECTORY> ) naming it "missingpre.png"

'''2.''' Create a script file in a location of your choosing, naming it missingpre.sh (I use "/home/scripts") using the following script (be sure to change <YOUR-DIRECTORY> to the actual directory where you stored your missingpre.png file):
<pre><nowiki>
#!/bin/sh

main()
{
MYFILE='<YOUR-DIRECTORY>/missingpre.png'

IMPORT_STRING="{ \"target\": \"$MYFILE\" }"
SET_STRING="{ \"wallpaper\": { \"wallpaperName\": \"mypre.png\", \"wallpaperFile\": \"$MYFILE\" } }"

echo "JSON Import String: $IMPORT_STRING"
echo "JSON Set String: $SET_STRING"

eval "luna-send -n 1 palm://com.palm.systemservice/wallpaper/importWallpaper '$IMPORT_STRING'"
eval "luna-send -n 1 palm://com.palm.systemservice/setPreferences '$SET_STRING'"
}

main
</nowiki></pre>

'''3.''' Add the following to /etc/cron/crontabs/root file (using the directory you chose for your script):
<pre><nowiki>*/1 * * * * /home/scripts/missingpre.sh</nowiki></pre>

'''4.''' Restart crond
<pre><nowiki>/sbin/stop crond && /sbin/start crond</nowiki></pre>

'''Result.''' Every minute this will over-ride whatever wallpaper was set.
Obviously, this won't force anyone to return your device, nor will it work if someone knows what they're doing with the Pre, but if your wallpaper is obnoxious enough, you might get lucky and have them call you back.

[[image:Missingpre.png]]

=== Acknowledgements===

I would like to thank this site and the wonderful hackers on it. I would not be able to do this without various examples from other pages.

File:Missingpre.png

2009-08-04T19:16:00Z

Hparsons: Image used in the wallpaper script alternate use page

Image used in the wallpaper script alternate use page

Patch webOS Random Wallpaper Switching

2009-08-04T19:06:37Z

Hparsons: Added alternative uses section, and "missingpre" script

{{template:patch}}
===Homebrew App for Random Wallpaper Switching===

There is now a homebrew application (no rooting required) that allows this same function without performing the patch below. It can be found at http://forums.precentral.net/homebrew-apps/195990-switcharoo-random-wallpaper-switching-v0-9-0-7-30-a.html

=== Goal===

On my desktop I have installed desktop drapes and my wallpaper switches every few hours to a random image in a wallpapers folder. I wanted to have the same functionality on my pre.

=== Requirements===

* [[Portal:Accessing_Linux | Access to Linux]] on your Pre.
* [[Next_steps | Installed backdoor with sudo]]
* The PATH variable should be set up in your .profile in your backdoor account, for example mine is set as follows:
<pre><nowiki>export PATH=$PATH:/bin:/sbin:/usr/bin:/usr/sbin/:/usr/local/bin:/opt/bin:/opt/sbin</nowiki></pre>

=== Procedure===

Note: I prefer doing everything with sudo and not logging in as root via the backdoor. I would recommend getting into the same habit.

==== Transfering Wallpapers====

* Connect your Pre to your computer as a USB drive.
* Create a folder named 'wallpapers' on the Pre (if its not already there).
* Put all your wallpapers there.
* Disconnect the Pre from your PC. You might want to make sure to disconnect it safely so everything writes to storage okay.

Make sure to remove any wallpapers which you don't want to show up, though, since the switcher will pick a random one.

==== Enable Write Access====

<pre><nowiki>sudo mount -o remount,rw /</nowiki></pre>

==== Enabling Cron====

Go [[Crond | here ]] to enable crond.

==== The Wallpaper Switcher Script====

First lets make a place for the script:

<pre><nowiki>sudo mkdir /opt/share/wallswitcher</nowiki></pre>

Edit wallswitcher.sh inside /opt/share/wallswitcher directory and place the following code there:

<pre><nowiki>
#!/bin/sh

main()
{
DIR='/media/internal/wallpapers/'
IFS="
"
NUM_FILES=0
for cur in `ls -1 $DIR`; do
if [ -f "$DIR$cur" ]
then
NUM_FILES=$((NUM_FILES+1))
eval "FILE_$NUM_FILES=$cur"
fi
done

RANDOM_NUMBER=`awk "BEGIN{srand();print int($NUM_FILES * rand()) + 1;}"`
eval "RANDOM_FILE=\$FILE_$((RANDOM_NUMBER))"
IMPORT_STRING="{ \"target\": \"$DIR$RANDOM_FILE\" }"
SET_STRING="{ \"wallpaper\": { \"wallpaperName\": \"$RANDOM_FILE\", \"wallpaperFile\": \"$DIR$RANDOM_FILE\" } }"

echo "Found $NUM_FILES in $DIR"
echo "Using random file: $RANDOM_FILE"
echo "JSON Import String: $IMPORT_STRING"
echo "JSON Set String: $SET_STRING"

eval "luna-send -n 1 palm://com.palm.systemservice/wallpaper/importWallpaper '$IMPORT_STRING'"

eval "luna-send -n 1 palm://com.palm.systemservice/setPreferences '$SET_STRING'"
}

main
</nowiki></pre>

Save the file and make sure it has execute permissions. The following command will insure that:

<pre><nowiki>sudo chmod 755 /opt/share/wallswitcher/wallswitcher.sh</nowiki></pre>

Some notes on the script:
* I am a Java/Groovy developer mostly and am not as good at shell scripting as I would like. Any improvements on the script itself are welcome
* The main piece of code that performs the switch are the two luna-send commands. T he first command is required if a wallpaper has never been used before and will generate some thumbnails and copy the main image into /media/internal/.wallpapers. The second luna-send command actually performs the switch.
* This method currently only supports wallpapers sized to exactly 320 x 480 px. The import luna-send call can take more parameters in its JSON string, such as scaling and x/y offsets from center. I have not used these yet since all my wallpapers are correctly sized.
* Again, being a not-so-good shell developer, the way I obtain random numbers and use them is a bit wrong. Awk is used to get a random number. Instead of arrays (as in bash), dynamic variable naming is used.
* The DIR variable controls where the script looks for wallpapers—you can change it to where your pictures are instead. Currently the scan is not recursive.

==== Testing the Script====

If you have more then one wallpaper in /media/internal/wallpapers, you can test the switcher with the following command:

<pre><nowiki>sudo /opt/share/wallswitcher/wallswitcher.sh</nowiki></pre>

The response should look something like this:

<pre><nowiki>
Found 24 in /media/internal/wallpapers/
Using random file: wall_409.jpg
JSON Import String: { "target": "/media/internal/wallpapers/wall_409.jpg" }
JSON Set String: { "wallpaper": { "wallpaperName": "wall_409.jpg", "wallpaperFile": "/media/internal/wallpapers/wall_409.jpg" } }
** Message: serviceResponse Handling: 2, { "returnValue": true, "wallpaper": { "wallpaperName": "wall_409.jpg", "wallpaperFile": "\/media\/internal\/.wallpapers\/wall_409.jpg", "wallpaperThumbFile": "\/media\/internal\/.wallpapers\/thumbs\/wall_409.jpg" } }
** Message: serviceResponse Handling: 2, { "returnValue": true }
</nowiki></pre>

If the two service calls are not returning correctly, something is wrong. Contact me (fxdemolisher[at]gmail[dawt]com) if you are stuck debugging it.

==== Schedule the Script====

This step is pretty easy. Since you have an empty root crontab set up all that needs to be done is a scheduling command. Edit /etc/cron/crontabs/root and place the following scheduling test line:
<pre><nowiki>*/1 * * * * /opt/share/wallswitcher/wallswitcher.sh > /opt/share/wallswitcher/wallswitcher.log 2>&1</nowiki></pre>

This will execute the switcher every minute and log to the /opt/share/wallswitcher/wallswitcher.log log. After you have it switching correctly every minute you can edit the cron definition to run as often as you like. Mine is set to run at the top of the hour using this line:

<pre><nowiki>0 * * * * /opt/share/wallswitcher/wallswitcher.sh > /opt/share/wallswitcher/wallswitcher.log 2>&1</nowiki></pre>

NOTE: Do not use crontab -e as this does not really write to /etc/cron/crontabs/root and will be overriden when the device restarts.

==== Restore Read-Only Filesystem====

<pre><nowiki>sudo mount -o remount,ro /</nowiki></pre>

Tested and verified as written by optik678.

=== Alternate Uses===
Modifications to original script for other uses
==== "Missing Pre" Wallpaper ====
This is a simple alternate use to create a wallpaper indicating the Pre is "missing" ("stolen" sounds rather harsh...)

'''1.''' Create a PNG file and put in a directory of your choosing ( <YOUR-DIRECTORY> ) naming it "missingpre.png"

'''2.''' Create a script file in a location of your choosing, naming it missingpre.sh (I use "/home/scripts") using the following script (be sure to change <YOUR-DIRECTORY> to the actual directory where you stored your missingpre.png file):
<pre><nowiki>
#!/bin/sh

main()
{
MYFILE='<YOUR-DIRECTORY>/missingpre.png'

IMPORT_STRING="{ \"target\": \"$MYFILE\" }"
SET_STRING="{ \"wallpaper\": { \"wallpaperName\": \"mypre.png\", \"wallpaperFile\": \"$MYFILE\" } }"

echo "JSON Import String: $IMPORT_STRING"
echo "JSON Set String: $SET_STRING"

eval "luna-send -n 1 palm://com.palm.systemservice/wallpaper/importWallpaper '$IMPORT_STRING'"
eval "luna-send -n 1 palm://com.palm.systemservice/setPreferences '$SET_STRING'"
}

main
</nowiki></pre>

'''3.''' Add the following to /etc/cron/crontabs/root file (using the directory you chose for your script):
<pre><nowiki>*/1 * * * * /home/scripts/missingpre.sh</nowiki></pre>

'''4.''' Restart crond
<pre><nowiki>/sbin/stop crond && /sbin/start crond</nowiki></pre>

'''Result.''' Every minute this will over-ride whatever wallpaper was set. Obviously, this won't force anyone to return your device, nor will it work if someone knows what they're doing with the Pre, but if your wallpaper is obnoxious enough, you might get lucky and have them call you back.

=== Acknowledgements===

I would like to thank this site and the wonderful hackers on it. I would not be able to do this without various examples from other pages.

Talk:Patch webOS GPS Tracking

2009-08-04T15:54:10Z

Hparsons: How to use cron with this?

Portal:Patches to webOS

2009-07-31T22:45:11Z

Hparsons: Should have been column 2

__notoc__
{{portal-header
|This page lists patches to webOS existing apps which modify the behavior as shipped. '''Note''' that these patches may be version specific and may be broken by future webOS updates. Proceed with caution. If you get one that works please move it under the correct column, alphabetically, and title the page:
'''"Patch [application] [description]"'''
}}
This page is undergoing structuring please contribute moving or adding new entries under the appropriate headings. For now put pages in alphabetical order. Each page should contain at least the basic headings
*1. '''Introduction''': A brief description to introduce people to the patch.
**1.1 '''Usage''':An explanation if it is needed on how to use the modification see Add/Delete Pages in the Launcher as an example.
*2. '''Editing Process''': Step by step instructions to manually edit.
*3. '''Patching Process''': Details for making the edits with a patch file and pointing people to the [[Applying Patches]] page if the patch is also provided in the webos-internals gitorious repository.

{{portal-three-columns
|column1=
===webOS Update Information===
* [[Update 1.1.0|Update 1.1]]
* [[Update 1.0.4|Update 1.0.4]]
* [[Update 1.0.3|Update 1.0.3]]

===Patches that Need Work===
* [[Bugs]]

|column2=
===Patch Ideas to be Created or in Progress===

* [[Add_Ability_To_Choose_Snooze_Length|Add Ability to Choose Snooze Length]]
* [[Changing_clipboard_data_from_the_shell|Changing Clipboard Data from the Shell]]
* [[Development_%26_Tweak_Ideas | Development & Tweaking Ideas]]
* [[Longer Vibrate|Longer Vibrate]]
* [[More_Calculator_Functions|Accessing additional built-in calculator functions]]

|column3=
===Notes===
These modifications lack a patch process, please add one to the details to the page and have it added to the webOS-internals gitorious repository. Info for the repository is on [[Applying Patches]].

*Empty
}}
{{portal-three-columns
|column1=
==Patches to webOS apps==
===webOS 1.1 OK===

* [[Always_Show_Details_of_New_Tasks|Always Show Details of New Tasks]]
* [[Patch Browser Global Search Addons|Browser: Global Search Addons]]
* [[Bookmarking_MediaPlayer|Bookmarking MediaPlayer]]
* [[Camera Mod Shutter Sound On-Off Button]]
* [[Camera Mod 10 Second Countdown Timer]]
* [[Patch Clock Enabling the Hidden Theme|Clock: Enabling the Hidden Theme]]
* [[Confirm Deletion on Email|Confirm Deletion on Email]]
* [[Patch Email Change Default Font for Replies-Forwards from Navy to Black|Email: Change Default Font for Replies/Forwards from Navy to Black]]
* [[GPS Tracking|GPS Tracking]]
* [[Patch Launcher Add or Delete Pages|Launcher: Add/Delete Pages]]
* [[Patch Launcher Hide-Delete The NASCAR App|Launcher: Hide/Delete The NASCAR App]]
* [[Patch Launcher Unhide the DeveloperMode App|Launcher: Unhide the DeveloperMode App]]
* [[Patch Messaging Character Counter|Messaging: Character Counter]]
* [[Patch Messaging Forward Messages|Messaging: Forward Messages]]
* [[Patch Messaging New Cards For Each Conversation|Messaging: New Cards For Each Conversation]]
* [[Patch MCraig Enabling Personals Category|mCraig: Enabling Personals Category]]
* [[Patch Phone Disable Missed-Dropped Call Sound|Phone: Disable Missed-Dropped Call Sound]]
* [[Patch Phone Edit Dialer Theme|Phone: Edit Dialer Theme]]
* [[Patch Phone Editing the Lock Screen|Phone: Editing the Lock Screen]]
* [[Using Volume Buttons to Take a Picture|Using Volume Buttons to Take a Picture]]
* [[Changing Alarm Clock Button Order and Snooze Duration]]
* [[Download Amazon Music over EVDO]]
* [[Change_Running_Late_Email|Change "Running Late" Email]]

===Fixed in 1.1 - No longer needed===
* [[Patch Email Fix Broken Formatting|Email: Fix Broken Formatting for E-mails]]

===Not 1.1 compatible===
* [[Camera_Remote_View|Camera Remote View]]
* [[Downloading From The Browser|Downloading From The Browser]]
* [[Enable Landscape Viewing in Email|Enable Landscape Viewing in Email]]
* [[Fix Email Attachments|Fix Email Attachments]]

|column2=
==Patches not part of a specific app==
===webOS 1.1 OK===
* [[Boot_Themes|Boot Themes]]
* [[Brightness]]
* [[Bypassing_Activation|Bypassing Activation]]
* [[Change_Carrier_String|Change Carrier String]]
* [[Changing_the_%22Turn_off_after_X%22_time|Changing the "Turn off after X" Time]]
* [[CPU Frequency or Voltage Scaling|CPU Frequency or Voltage Scaling]]
* [[Disable Charging Event Alerts Sounds|Disable Charging Event Alerts Sounds]]
* [[Graphics]]
* [[Keep Phone From Entering Standby While in Remote Session]]
* [[Logging information from within scripts|Logging information from within scripts]]
* [[Message Sound|Message Sound]]
* [[Modifying a Stock App While Keeping the Original|Modifying a Stock App While Keeping the Original]]
* [[Add_Words_to_AutoCorrect_Dictionary|Modify AutoCorrect Dictionary]]
* [[Radio_Power_Switch|Phone On/Off Switch]]
* [[Random Wallpaper Switching|Random Wallpaper Switching]]
* [[Reverse Tunnel|Reverse Tunnel]]
* [[Roam Control|Roam Control]]
* [[Show_Actual_Battery_Percent | Show Actual Battery Percentage]]

===Fixed in 1.1 - No longer needed===
* Empty

===Not 1.1 compatible===
* [[Email App Patch to Prompt for IPK Installation|Email App Patch to Prompt for IPK Installation]]

|column3=
==== The following have not been checked for compatibility with webOS 1.1. ====

* [[Adding Timestamps to All Received Messages]]
* [[Browser_Plugins|Browser Plugins]]
* [[Camera Mod Alternate Sound Disable]]
* [[Change_Enter_To_Create_Newline_Instead_of_Send_Message|Change Enter to Create Newline Instead of Send Message]]
* [[Change_the_default_notification.wav_Sound|Change the Default notification.wav Sound]]
* [[Changes_Alert/Notification_Sounds|Changes Alert/Notification Sounds]]
* [[Display_Full_Status_Messages(Messenger)|Display Full Status Messages(Messenger)]]
* [[Hourly Chime|Hourly Chime]]
* [[Ignore 'A', 'An', and 'The' In Artist and Album names|Ignore 'A', 'An', and 'The' In Artist and Album names]]
* [[Installing Homebrew Apps With A Rooted Pre|Installing Homebrew Apps With A Linux Accessed Pre]]
* [[Messaging Mod Force Offline Send Without Dialog]]
* [[Modifying Stock Applications|Modifying Stock Applications]]
* [[My notification|My notification]]
* [[Myavatar In Messaging App|Myavatar In Messaging App]]
* [[Packaging Homebrew Apps for Stock Pre without Rooting|Packaging Homebrew Apps for Stock Pre without Accessing Linux]]
* [[Patch PDF Viewer|PDF Viewer]]
* [[Photos Slideshow|Photos Slideshow]]
* [[Screenlock On When Connected|Stay On While Connected]]
* [[Show allday events in calendar month view]]
* [[Show Call Duration in the Call Log]]
* [[Patch Sudoku Disable Zooming|Sudoku: Disable Zooming]]
* [[Turning Off Dialpad Noise]]

}}

Portal:Patches to webOS

2009-07-31T22:43:56Z

Hparsons: Moved standby added options to the 1.1 OK list

__notoc__
{{portal-header
|This page lists patches to webOS existing apps which modify the behavior as shipped. '''Note''' that these patches may be version specific and may be broken by future webOS updates. Proceed with caution. If you get one that works please move it under the correct column, alphabetically, and title the page:
'''"Patch [application] [description]"'''
}}
This page is undergoing structuring please contribute moving or adding new entries under the appropriate headings. For now put pages in alphabetical order. Each page should contain at least the basic headings
*1. '''Introduction''': A brief description to introduce people to the patch.
**1.1 '''Usage''':An explanation if it is needed on how to use the modification see Add/Delete Pages in the Launcher as an example.
*2. '''Editing Process''': Step by step instructions to manually edit.
*3. '''Patching Process''': Details for making the edits with a patch file and pointing people to the [[Applying Patches]] page if the patch is also provided in the webos-internals gitorious repository.

{{portal-three-columns
|column1=
===webOS Update Information===
* [[Update 1.1.0|Update 1.1]]
* [[Update 1.0.4|Update 1.0.4]]
* [[Update 1.0.3|Update 1.0.3]]

===Patches that Need Work===
* [[Bugs]]

|column2=
===Patch Ideas to be Created or in Progress===

* [[Add_Ability_To_Choose_Snooze_Length|Add Ability to Choose Snooze Length]]
* [[Changing_clipboard_data_from_the_shell|Changing Clipboard Data from the Shell]]
* [[Development_%26_Tweak_Ideas | Development & Tweaking Ideas]]
* [[Longer Vibrate|Longer Vibrate]]
* [[More_Calculator_Functions|Accessing additional built-in calculator functions]]

|column3=
===Notes===
These modifications lack a patch process, please add one to the details to the page and have it added to the webOS-internals gitorious repository. Info for the repository is on [[Applying Patches]].

*Empty
}}
{{portal-three-columns
|column1=
==Patches to webOS apps==
===webOS 1.1 OK===

* [[Always_Show_Details_of_New_Tasks|Always Show Details of New Tasks]]
* [[Patch Browser Global Search Addons|Browser: Global Search Addons]]
* [[Bookmarking_MediaPlayer|Bookmarking MediaPlayer]]
* [[Camera Mod Shutter Sound On-Off Button]]
* [[Camera Mod 10 Second Countdown Timer]]
* [[Patch Clock Enabling the Hidden Theme|Clock: Enabling the Hidden Theme]]
* [[Confirm Deletion on Email|Confirm Deletion on Email]]
* [[Patch Email Change Default Font for Replies-Forwards from Navy to Black|Email: Change Default Font for Replies/Forwards from Navy to Black]]
* [[GPS Tracking|GPS Tracking]]
* [[Keep Phone From Entering Standby While in Remote Session]]
* [[Patch Launcher Add or Delete Pages|Launcher: Add/Delete Pages]]
* [[Patch Launcher Hide-Delete The NASCAR App|Launcher: Hide/Delete The NASCAR App]]
* [[Patch Launcher Unhide the DeveloperMode App|Launcher: Unhide the DeveloperMode App]]
* [[Patch Messaging Character Counter|Messaging: Character Counter]]
* [[Patch Messaging Forward Messages|Messaging: Forward Messages]]
* [[Patch Messaging New Cards For Each Conversation|Messaging: New Cards For Each Conversation]]
* [[Patch MCraig Enabling Personals Category|mCraig: Enabling Personals Category]]
* [[Patch Phone Disable Missed-Dropped Call Sound|Phone: Disable Missed-Dropped Call Sound]]
* [[Patch Phone Edit Dialer Theme|Phone: Edit Dialer Theme]]
* [[Patch Phone Editing the Lock Screen|Phone: Editing the Lock Screen]]
* [[Using Volume Buttons to Take a Picture|Using Volume Buttons to Take a Picture]]
* [[Changing Alarm Clock Button Order and Snooze Duration]]
* [[Download Amazon Music over EVDO]]
* [[Change_Running_Late_Email|Change "Running Late" Email]]

===Fixed in 1.1 - No longer needed===
* [[Patch Email Fix Broken Formatting|Email: Fix Broken Formatting for E-mails]]

===Not 1.1 compatible===
* [[Camera_Remote_View|Camera Remote View]]
* [[Downloading From The Browser|Downloading From The Browser]]
* [[Enable Landscape Viewing in Email|Enable Landscape Viewing in Email]]
* [[Fix Email Attachments|Fix Email Attachments]]

|column2=
==Patches not part of a specific app==
===webOS 1.1 OK===
* [[Boot_Themes|Boot Themes]]
* [[Brightness]]
* [[Bypassing_Activation|Bypassing Activation]]
* [[Change_Carrier_String|Change Carrier String]]
* [[Changing_the_%22Turn_off_after_X%22_time|Changing the "Turn off after X" Time]]
* [[CPU Frequency or Voltage Scaling|CPU Frequency or Voltage Scaling]]
* [[Disable Charging Event Alerts Sounds|Disable Charging Event Alerts Sounds]]
* [[Graphics]]
* [[Logging information from within scripts|Logging information from within scripts]]
* [[Message Sound|Message Sound]]
* [[Modifying a Stock App While Keeping the Original|Modifying a Stock App While Keeping the Original]]
* [[Add_Words_to_AutoCorrect_Dictionary|Modify AutoCorrect Dictionary]]
* [[Radio_Power_Switch|Phone On/Off Switch]]
* [[Random Wallpaper Switching|Random Wallpaper Switching]]
* [[Reverse Tunnel|Reverse Tunnel]]
* [[Roam Control|Roam Control]]
* [[Show_Actual_Battery_Percent | Show Actual Battery Percentage]]

===Fixed in 1.1 - No longer needed===
* Empty

===Not 1.1 compatible===
* [[Email App Patch to Prompt for IPK Installation|Email App Patch to Prompt for IPK Installation]]

|column3=
==== The following have not been checked for compatibility with webOS 1.1. ====

* [[Adding Timestamps to All Received Messages]]
* [[Browser_Plugins|Browser Plugins]]
* [[Camera Mod Alternate Sound Disable]]
* [[Change_Enter_To_Create_Newline_Instead_of_Send_Message|Change Enter to Create Newline Instead of Send Message]]
* [[Change_the_default_notification.wav_Sound|Change the Default notification.wav Sound]]
* [[Changes_Alert/Notification_Sounds|Changes Alert/Notification Sounds]]
* [[Display_Full_Status_Messages(Messenger)|Display Full Status Messages(Messenger)]]
* [[Hourly Chime|Hourly Chime]]
* [[Ignore 'A', 'An', and 'The' In Artist and Album names|Ignore 'A', 'An', and 'The' In Artist and Album names]]
* [[Installing Homebrew Apps With A Rooted Pre|Installing Homebrew Apps With A Linux Accessed Pre]]
* [[Messaging Mod Force Offline Send Without Dialog]]
* [[Modifying Stock Applications|Modifying Stock Applications]]
* [[My notification|My notification]]
* [[Myavatar In Messaging App|Myavatar In Messaging App]]
* [[Packaging Homebrew Apps for Stock Pre without Rooting|Packaging Homebrew Apps for Stock Pre without Accessing Linux]]
* [[Patch PDF Viewer|PDF Viewer]]
* [[Photos Slideshow|Photos Slideshow]]
* [[Screenlock On When Connected|Stay On While Connected]]
* [[Show allday events in calendar month view]]
* [[Show Call Duration in the Call Log]]
* [[Patch Sudoku Disable Zooming|Sudoku: Disable Zooming]]
* [[Turning Off Dialpad Noise]]

}}