Aggreg8, The RSS Feed Aggregator.
      
   
Installation Guide

Download Aggreg8 Now

What do you need to install Aggreg8?. Aggreg8 requires a mozila Based browser to run. Mozilla itself and Firebird are two options available, they can be downloaded from here:

Once you have installed one of the browsers above, there are two ways to install Aggreg8, I will discuss each of them individually.

The screenshots depicted below might look a little different from yours as I have Orbit 3+1 theme installed (it's my favourite theme).

Using the automatic Install Script to install Aggreg8.

Installing Aggreg8 automatically is simple, while you are running your Mozilla browser (Mozilla or Firebird) click on one of the Install links above or alternatively on the Download Page and the install script will run. You will be prompted with dialogue Pictured in fig. A
fig. A Install Dialogue
Once you click on "Install" the automatic install script will start running. If all is successful you will be prompted with two sucsess dialogues, The first fig. B will request you to restart the browser: This is nescessary so that the browser can read the new settings that have been set by the install script.
Fig. B Success Dialogue #1
Figure C is the final dialogue you will be prompted with. This is just the install script telling us that the installation is complete and that it was a success.
Fig. C Success Dialogue #2
Aggree to both of these dialogues and restart your browser and Aggreg8 will be installed.

Starting Aggreg8.

If you are running Mozilla you can run Aggreg8 by navigating to the "Tools" menu and choose "Aggreg8 RSS Feed Aggregator" (see fig. D ). This option is not available in Firebird.
Fig. D Choosing Aggreg8 from the tools menu
This will start Agreg8 outside the browser (it will be running independently of the browser see screenshots of this). Alternatively you can run Aggrge8 inside the browser by entering "chrome://aggreg8/content/aggreg8.xul" into the url bar (see fig. E). This runs Aggreg8 inside the browser as if it were a normal webpage. This is the most useful way of using Aggreg8 as any links in any of the parsed RSS feeds can be opened in a new tab ( Screen shots of Aggreg8 running inside the browser).
Fig. E Running Aggrge8 inside the browser
A user manual is also available to those who need it. The user manual will describe in detail how to set up new categories and how to subscribe to feeds.

Install Aggreg8 manually

No too many people will need to install it manually except maybe developers who wish to extend Aggreg8 or tweak it to suit their own needs. There are two ways of installing manually, by downloading the " aggreg8.jar" or downloading "aggreg8.zip".

"aggreg8.jar" contains all the nescessary files in a jar archive. Mozilla is able to extract and use these files at runtime and therefore it is not nescessary to extract the archive manually, but it must be placed in the chrome directory ( The chrome directory is a subdirectory of the main Mozilla directory (this is where your OS installed your Mozilla browser), it is in the chrome directory that all add-ons and mozilla engines are installed). When an Add-On like Aggreg8 is installed on Mozilla, Mozilla needs to know what add-ons are installed, and what add-ons have recently been installed. (by Mozilla I mean Mozilla based browsers like Mozilla and Firebird). Mozilla uses a file called "installed-chrome.txt" to know what add-ons are intalled. When you have downloaded aggreg8.jar and saved it to the chrome directory, you must update the "installed-chrome.txt" file to inform Mozilla that it has a new add-on. Below you will see the 3 lines that need to be added to the "installed-chrome.txt" file. Note the highlighted text, it informs Mozilla that all files used for Aggreg8 are in a jar archive called "aggreg8.jar".

content,install,url,jar:resource:/chrome/aggreg8.jar!/content/ skin,install,url,jar:resource:/chrome/aggreg8.jar!/skin/ locale,install,url,jar:resource:/chrome/aggreg8.jar!/locale/en-US/

A further explantion of "installed-chrome.txt" file and it's structure can be found in Aggreg8's Technical manual. Once you have updated the "installed-chrome.txt" file and saved aggreg8.jar to the chrome directory, restart your browser and Aggreg8 will be installed.

"aggreg8.zip" is an archive of the same files that are in "aggreg8.jar" only in a different format. All that is described below for "aggreg.zip" can also hold for "aggreg8.jar" (providing you have a jar extracting tool). What I am going to describe now is a way of installing Aggreg8 in such a way that you can view and edit all files that make up the Aggreg8 application. First thing to do is to extract the "aggreg8.zip" archive to the chrome directory (the chrome directory is explained above). Once extracted you should then have a directory named aggreg8 in the chrome directory. Inside this directory is all the code and files that make up Aggreg8, briefly put, the subdirectories of aggreg8 are content (contains all gui [graphical user interface] files and scripts), locale (contains all language specific files) and skin (this contains style information such as CSS files).(The above will be explained in more detail in the Technical manual). We now need to tell Mozilla where to look for the Aggreg8 files, As I mentioned before this is done by adding a few lines to "installed-chrome.txt" file in the chrome directory. But unlike above (where we used the aggreg8.jar archive) we are not using an archive any more and thus the lines added will differ.

skin,install,url,resource:/chrome/aggreg8/skin/ locale,install,url,resource:/chrome/aggreg8/locale/en-US/ content,install,url,resource:/chrome/aggreg8/content/

I have highlighted the parts that differ from when we were using an archive. Now we simply tell Mozilla that the files for Aggreg8 are in the following directories. Now just like before, when you restart the browser Aggreg8 will be intalled.

User Manual

A user manual is also available to those who need it. The user manual will describe in detail how to set up new categories and how to subscribe to feeds.

Notes on installing on Linux or Unix in "non-root" profile.

As a result of having to write to the chrome directory when installing Aggrge8, A user using Linux or Unix that is not logged in as root will not have permission to write to the chrome directory (by default a user profile would not have permissions to write to the directories where mozilla is installed). A user trying to install Aggreg8 in "user" mode will receive an error : "There was an error - 214", which means that a required file does not exist. This has been logged in BugZilla (see bug #3703). There is a workaround however, If you install Firebird, which is just a zip file , in your user account then you will have permisison to write to the chrome directory and as such be able to install Aggreg8 .... Problem solved.



Printer Friendly Version
Aggreg8.net RSS Feed

Technorati Profile || Aggreg8.net is kindly hosted by Redbrick and is owned by Philip Andreas Roche (webmaster) || © Philroche.net ||