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).
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
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
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".
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.
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.
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.