GeekTool: Turn Your Mac’s Desktop Into An Information Center


Being a geek, you have the urge to modify everything you own. That’s of course applies to your desktop as well. You saw how your Linux friends can modify their desktop and display information with Conky and you are dying to have the same setting in Mac. If that is the case, then GeekTool is the one you are looking for.

GeekTool is a System Preferences module for Mac OS 10.5. It allows you to display information on your Mac desktop so you can quickly check out the time, your Twitter stream, or any other things without any hassle.

Let’s get our hands dirty, shall we?

To fully utilize GeekTool, you got to have a simple knowledge of shell command. But don’t worry, we will guide you through and make it easy for you.

Download GeekTool here and install it in your Mac.

You should now see the GeekTool entry in your System Preferences.


Adding day, date and time to the desktop

Open GeekTool and drag the shell icon to the desktop.


A blank holder and a configuration window will appear. The holder is where your information will appear. You can drag and move it to the position you desire. The configuration window is where you customize the shell command, font size, color etc.

In the configuration window, add the following command to the Command field.


The above command will produce a clock that displays time in 24 hour format, minutes and seconds. It is important to note that for this script to be properly effective you have to update it every second, or every minute (naturally you just put 60 in the Refresh Every field) if you do not include the %S portion of the command.

After you have the clock on your desktop, drag another shell script onto the desktop and add the Month by using

then drop another one on your desktop and add the command

in order to put the number on the desktop. Once you have all these dropped on to the desktop you can start changing the fonts to whatever you desire, making them very personalized in the process.

There are some very interesting ideas of what to do with GeekTool within this flickr tag set.

Adding Twitter stream to your desktop

If you want a twitter stream on your desktop, then the command is

make certain to substitute your username and password in the appropriate space.

Adding calendar event to desktop

If you are keen to place your iCal event in your desktop, you might want to install the custom build of GeekTool by icalBuddy instead.

1. Download custom build of GeekTool. Install it in your system (replace the old GeekTool if required).

2. Launch GeekTool from System Preferences.

3. Click New from the left bottom pane. Select “Shell” from the right dropdown field.

4. Insert the command:

to show all uncompleted tasks, separated by calendar.


You can also check out the icalBuddy manual page for more information on configuring your iCal events.

Adding Facebook feed to the desktop

This involves a series of steps that I won’t go into detail here. You can check out this flickr page for the full detail.

In a nutshell, you have to

1. Create an Automator action that grabs your Friend’s status feed. You can get this feed URL after you have logged into your Facebook account

2. Using the Automator to extract the text from the RSS feed and formats the text with the title, author, and date. Save the text in a txt file. Also save the Automator as a workflow.

3. In GeekTool, you got to insert two shells, one for the workflow and another to display the text file.
Create a new shell called “Workflow refresh” and paste in the code:

Create another shell called “Facebook” and paste in the code:

Adding weather information to the desktop

The final item I’ll contribute now is putting weather on the desktop. This one is another shell script that runs in the command field. Make certain to change the city code to the one yahoo weather provides for your city,

Now you can style the results according to the fonts and colors you want in order to make your desktop stand out as a beautified Information Center.

There are plenty of things that you can get GeekTool to display. What we have mentioned here is only few of the many tricks out there. What is your favorite GeekTool tricks? Share it with us in the comments.

Nathan Eckenrode

Nathan is a geek living in New York City. His first computer was a TRS 80 Color Computer and he's been hooked on technology ever since. He has recently finished an Interdisciplinary Degree at NYIT with focuses in Computer Science, Mathematics and Business. He has worked in Film & Television Production, on a dot-com company, as a Nuclear Reactor Operator, represented the Ubuntu User Community at the UN and once played guitar for a punk rock band. He keeps a blog dedicated to his creative urges at and really likes using his iPhone to pacify his kids.


  1. Great guide, but added iTunes-support would have been good as well :)
    It seems this guide is mostly based on GeekTool 3 although the iCalBuddy is based on GeekTool 2. Is it possible to have both tools installed or is a downgrade neccesary if I've already installed (and configured) GeekTool 3?

    1. The way I use GeekTool with iTunes is getting the title, artist, album & star rating from an AppleScript I made and getting the album art via the free TunesArt. Works great.

      It looks like this:

      I’ll email the Applescript, if anyone wants it.

  2. ITunes support ISA bit more tricky and actually geektool is not the best option to get it done. iCalBuddy can and does play nicely with the newest version of GeekTool so worrying need not be done.

  3. What option would you then recommend, if the iTunes-info has to be on the desktop (and not in i.e. the menu bar like YouControlTunes)?
    When I download the latest version of iCalBuddy it's GeekTool 2 and it asks me to replace the current version of GT (which is version 3) – is it safe (and sound) to do a downgrade?

  4. hi guys I really need help here. I can't see the shell that i created for facebook. I did everything right (i think haha.) Can someone help me? And also you can't get the friends status feed anymore by their site, I had to go to my friends' notes, and clicked subscribe and i subscribed to their notes. Then, i changed the “friends_notes” to “friends_status”. Then I was able to get the link. From that point on I did all the steps, but nothing came up.

  5. How do I get it to display degrees in Fahrenheit? I tried switching the C (before the <BR, which is where I've seen it change in other code that hasn't worked for me) to F, but once I do it ceases to work altogether.

  6. hey anybody know how to insert plain text as a shell? I just want a quote on my desktop, but dont know how. please help

  7. I wanted to add a shell command in it (top) but unfortunately, it looks like it’s not working. Any idea?


    1. You can’t run top on its own because of the screen clear commands it issues. You have to use “-l 1” so that it only requests data once. But you actually have to request it twice using “-l 2” to get accurate cpu% readings. So I built a shell window that ran top with -l 2, and dragged the window past the top edge of my screen to hide the less useful first run of the command.

      For the author:
      Twitter doesn’t support basic authorization for the CURL command so it doesn’t work. Plus, having that comma at the end produces an error:

      sed: 1: “s// /,n”: bad flag in substitute command: ‘,’

Comments are closed.