Gear on your virtual life

CalendarCog Square Documentation

The CalendarCog Square allows you to receive and display reminders for events by pulling data from a Google Calendar. The advantage of this system is that if you have an event or activities you wish others to know about, you can do so easily without sending someone outside the Second Life viewer. Since these events are stored on a Google Calendar, you can do all of the things with it that you can with a normal Google Calendar, including displaying on a Website, viewing it while you are in Real Life, and using it with other applications that interface with it.

Please do not rez your CogSquare until you’ve read these instructions!

If you do not have a Google Calendar account, please sign up for one before trying to use these products. You can get one for free at http://www.google.com/calendar. You should set up one calendar with at least a name and some dates so you can get started. Take the tour to learn more about Google Calendars at http://www.google.com/googlecalendar/tour.html.

Getting Started

  1. To begin using your Square, simply rez it.
  2. If it is the first time you have used it, and you have not set up any previous Calendar Cog objects, you will be given a temporary password and asked to go to the Calendar Cog Website (http://www.calendarcogs.com) to finish the setup.
  3. Use the password provided in chat to register your Square.
  4. You will be given an opportunity to change the password during setup.
  5. Once you have completed the set up, return to Second Life and reset your Square by touching it (only the owner has the ability to reset)


The notecard 0_Settings must be present and governs various aspects of the Square’s behavior, which are fairly self-explanatory. To let the Square use its default, place a semicolon (;) in front of the setting. Here is the text of the settings notecard:

  • PrivateName=SquareSM (This appears on the Website and can be applied to groups of squares, allowing them to share the same calendar settings. It is used by the CogHUD to identify calendars and make changes.)
  • LoopingDelay=30 (This sets the time (in seconds) that each event is displayed before the next one is shown.)
  • Title=Demo (You would want this changed to what the public will see when they encounter the Square. Remember, you can have multiple squares.)
  • Looping=true (True turns on looping, false turns it off.)
  • TextColor=<1,1,1> (The number refer to RGB equivalents to set the text color.)
  • ;InfoNotecard=My Notecard (Because of the semicolon, this is set to default, meaning the square will not give a notecard to the avatar who touches it. You will want to create your own notecard and activate this setting if you wish for the square to give out information in that manner.)
  • LockOUT=30 (Lockout is the amount of time (in seconds) that the dropdown options menu will wait for someone to click on choices. During that time, no one else can get events from the square. The moment a selection is made, the “lockout” is removed regardless of the amount of time left on this internal clock.)

Please note that some activities may be easier with the purchase of the CogHUD object.

The CalendarCog Website

  • The CalendarCog Website (http://www.calendarcogs.com) provides a way to attach your objects to more than one Google Calendar. Suppose you want to have your HUD tell you about your personal events, the events for a role-playing group you are in, and the events at the local dance hall. All you have to do is log in to your “Set up Cogs” page and choose “Aggregation” under the drop-down menu for the object listed (could be your HUD or a Square). On the next screen, you can choose multiple Google Calendars from the list of your own calendars as well as “add a calendar from the public directory.” (You are then provided forms for searches based on owner name, title, directory, or a drop-down menu generated from Google Calendars to which you have been given access.)
  • The CC Website also allows you to create directories of your various Google calendars to organize them for sharing with others. Look at the bottom of the Set up Cog screen to find this text: “Directories are calendars of yours that you have decided others can link to their own objects. This can be revoked at any time, and a directory calendar can never be added to by another user.” Use the “Add / Modify / Delete” to access the Directories options page.


If you have any questions contact Paypabak Writer, inworld, via IM or Notecard, or send an e-mail to info@mechanizedlife.com.

Google Disclaimer
Neither CodeBastard Redgrave, Calendar Cogs, MechanizedLife, etc. are affiliated, associated with, or endorsed by Google in any way. CalendarCog products simply take advantage of the great tools Google has made available to Web developers the world over and their use should not be seen as Google giving any sort of stamp of approval.

Copyright © 2008 MechanizedLife

Store Locations

Get our store locations and online storefront.

Featured Products

Check on those specials to enhance your digital life.