Make Your Desktop Come Alive with GeekTool

This post is part of a series that revisits some of our readers’ favorite articles from the past that still contain awesome and relevant information that you might find useful. This post was originally published on April 19th, 2010.

GeekTool is a really neat preference panel that allows widget-like functionality on a highly customizable level.

Unfortunately, if you aren’t particularly geeky, this app can be a bit confusing to get up and running. Luckily enough, here at AppStorm there’s definitely no shortage of geeks such as myself to help you out! I’ll take you step by step through finding and installing scripts to make your desktop the envy of the office.

Final Result

Just to get a feel for where we’re going, here’s a preview of the final result.

Final Result

Final Result

As you can see, this is a simple setup that utilizes only two scripts: date and time. These scripts run live on top of your desktop, automatically stay behind any active apps, and are not selectable and therefore don’t get in the way. It really is just like having an active wallpaper image.

The text that you see is live and updates automatically based on intervals you set. Despite the odd setup, it really is fairly easy to get something up and running so don’t worry if you aren’t at all familiar with scripting. You don’t need to write a single line of code, as long as your copy and paste abilities are intact you’ll do just fine.

Before you start, it’s a good idea to setup a fairly solid desktop background so you can easily see what’s going on while you’re working.

Getting Started

The first thing you’ll want to do is grab GeekTool. It’s a free download and only takes a minute to install.

GeekTool Website

GeekTool Website

Once you’ve run through the installation, you might be tempted to turn to your applications folder but remember that this is a preference panel and not a standard application. Open up System Preferences and click on the GeekTool icon to bring up the following windows.

GeekTool Interface

GeekTool Interface

On the left side of the main window you should see three icons representing the three different options for “Geeklets” that you can implement: File, Image and Shell. This article will focus mostly on the shell option as it is both the most powerful and the most complicated to figure out on your own.


On the right side of the main window you’ll see the options for managing groups. These are extremely useful in that when you find a setup you like containing various Geeklets, you can save it out as a group, then experiment in a new group without losing your preferred setup. Alternatively, you could have a work group and a home group, a weather focused group and a social media group; you get the idea.

Checking and unchecking a group will allow you to activate it and checking the “Show in menu bar” option will make it easy to change groups on the fly.

Menu Bar Options

Menu Bar Options

Geeklet Settings

To create a new Geeklet, drag one of the three icons out onto the desktop; in this case, we’ll choose a script Geeklet.

After you release the icon on your desktop, an empty box should appear, and the Geeklet properties window should come alive with various options for customizing the Geeklet. There are five distinct sections in this window: General Settings (name, size, position), Groups, Command, Status Feedback, and Style.

Menu Bar Options

Geeklet Properties

The General Settings and Group sections are fairly straightforward, these allow you to assign a group to the Geeklet and give it a title. The Command section is where you will input the code for the Geeklet. This section also contains options for the refresh rate and timeout interval for the Geeklet. Finally, Status Feedback allows you to implement pictures notifying you of whether or not a Geeklet is working and the Style section is where you will format text.

How It All Works

The basic idea here for all non-script writers is that you go can online and look for cool GeekTool scripts. When you find one that you like, simply copy and paste it into the Command section of a Geeklet and the use the Style section to customize it to your liking. Many of the scripts are pretty simple and easy to figure out even if you have no coding background, others are more complicated and therefore harder to customize if there is something you want to change.

Basic Starter Scripts

Below is a list of fairly basic scripts that will allow you to create a simple time and date setup. To insert these into your Geeklet, just copy and paste the colored code snippets.

  • Long Day:
    date +%A

    (Result = Saturday)

  • Short Day:
    date +%a

    (Result = Sat)

  • Long Month:
    date +%B

    (Result = April)

  • Short Month:
    date +%b

    (Result = Apr)

  • Long Date:
    date +%D

    (Result = 4/17/10)

  • Short Date:
    date +%d

    (Result = 17)

  • Time:
    date +"%l:%M %p"

    (Result = 5:00pm)

  • Calendar:

    (Result = A basic calendar of the current month)

Combining Scripts

Keep in mind that each script that you find doesn’t have to stand on it’s own in a separate Geeklet. Combining scripts gives you a much wider range of options. Consider the following example:

Combining Scripts

Combining Scripts

As you can see, by combining the three of the available date scripts, we were able to make one complete date string.

Putting scripts into action

As stated above, to implement a script, drag out a Geeklet and paste the code into the Command section. For instance, we’ll start by pasting the code date +”%A %b %d” into the command window.

Date Script

Paste the Date Script into the Command Window

When I first downloaded GeekTool, I became quickly frustrated that I wasn’t seeing a result upon pasting in my code snippet. After giving up and coming back months later to give the app another shot I realized that I simply wasn’t seeing the result because the default text color is black and my desktop at the time was also black!

So the first thing we’ll want to do after pasting in the code is to change the color of the text to something that clearly stands out on your background. We’ll also change the size to make it nice and large.

To do this, click the button in the Style section that says “Click here to set font & color…” That should open up a basic font palette with options for size, color, shadow, etc. Set the everything to match the screen below (adjusting for your personal taste and wallpaper).

Font Size

Adjust the Font Size and Color

Now drag out a new script Geeklet and add the following time string: date +”%l:%M %p”. Line it up on the right side of the date and apply the font settings below:

Time Geeklet

Create a Smaller Time Geeklet

That’s basically all there is to it! If you really want to go nuts you can option-drag a Geeklet to duplicate it and play with increasing the size and reducing the opacity. This will give you similar results to the image at the beginning of this post.

Final Result

Final Result

File and Image Geeklets

If you want to use a File or Image Geeklet, the process is pretty much the same. Simply drag them out onto the desktop and customize the preferences. For both of these you’ll simply need to choose a local path to grab from.

For the Image Geeklet you can either choose a single image or an entire directory to scroll through. The File Geeklet comes in handy if you want to display a quote or something similar on your desktop. Just create a text file containing the word or phrase you want and link to it in the Geeklet properties. Then you can customize the appearance just as with the Script Geeklet.

Where to Find More Scripts

The single best source I’ve found for scripts is the Geeklets section of Mac OS X Tips, a handy blog that you should definitely add to your reading list.

Geeklets Site

Geeklets Site

The Geeklets site is packed with scripts for all kinds of purposes and continues to grow. Alternatively, you can check out the posts below for some more Geeklet goodness.


In this post we briefly discussed the functionality of GeekTool and how to get some basic scripts up and running. We also looked at a few great resources for finding tons more scripts to increase the functionality of your GeekTool setup.

After you get yours setup, be sure to upload a screenshot to Flickr (or any image sharing service) and share it by leaving a link in the comments below. Also,be sure to paste in any neat scripts you come across or write yourself!


Add Yours
  • Just for the notes – there is Nerdtool too – with some smaller diffs to Geektool.

    Best Regards

  • How did you get the drop shadow on your console commands? I didn’t think that option is available in RC5.

    • I also questioned that in my mind, but I found a really simple way to add drop shadows… make the windows of where you change the font bigger. For some reason, by default, it’s too small that it hides the drop shadows settings. =D

    • Mine wasn’t showing either until I found out that by dragging the font box wider it appeared, maybe it’s as simple as that for you too

  • I love using GeekTool and have been inspired by desktops I have seen around the Internet. See my link for some of my own creations if you’d like some inspiration.

    • Edit: by ‘see my link’ I mean click on my name.

  • A word of caution, running geektool will cause your machine to not fully sleep. A bummer on a laptop, when you close it with a full battery, only to open it a few hours later with it mostly drained.

    • I never knew this for a while and was getting really annoyed, found it out though and haven’t gone back to Geektool since. It’s something I can live without, since I’m not normally on my desktop most of the time and starting to use Dashboard more.

      Also the end result in the tutorials is a bit below par, there are much better outcomes.


    I made a (more or less) exact replica of The HTC sense UI for my Mac desktop using Geektool. I pretty proud of it. :)

    I wrote up a guide on how to make it and included a few resources over at Macrumors if anyones interested in making it.

    Here’s the link. Read on after my post as a lot of other forumers have added to my original idea with some other cool scripts.

    • Wow, that’s impressive stuff! Thanks for sharing. :)


      My modification of the HTC sense clock, modded to look like the Windows Phone 7 Series clock. This is for nerdtool btw. I have the files if needed.

  • Finally a good Geek Tool tut. Thanks for that, the app isn’t very user friendly.

  • It’s interesting to see this Geektool tutorial after the Pagico Pro quick look, since these two apps can work together and you can display your todo lists right on your desktop. It’s a very handy feature.

  • Here’s one I setup a wile back… I stopped using it because it turned into a bit of maintenance to keep the fonts and sizes to appear properly. It would randomly reset to defaults fairly often. I think it was due to Font Explorer X conflicting, I’m not sure.

    • What’s the wall? I make make this one when I get bored of my old setup?

  • I have used geektools for a while and think its a great way to show some details that i will look at regularly ive written a few guides on it on my website.

    Ill also be adding another article on displaying google analytics information in the next week or two

  • THANK YOU! Thanks especially for being so detailed. I found dozens of tutorials for GeekTool online and ALL of them left out important little bits of information, like how you actually get the program to work without going back to college and getting an advanced degree in geek terminology! It was driving me crazy! Geeks really stink when it comes to writing manuals and tutorials. I don’t know why they even bother because most of what they write is completely useless to the casual reader. But you’re write up gave me exactly what I needed and I got the program working in minutes. Thanks again!

  • them left out important little bits of information, like how you actually get the program to work without going back to college and getting an advanced degree in geek terminology

  • Here’s what I managed, even though I’m not a high ranking geek. Very cool, thanks!

  • Here is the best geek tool set up i’ve seen yet

  • Here is the best geek tool set up i’ve seen yet

  • This is a good tutorial…I wish I had found it earlier.
    Here’s a little binary clock geeklet I made using ImageMagick

  • Dumb question but I am new to geektool and I was wondering how you get the scripts to be behind the desktop icons?

  • COOL! Really a excellent tutorial! Thanks!

  • appstorm once again a GREAT review, good job!

  • Mad Men desktop with image folder for Don to look at[email protected]/

  • Hi, every time I shut my computer down and start it up again, my date and time disappear. Also, my time doesn’t update by itself. Help!

  • You should update the article to reflect that GeekTool is now available on the Mac App Store.

  • It’s really funny to me that there are things like this out there that are so hard to use and don’t look so good and Konfabulator was released 9 years (9 YEARS!!) ago by Arlo Rose and worked better than this stuff.
    It’s too bad he stopped development on it and sold it off to Yahoo because of Apple’s Dashboard.

  • Very cool, thanks for sharing !

  • This is a great blog posting and very useful.

  • I read a blog recently that talks about this very topic, just not as gracefully, great job on the post.

  • My first setup. everything was quite easy to figure out… /Users/JT/Desktop/Screen Shot 2012-03-17 at 9.36.53 PM.png

  • Recently I visited your site. It was my first visit and I have to say it’svery ok. It seems to me is well constructed by images and you have some very interesting idea.