window.open('http://website.url','','');

This will open a new window to the address “http://website.url”, pretty basic stuff. Now, what happens if you want to change the location of the Prism window from your default webapp’s location. Well, you can still use the Error Console, but there’s a couple of layers of javascript reference you need to go through. If you try using this:

parent.location='http://website.url'

You redirect the Error Console to “http://website.url”, interesting (very, actually :), but not what we’re after. If you haven’t already done so, open the error console:

Next, in the Code Evaluation text box, type the following:

parent.opener.content.location='about:config'

That’s about it, hit return or press “Evaluate” and you’re done. By using parent.opener.content.whatever you should be able to access all of Prism’s components. What? You don’t know what the other compents are?? Well, check out the webrunner.xul located in Prism’s install directory, in the chrome directory inside the webrunner.jar (copy, rename to .zip from .jar and extract).

Another thing you’ll learn from this file is a complete list of the navigation keys (look for the keyset directives) currently used by Prism:

Back=Alt+Left Arrow
Forward=Alt+Right Arrow
Home=Alt+Home (that’s the Home Key on your keyboard’s number pad BTW)
Reload Page=F5
Close=Accelerator Key (Ctrl Key)+w
Quit=Accelerator Key (Ctrl Key)+q
Print=Accelerator Key (Ctrl Key)+p

Basically what I’ve done is used Prism to create a new webapp that points to the search URL of Veoh with a single program as the search term. For instance, right now I’m following the anime Toradora.

To create the webapp, I’ve chosen to place a link on my desktop, used the search link above, and enabled the navigation keys for Prism:

Alt+Back Arrow = Back in History
Alt+Forward Arrow = Forward in History
Alt+Home = Home Page for webappX
etc.

Veoh Search Link:

http://www.veoh.com/search/videos/q/your+search+here

Prism automatically pulls the site’s favicon as the desktop icon (has anyone else experienced problems with Prism not correctly installing the icon from pre-bundled webapps?).

Other places where this could be useful (other than setting up your own custom television station on your desktop with play-on-demand access)? The instructors for the courses I’m taking right now at ECU via the web often put class lectures on both YouTube and ECU’s own servers (depending on the class and the web-savvy-ness of the instructor). This would be a perfect way to distribute these movies to students, simply by placing the right URL into Prism and bundling the webapp, you can create a feed specific video channel for student consumption.

Other thoughts on this process:

• The ability to uninstall webapps would be useful. Manual uninstalls, while not difficult, are a pain.
• An addon or webapp script for Prism to load into the sidebar with links or buttons corresponding to pre-configured feeds/pages to change the currently viewed page so that you can “change channels.”
• Along those same lines, an addon with FF3′s built-in feed reader which would load into the sidebar would be a nifty means of navigating a number of pre-configured links… yes that would be nifty indeed…

I’ve also been running into a problem described by commenter Marcel, here. I’ve been getting a similar error under Windows for different extensions when I try to install them. Don’t know why, and what makes it worse is that these errors crop up in extensions that I’ve had no problems installing before on other computers (maybe I need to have Webrunner installed along side Prism?). I’ve also had problems with version 0.9 not installing and using the included icons for webapp files. I’m going to have to look into that one a bit further before I can comment more on it though.

At any rate, I’m going to list as much information in this post as I can find on Prism to refer back to, then I’m going to create a new post on how to install an extension for Prism manually. I’d also like to post a how-to on getting POW to work under Prism as well, but I don’t know whether or not I’ll get to that (maybe over Thanksgiving break). So, first some links.

LINKS:
Mozilla Labs’ Prism Page – A broad overview of the goals of the Mozilla Prism Project
Mozilla Developer Center’s Prism Page
MDC’s Prism Page on Extensions
Mozilla Labs’ Prism Forum
Mozilla Wiki Prism Page – Along with the Dev Center’s page, a good source for documentation on  Prism
Mark Finkle’s Blog (one of Prism’s developers – BTW – THANK YOU MARK!!!)
SVN for Prism’s source code
List of Prism Contributors on ohloh.net
Douglas Meyer’s Blog post on getting Google Gears to work with Prism
Commenter Manlo’s blog post on getting RTM working with Prism (does not appear to be working)
Wikipedia Entry

Next, here’s a list of all the files that Prism makes use of in the user’s profile directory on Windows and Mac OS X – Linux to come (I don’t have access to my Linux box at the moment).

Default Prisim Folders in User’s Home directory (Windows as of Prism v0.9):

Under C:\Documents and Settings\{user name}\Application Data\

Prism\
Prism\profiles.ini
Prism\Profiles\
Prism\Profiles\{random string}.default\
Prism\Profiles\{random string}.default\cert8.db
Prism\Profiles\{random string}.default\compatibility.ini
Prism\Profiles\{random string}.default\compreg.dat
Prism\Profiles\{random string}.default\cookies.sqlite
Prism\Profiles\{random string}.default\extensions
Prism\Profiles\{random string}.default\extensions.cache
Prism\Profiles\{random string}.default\extensions.ini
Prism\Profiles\{random string}.default\key3.db
Prism\Profiles\{random string}.default\localstore.rdf
Prism\Profiles\{random string}.default\mimeTypes.rdf
Prism\Profiles\{random string}.default\permissions.sqlite
Prism\Profiles\{random string}.default\places.sqlite
Prism\Profiles\{random string}.default\prefs.js
Prism\Profiles\{random string}.default\secmod.db
Prism\Profiles\{random string}.default\xpti.dat
Prism\Profiles\{random string}.default\extensions\

Under C:\Documents and Settings\{user name}\Local Settings\Application Data\

Prism\Prism\
Prism\Prism\updates\
Prism\Prism\updates\0\

For Each WebApp Prism creates (Windows as of Prism v0.9):

Under C:\Documents and Settings\{user name}\Application Data\Prism\

{webapp name}\
{webapp name}\profiles.ini
{webapp name}\Profiles\
{webapp name}\Profiles\{random string}.default\
{webapp name}\Profiles\{random string}.default\cert8.db
{webapp name}\Profiles\{random string}.default\compatibility.ini
{webapp name}\Profiles\{random string}.default\compreg.dat
{webapp name}\Profiles\{random string}.default\cookies.sqlite
{webapp name}\Profiles\{random string}.default\extensions
{webapp name}\Profiles\{random string}.default\extensions.cache
{webapp name}\Profiles\{random string}.default\extensions.ini
{webapp name}\Profiles\{random string}.default\extensions.rdf
{webapp name}\Profiles\{random string}.default\key3.db
{webapp name}\Profiles\{random string}.default\localstore.rdf
{webapp name}\Profiles\{random string}.default\mimeTypes.rdf
{webapp name}\Profiles\{random string}.default\permissions.sqlite
{webapp name}\Profiles\{random string}.default\places.sqlite
{webapp name}\Profiles\{random string}.default\pluginreg.dat
{webapp name}\Profiles\{random string}.default\prefs.js
{webapp name}\Profiles\{random string}.default\secmod.db
{webapp name}\Profiles\{random string}.default\signons3.txt
{webapp name}\Profiles\{random string}.default\xpti.dat
{webapp name}\Profiles\{random string}.default\extensions\

Under C:\Documents and Settings\{user name}\Application Data\WebApps\

{webapp name}@{webappaddr}\
{webapp name}@{webappaddr}\localstore.json
{webapp name}@{webappaddr}\override.ini
{webapp name}@{webappaddr}\webapp.ini
{webapp name}@{webappaddr}\webapp.js
{webapp name}@{webappaddr}\icons\
{webapp name}@{webappaddr}\icons\default\
{webapp name}@{webappaddr}\icons\default\{icons included in webapp bundle}

Under C:\Documents and Settings\{user name}\Local Settings\Application Data\Prism\

{webapp name}\
{webapp name}\Prism\
{webapp name}\Prism\updates\
{webapp name}\Prism\updates\0\
{webapp name}\Profiles\
{webapp name}\Profiles\l05apnbh.default\
{webapp name}\Profiles\l05apnbh.default\XPC.mfl
{webapp name}\Profiles\l05apnbh.default\XUL.mfl
{webapp name}\Profiles\l05apnbh.default\Cache\
{webapp name}\Profiles\l05apnbh.default\Cache\_CACHE_001_
{webapp name}\Profiles\l05apnbh.default\Cache\_CACHE_002_
{webapp name}\Profiles\l05apnbh.default\Cache\_CACHE_003_
{webapp name}\Profiles\l05apnbh.default\Cache\_CACHE_MAP_
{webapp name}\Profiles\l05apnbh.default\Cache\{other cache files}

Default Prisim Folders in User’s Home directory (Mac OS X as of Prism v0.9):
Under /Users/{user name}/Library/Application Support/Prism/

Profiles/
Profiles/profiles.ini
Profiles/{random string}.default/
Profiles/{random string}.default/cert8.db
Profiles/{random string}.default/compatibility.ini
Profiles/{random string}.default/compreg.dat
Profiles/{random string}.default/cookies.sqlite
Profiles/{random string}.default/extensions.cache
Profiles/{random string}.default/extensions.ini
Profiles/{random string}.default/key3.db
Profiles/{random string}.default/localstore.rdf
Profiles/{random string}.default/mimeTypes.rdf
Profiles/{random string}.default/permissions.sqlite
Profiles/{random string}.default/places.sqlite
Profiles/{random string}.default/pluginreg.dat
Profiles/{random string}.default/prefs.js
Profiles/{random string}.default/secmod.db
Profiles/{random string}.default/xpti.dat
Profiles/{random string}.default/extensions/

For Each WebApp Prism creates (Mac OS X as of Prism v0.9):

Under /Users/{user name}/Library/Application Support/{webapp name}/

Profiles/
Profiles/profiles.ini
Profiles/{random string}.default/
Profiles/{random string}.default/cert8.db
Profiles/{random string}.default/compatibility.ini
Profiles/{random string}.default/compreg.dat
Profiles/{random string}.default/cookies.sqlite
Profiles/{random string}.default/extensions.cache
Profiles/{random string}.default/extensions.ini
Profiles/{random string}.default/key3.db
Profiles/{random string}.default/localstore.rdf
Profiles/{random string}.default/mimeTypes.rdf
Profiles/{random string}.default/permissions.sqlite
Profiles/{random string}.default/places.sqlite
Profiles/{random string}.default/pluginreg.dat
Profiles/{random string}.default/prefs.js
Profiles/{random string}.default/secmod.db
Profiles/{random string}.default/xpti.dat
Profiles/{random string}.default/extensions/

Under /Users/{user name}/Library/WebApps/{webapp name}@{webappaddr}/

{webapp name}@{webappaddr}/localstore.json
{webapp name}@{webappaddr}/override.ini
{webapp name}@{webappaddr}/webapp.ini
{webapp name}@{webappaddr}/webapp.js
{webapp name}@{webappaddr}/icons/
{webapp name}@{webappaddr}/icons/default/
{webapp name}@{webappaddr}/icons/default/{icons included in webapp bundle}

Default Prisim Folders in User’s Home directory (Linux as of Prism v0.9):

Under /home/{user name}/

.prism/prismdir.lin.txt
.prism/profiles.ini
.prism/{randomstring}.default/
.prism/{randomstring}.default/Cache/
.prism/{randomstring}.default/cert8.db
.prism/{randomstring}.default/compatibility.ini
.prism/{randomstring}.default/compreg.dat
.prism/{randomstring}.default/cookies.sqlite
.prism/{randomstring}.default/extensions/
.prism/{randomstring}.default/extensions.cache
.prism/{randomstring}.default/extensions.ini
.prism/{randomstring}.default/key3.db
.prism/{randomstring}.default/localstore.rdf
.prism/{randomstring}.default/mimeTypes.rdf
.prism/{randomstring}.default/.parentlock
.prism/{randomstring}.default/permissions.sqlite
.prism/{randomstring}.default/places.sqlite
.prism/{randomstring}.default/prefs.js
.prism/{randomstring}.default/secmod.db
.prism/{randomstring}.default/XPC.mfasl
.prism/{randomstring}.default/xpti.dat
.prism/{randomstring}.default/XUL.mfasl
.prism/{randomstring}.default/Cache/
.prism/{randomstring}.default/Cache/_CACHE_001_
.prism/{randomstring}.default/Cache/_CACHE_002_
.prism/{randomstring}.default/Cache/_CACHE_003_
.prism/{randomstring}.default/Cache/_CACHE_MAP_

For Each WebApp Prism creates (Linux as of Prism v0.9):

Under /home/{user name}/.prism/

{webapp name}/
{webapp name}/{randomstring}.default/
{webapp name}/{randomstring}.default/Cache/
{webapp name}/{randomstring}.default/Cache/_CACHE_001_
{webapp name}/{randomstring}.default/Cache/_CACHE_002_
{webapp name}/{randomstring}.default/Cache/_CACHE_003_
{webapp name}/{randomstring}.default/Cache/_CACHE_MAP_
{webapp name}/{randomstring}.default/cert8.db
{webapp name}/{randomstring}.default/compatibility.ini
{webapp name}/{randomstring}.default/compreg.dat
{webapp name}/{randomstring}.default/cookies.sqlite
{webapp name}/{randomstring}.default/extensions/
{webapp name}/{randomstring}.default/extensions.cache
{webapp name}/{randomstring}.default/extensions.ini
{webapp name}/{randomstring}.default/key3.db
{webapp name}/{randomstring}.default/localstore.rdf
{webapp name}/{randomstring}.default/mimeTypes.rdf
{webapp name}/{randomstring}.default/.parentlock
{webapp name}/{randomstring}.default/permissions.sqlite
{webapp name}/{randomstring}.default/places.sqlite
{webapp name}/{randomstring}.default/prefs.js
{webapp name}/{randomstring}.default/secmod.db
{webapp name}/{randomstring}.default/XPC.mfasl
{webapp name}/{randomstring}.default/xpti.dat
{webapp name}/{randomstring}.default/XUL.mfasl
{webapp name}/profiles.ini

From the above lists of file locations, it should be apparent (okay, if you really really look, hard) that there are two ways to go about installing an extension for Prism. The first is install that extension “globally”, which is to say that you install that extension for every webapp. For this method the extension gets installed into Prism’s extension directory. The second method is to install the extension “locally”, or on a per-webapp basis. In this case each extension is installed in the individual webapp’s extension directory.

The first method is more difficult because by default, installing an extension will be done when you have a webapp loaded, so it will install the extension into that webapp’s extension folder. In order to install a webapp globally, you’ll need to perform a manual installation or open a new webapp that loads the addon’s xul (chrome://global/content/config.xul). I should mention that this worked on Prism/Webrunner 0.8, but I have yet to test this on Prism 0.9, so this may no longer work.

…

So, why they heck would I list all the files and directories here? Well, I want a reference to point at when I start explaining which files to make changes to in order to install an extension manually.

Code Snippit for Prism Extensions’ install.rdf

<em:targetApplication>
  <!– Prism –>
  <Description>
    <em:id>prism@developer.mozilla.org</em:id>
    <em:minVersion>0.8</em:minVersion>
    <em:maxVersion>1.0.0.*</em:maxVersion>
   </Description>
</em:targetApplication>

Code Snippit for Prism Extensions’ extension.rdf (information is required from the **install.rdf**)

<RDF:Description
    RDF:about="urn:mozilla:item:{**extension id from install.rdf**}"
    NS1:installLocation="app-profile"
    NS1:version="**from install.rdf**"
    NS1:optionsURL="**from install.rdf**"
    NS1:iconURL="**from install.rdf**"
    NS1:name="**from install.rdf**"
    NS1:description="**from install.rdf**"
    NS1:creator="**from install.rdf**"
    NS1:homepageURL="http://**from install.rdf**"
    NS1:contributor="**from install.rdf**">

More to come…

Step 1
Navigate to the Prism installation directory, in Windows this is:
C:\Program Files\Prism\

Open up the extensions folder, then the DOM inspector extension folder:
C:\Program Files\Prism\extensions\inspector@mozilla.org

Now open the “install.rdf” file and find this section of code which can be used (usually) as-is in most extensions pasted in the right place (just use the extension’s preconfigured targets as your guide on where to place it):

<em:targetApplication>
<!– Prism –>
<Description>
<em:id>prism@developer.mozilla.org</em:id>
<em:minVersion>0.4</em:minVersion>
<em:maxVersion>1.0.0.*</em:maxVersion>
</Description>
</em:targetApplication>

Step 2
Open up your extension’s xpi file using 7zip or your favorite archiving tool and extract the install.rdf file.

Open that install.rdf file with a text editor (other than notepad which doesn’t understand the line breaks used by other editors) and find the area where it lists the installation targets and insert your copied text into that or modify one of the install targets with the appropriate information from the DOM inspector extension install.rdf file.

Step 3
Install the extension. This will get tricky due to the way Prism’s developers have modified the profiles and what not. Well, I say that, but it really only gets that tricky if you’re manually installing the extension. Prism developers have seen fit to include the Addons menu item from the Prism menu in the lower right of Prism’s window to help things go more smoothly.

One of the ways to use this new install feature for an extension is globally, which means all webapps will be able to use the extension. This is the least preferred manner due to the fact that you won’t want all extensions available for all webapps in most cases. An example would be having the Better Gmail extension available for Bloglines – don’t think that’s real necessary, do you? So plan accordingly.

Using the second, and more preferred method, you just open your webapp. Open your webapp’s Addons panel, then install by either dragging and dropping the extension onto it, or by clicking the “Install…” button and navigating to the extension and selecting it for installation.

Conclusion
That should be about it. My next Prism post will be about how to make one of two stand alone Firefox/Prism exention webapps – POW local server or Scribefire standalone webapp. Stay tuned, we get to play with chrome!!

Links:

Prism

LifeHacker’s linked to my post on how to install extensions in Prism/Webrunner. For anyone having trouble with some extensions, have a look at my comment dated today (080404), I’ve addressed Better GCal specifically, but this should also work for Better Gmail and a few others as well.

Prism/Webrunner extensions post

• a file archiver – my favorite is 7-zip, but you can just as easily use any archiving program that is compatible with zip files
• a text plain text editor

For more advanced webapps, a more advanced context highlighting text editor can be helpful for coding custom style sheets or adding javascript customizations. And don’t forget icons! I use a combination of Paint.Net and @icon sushi (which covers everything but MacOS, which is because I can’t seem to find software for Linux or Windows to accommodate icons for it – recommendations anyone?).

The No “.webapp” WebApp

There are several ways to open webpages with Prism or WebRunner. The first and easiest is to install Prism, then create a link to it on your desktop. Then change that link adding the option “-uri” and the url of the page you want to open. Here are two examples:

Windows:
c:\your\path\to_prism\prism.exe -uri http://web_url_of_site c:\your\path\to_prism\prism.exe -uri c:\location\of\local_file

GNU/Linux:
/your/path/to_prism/prism -uri http://web_url_of_site /your/path/to_prism/prism -uri /location/of/local_file

This method does not require a webapp file, it just launches the website or file you specify. This means, no icons are required, but you also don’t get to add any custom themes or js files. This would be a really good method to use with applications like Wiki on a Stick (woas).

WebApp Bundles

The second method is also pretty straight forward (until you make it complex by adding more functionality). For the most basic webApp bundle you only need to create one file; the webapp.ini. Here’s the content from the example webapp.ini on the Prism wiki:

[Parameters] id=unique-app-id@unique-author-id.whatever uri=http://[the-url-what-you-want-to-connect-to]/ status=yes location=no sidebar=no navigation=no

The “id” parameter is required to be unique. I’ve been using my website’s url (as most others have done as well) preceded by the name of the site, but any unique identifier will work. The “uri” parameter is required and will accept both url of the target website as well as local file paths. Everything after that appears to be optional and the values show are the defaults. These remaining parameters are options to tell Prism whether or not to show certain GUI elements (“status” = status bar;”location” = address bar;”sidebar” = sidebar;”navigation” = well, quite frankly, I have no idea – maybe navigation buttons that haven’t been implemented yet?).

The next step after saving your changes to this document, is to use your archiving program to zip up this file creating, as an example, “your_webapp.zip”. Replace the “zip” extension with “webapp” and you’re ready to roll! Now either double click the webapp file or you can launch the webapp from the command line thusly:

Windows:
c:\your\path\to_prism\prism.exe -webapp your_webapp_bundle

GNU/Linux:
/your/path/to_prism/prism -webapp your_webapp_bundle

For more advanced webapps you can add icons, scripting and style sheet support (see the Prism page for more details).

Happy coding!

Prism
Prism/WebApp Bundle
Prism/Scripting
Prism/Styling
7-Zip
Paint.Net
@icon sushi
Wiki on a Stick

Included in this webapp are the source files for the icon I created using Paint.Net (so you can change the background color or make other changes if you’d like – just keeping within the remix/open culture vein) . Enjoy!

Remix – NIN Remix site

Remix.NIN-WebApp (let me know what you think!)

Prism/WebRunner

Update!!
Had to add a comment to the replacement code below in order for this to work.

080404 Update!!
Yet again, code changes for new versions and what not.

Looks like Mozilla has added WebRunner to it’s Mozilla Labs line up and changed the name to Prism. From what they say, it’s going to be a cross between an open version of Adobe Air and Microsoft Silverlight and a localized lancher for web applications. Which, by my definition, is what utility computing is supposed to be like. Prism is currently for Windows only (they’d better hurry up with a Linux version), but it runs the same webapp files and also has added style sheet support – among other things – so you can style your webapps your way.

Anyway, I’ve been kind of discouraged by the lack of extension availability for WebRunner (and XulRunner for that matter). You’ll find in another of my posts a webapp for accessing the WebRunner extensions panel. Using this webapp, you can add new extensions (by installing or dropping them onto the panel), but at this point, adding extensions will fail because the version checking mechanism for WebRunner/XulRunner. To get around that, you need to change the extension’s compatibility information. These instructions will not work for every extension and your results will vary…

I recommend you find a smaller extension, download it and make the following changes:

1. Open the extension package (you can open it with 7-zip, ALzip, Winzip or any other archive program that works with zip files.
2. Extract and open the install.rdf with a text editor, I’d recommend Wordpad if your using windows.
3. Locate and change the following or something that looks like the following (this will vary by extension, but look for the Firefox description section – and you may find that you have to remove all references to all other Mozilla programs that the extension is compatible with for this to work):

<!--Firefox-->
<RDF:Description RDF:about="rdf:#$djS7s"
  em:id="{ec8030f7-c20a-464f-9b0e-13a3a9e97384}"
  em:minVersion="0.8"
  em:maxVersion="2.0.0.*" />

To:

<!--Webrunner-->
  <RDF:Description RDF:about="webrunner"
    em:id="webrunner@webapps.org"
    em:minVersion="0.1"
    em:maxVersion="10.0" />

or (again it will depend on which way the developer implemented the Firefox description):

<em:targetApplication>
  <!--Webrunner-->
  <Description>
    <em:id>webrunner@webapps.org</em:id>
    <em:minVersion>0.1</em:minVersion>
    <em:maxVersion>10.0</em:maxVersion>
  </Description>
</em:targetApplication>

If you’re using Prism, change to the following:

<RDF:Description RDF:about="prism"
  em:id="prism@developer.mozilla.org"
  em:minVersion="0.1"
  em:maxVersion="10.0" />

or

<em:targetApplication>
  <Description>
    <!--Prism-->
    <em:id>prism@developer.mozilla.org</em:id>
    <em:minVersion>0.1</em:minVersion>
    <em:maxVersion>10.0</em:maxVersion>
  </Description>
</em:targetApplication>

4. Then save the rdf file and add it back into the xpi archive.
5. You should be ready to install the extension using the Extensions.webapp

I found this parts of this bit of magic on Alex Sirota’s website along with the tip to check in the applicaiton.ini file for any XulRunner application’s ID. If you run into errors, then something is probably malformed in the rdf file so check that first. I won’t be much help in trouble shooting, and I’m not about to offer support for other peoples extensions on an unsupported application, but if you have problems, post a comment and I’ll give editing the rdf a go myself.