Calendar Folders

Calendar Folders is an extension for future versions of Mozilla Calendar and Sunbird. It provides a way to group calendars in folders. It also provides a clock.

For installation instructions, see the bottom of this page.

The current version of Calendar Folders is a prototype for Sunbird 0.2+ test builds only.

In this prototype, some features do not work at all and some others are buggy.

There is no version of Calendar Folders for the current release, Sunbird 0.2, and there is no version for any Calendar extensions or Lightning.

The Calendar Folders project is a subproject of Calendar Help.

Why use Calendar Folders?

Use Calendar Folders when you often work with many calendars, so that you can easily view groups of calendars at the same time.


You work on two projects, codenamed Alum and Borax. You have three colleagues Cedric, Daisy and Evan in your department. Cedric also works on Alum and Borax, but Daisy only works on Alum and Evan only works on Borax.

Each of you has a personal calendar and a calendar for each project. The project calendars are shared on a server. So there are ten calendars in all: four personal calendars, and six shared on the server.

In Sunbird, you can work with your personal calendar and the six shared calendars. (You cannot work with other people's personal calendars.)

Here the seven calendars that you can work with:

Working with your own calendars

To work with your own three calendars, you place them in a folder named Me:

When you select this folder, you see these three calendars but no others. The default calendar for new entries is Personal.

Working with project calendars

To work with project calendars, you place them in folders:

When you select a project folder, you see the calendars for that project but no others. The default calendar for new entries is your calendar for the selected project.

Using Calendar Folders, you can also give the calendars different names and different colours in each folder.

Default folders

When you install Calendar Folders and restart sunbird, you two folders are created automatically, named All and Default.

The folder All is a special folder that contains all you calendars. It is very like Sunbird's original Calendars list. You cannot delete this folder (but you can rename it).

The folder Default contains whatever calendars are active when Calendar Folders first runs. You can work with this folder just like any other folder.

Working with calendars and folders

To work with calendars and folders, use the entries in the Calendar Folders list, and use the context menus. (To obtain a context menu, you can right-click, or use the Menu key on your keyboard, or use some other method depending on your system.)

Creating and maintaining a folder

To create a new folder, choose New Folder from the context menu.

Give the new folder a name.

To populate the new folder, drag calendars from the All folder and drop them in the new folder:

To specify the default calendar for new entries in the folder, click one calendar's icon. The icon displays a radio button to show that it is the default.

To remove a calendar from the folder, drag it back into All.

Changing calendar properties

The names and colours of calendars apply within a folder. So a calendar can have a different name and a different colour depending on the folder.

For example, in each project you might name the project manager's calendar Project Manager, and colour it blue. Suppose you are the project manager in one project. In that project's folder, your calendar is named Project Manager and has the coloour blue. But in other folders the same calendar has a different name and colour.

This feature can be confusing. Only use it if you have a specific purpose for different names and colours.

To rename a calendar, select it in the Folders panel, then click on its name. To change a calendar's colour, click on its colour patch in the Folders panel.

To reload a remote calendar, click on its reload marker (a small blue circle at the right of its colour patch).


To set options for Calendar Folders, choose Tools – Options... from the menu bar. Go to the Folders page.

Choose whether to display tabs for the clock and the original Calendars list.

Specify how to display the date and time in the clock. To use your operating system's settings, uncheck the Long box for the date and choose System for the time.

To ensure that only one folder can be selected at a time, check the Single folder box.

To lock calendar names or colours so that they remain consistent between folders, check the Name or Color boxes.

Installing Calendar Folders

To install Calendar Folders, choose Tools – Extensions... from Sunbird's menu bar. Drag this link and drop it in the Extensions window:


Restart Sunbird. If the installation succeeds, you see the About Calendar Folders window. To dismiss it, click on the background of the window (or press Escape).

Uninstalling Calendar Folders

To uninstall, return to the Extensions window. Select Calendar Folders and press the Uninstall button. Close Sunbird.

Go to your profile directory and delete the file calfolder.rdf. Edit the file prefs.js and remove all the entries that contain calfolder. Restart Sunbird.