Once a tool employed mainly by hardcore users, GeekTool seemed to begin exploding across OS X desktops in 2009. But despite its widening usage, many still are unfamiliar with this fantastic utility (you’ve probably seen it, and not even realized) or just don’t know how to […]


Once a tool employed mainly by hardcore users, GeekTool seemed to begin exploding across OS X desktops in 2009. But despite its widening usage, many still are unfamiliar with this fantastic utility (you’ve probably seen it, and not even realized) or just don’t know how to leverage it. If you fit either of the above stereotypes, then today is your lucky day, because I’m going to point out some great examples of GeekTool, and just how to put it to good use for yourself.

Simply put, GeekTool displays information at the desktop level (meaning it’s not clickable), right on top of your wallpaper image, in a ‘Heads-up-display’ fashion. It’s interesting (to me at least) to see how the use of a simple yet powerful tool evolves. For those of us who began playing with GeekTool long ago, it was used in a very utilitarian fashion — the output was simple lines of text displayed on the Mac’s desktop (three year old screencast here shows what I mean). And while the content that we’re seeing displayed with GeekTool hasn’t changed much, some designer-types out there have taken the display of that information to the next level. The great part is that it’s super easy to do with GeekTool — but more on that in a bit.


To get some inspiration — and a great feel for what we’re talking about — check out Flickr for photos tagged with ‘geektool’, or LifeHacker’s Featured [Mac] Desktops. I’ll be here, so take your time. Or if you’re ADHD, here are a couple quick examples:

So some good stuff, eh? It’s pretty neat to see the way that GeekTool can be used to morph meaningful data into specific wallpaper images, or going that extra yard, to coordinate with a custom GUI theme. Clearly some people have a solid eye for design, and the time to monkey around and put in some extra awesome. Not so much for me, which is why I pointed you in the direction of some great examples. I however, threw in some extra Geeklets on my desktop to show you what you can do.

Getting Started

So now you’re probably primed and ready to put GeekTool to work for you. It’s not very difficult, so let’s get started. I’ll assume you’ve already installed it. Since it’s a Preference Pane, it lives in the System Preferences (found under the Apple menu or in your Applications folder).

There are three types of information you can display using GeekTool:

  • File – Originally intended for viewing Console type log files. Point it at any text file you choose — those with text-based todo lists will love this feature.
  • Image – GeekTool’s developer identifies this as useful for viewing the images generated by monitoring tools. While Analytics and whatnot may be just what the doctor ordered, you can display any image, or image URL with this.
  • Shell – This is where the real power lies with GeekTool. Run either a Shell Command, or point at a Shell Script file to run. If your bash-fu is strong, you’ll be running wild. But fear not, there are a multitude of examples out there to lean on if you need some help with this geekier part.

To begin using a Geeklet (as they’ve been deemed in the 3.0 version), select the File, Image, or Shell that you want to use, and drag it to your desktop. Once there, the Geeklet properties window will populate, which is where all the magic (configuration) happens.

Drag & Drop

The great thing about the latest version of GeekTool is that you can drag and drop your Geeklet wherever you want it on screen. In earlier versions, there was a lot of trial and error involved as you had to enter the coordinates and dimensions of a Geektlet. It was time consuming to say the least — but you can still tweak these settings in the Properties window if you need to fine tune . Once it’s where you want it, define the image or file location of the data you want displayed, or drop a shell command in there. If it’s necessary, there’s space to set a refresh time in seconds.


Now we come to the part that the designers like. Click the aptly named button, “Click here to set font & color…” Up pops an OS X window that should be familiar for selecting font, font color, font size, and so on. Your Geeklet updates in real time, so you can adjust your settings on the fly. Suddenly those log files don’t seem so bland anymore…well, maybe not.


The crazier you get with GeekTool, the more Geeklets you may find yourself creating. You can group them into categories, and turn them on and off as desired. The uses for this obviously vary from person to person based on their workflows. But I could easily see having a set of Geeklets in a group for work information, and a set for home use. A GeekTool menubar item can be turned on so you can quickly maintain these Geeklet groups without having to launch the Preference Pane.


The spot that gives most people trouble is coming up with the shell commands or scripts to run. I have some limited background using Unix, so have come up with a few simple commands in the past. Luckily, there are lots of people out there who are smarter than I, and are happy to share their work with others via blog posts. Yay! Here are several of the more helpful posts I’ve come across.

GeekTool is such a free-form utility that it’s difficult to outline all of the settings and uses. It’s one of those situations where it’s great to let your imagination run wild, if only your knowledge and expertise can keep up. If you find yourself lacking the latter, post your questions below, and if I can’t help, I’m certain some of our brainiac readers will be able to chime in as well. And if you just want to show off your GeekTool-fu, we’d love for you to share some links here as well.

  1. I started using GeekTool a few months ago after I found a great wallpaper screenshot that incorporated it.
    I’ve found that you ca find scripts for most things using Google and a bit of patience but it is best to search for a definite use (like “unread mail count”), since many blogposts only mention a single use.

    Here is my current setup: http://i2.photobucket.com/albums/y36/Pfenya/Screenshots/Bildschirmfoto2009-10-28um092053-1.jpg
    and an explanation of what I did: http://boards.ign.com/mac_general_board/b5146/186399135/p2 (4th post on the page)

  2. I’ve got a blog post up with my current GeekTool setup and the associated commands/scripts: http://umbl.blogspot.com/2010/01/geektool-setup_18.html

    Feel free to use what you like.

  3. @Jenni – That’s fantastic! nice work.

    @Alo – thanks for sharing the info. I’m sure many readers will find those things useful.

  4. Hey guys…
    how about battery life? mine last 2 hours (macbookpro) unplugged…

    1. Hi Pedro, it’s a little off topic, but if you’re having battery life issues, you might read this thread:

      also, try Coconut Battery to see the stats on your battery’s current conditions:

    2. hey sorry for my english, Im from Southamerica…I was trying to ask if GeekTool decrease my battery time….some programs consume battery very fast and you need to find a place where to recharge…

    3. Hey Pedro,

      I haven’t noticed any effect on my battery or have seen a process connected to it show up in the top 5 of my active processes.
      The great thing is that you can specify how often it should update the shell script (in seconds) – so for a calendar or a to-do, you could set it to update once a day, the rest of the time its a static text that shouldn’t draw any processing powers, since it is only showing the results of a query you ran.
      If you try any of the commands in terminal you see how little time it takes to get the results, so it shouldn’t have a significant impact on battery life.

    4. Pedro – no problemo (my Spanish is much worse than your english, I promise :)
      I’ve run GeekTool for years, and my battery life on my MacBooks has always been as I expect it to be. So I would say it’s probably not a concern. Hope that helps!

    5. thanks guys! Im gonna try it right now…

  5. italianomonkey Friday, January 22, 2010

    Hi guys, has anyone tried using geek tool with BumpTop?

    1. didnt work for me. that would be amazing though…

  6. Although you wax enthusiastic about this sw, you have not explained exactly what it does. “GeekTool displays information at the desktop level (meaning it’s not clickable), right on top of your wallpaper image, in a ‘Heads-up-display’ fashion.” This is not an explanation, and your many examples don’t make clear which parts of the display are GT and which are other sw.

    1. My opinion:
      Don’t complain and do what you say yourself (briefly, as it’s a post)

      He helped me, I’m off to download GeekTool.
      Thx, Nick.

      PS: Just one question, does it take up much resources? (ram, cpu)

    2. Dude. Really?

    3. @None – There is no other software running in those screenshots. All you see is a wallpaper image, an icon, and the rest of the info is all GeekTool embedded into the desktop view. And, btw, ‘display’ is a verb, describing the action of something – in this case, what GeekTool does. I’m not sure how else to describe it for you I’m afraid. But I encourage you to give it a try for yourself, and I’m sure it’ll become more clear. It’s a very cool tool. If you need help getting started with it, leave some more comments and I’d be happy to help.

  7. [...] Är du macanvändare och vill ha mer information på ditt skrivbord så är geektool najs. Detta är ett program som gör att du kan lägga in information som prestanda, loggar, datum, väder i din stad osv på skrivbordet så du kan hela tiden ha koll på vad som händer. Jag själv har bara lagt in datum och dag och månad på skrivbordet (se Bild) När jag kola på geektools för några månader sen googla jag alot på forum och sajter och skulle tycka att detta inlägg var rätt så bra som en start då. så därför rekomenderar jag det Getting Started with GeekTool [...]

  8. All excited about trying this out this week end – my old Mac Book could do with a face lift. Only one question – on the example how to screenshots with the cabin – where can I get the gorgeous notebook with rubber band icon?

  9. Just in case there are any other comments – forgot to click the ‘Notify me’ thingy.

    1. @skellyrocker – the iconfactory has made 4 sets of Indiana Jones icons available for free. They’re all fantastic. check all 4 sets out here – http://iconfactory.com/indianajones/
      Sorry, I don’t recall which set contains the notebook you asked about.

  10. Great article. The new RC3 of GeekTool wouldn’t work for me, so I had to drop back and install version 2. But it is fantastic. Again, thanks for the info.

  11. Just to mention an alternative app for Geektool -> there is Nerdtool too ;)

  12. [...] du kommer igång läser du här: Getting Started with GeekTool Relaterade inlägg:Tips: Viewfinder, Flickr på din MacFlickr har massor av bilder men kanske [...]

  13. Found a cool Geektool setup, thought I would share it: http://www.therealmacgenius.com/2010/03/geeking-out-with-geektool/


Comments have been disabled for this post