Create a Win7 Gadget

Published on
143,975 Points
26 Endorsements
Last Modified:
Editor's Choice
Community Pick
This article shows you how to create a simple "Gadget" -- a sort of mini-application supported by Windows 7 and Vista.  Gadgets can be dropped anywhere on the desktop to provide instant information, or to act as a gateway to a website or a larger program.  

What I like about gadgets is that they are really just small HTML pages.  That means:  No big-project development overhead.  If you have Notepad.exe and some knowledge about HTML, then you can write your own gadget.  Like HTAs, they run with with full local-program privileges, and can use ActiveX objects.  There is no limit to the creative things you can do with gadgets.Fig. 1-1:  Win7 gadgets!
How to Create a Gadget (the short version):
Here's all you need to do to create your own gadget:

1) Write an HTML page, say gadgetName.html

2) Write a short XML file, named (exactly) gadget.xml

3) Copy these two files into a particular directory:
   userDir \ AppData\Local\Microsoft\Windows Sidebar\Gadgets\ gadgetName.gadget

The Details:
Follow these steps and you'll have a new gadget in a few minutes:


Create a new folder on your desktop and name it


Open that folder and create two files in that folder.  Here's the XML file (called a manifest):

<?xml version="1.0" encoding="utf-8" ?>
  <description>Hello World Gadget.</description>
    <host name="sidebar">
      <base type="HTML" apiVersion="1.0.0" src="HelloGadget.html" />
      <platform minPlatformVersion="1.0" />

Open in new window

About the only place you might go wrong is misspelling the name of the HTML file in the
    <base type="HTML" apiVersion="1.0.0" src="HelloGadget.html" />
line.  Here's that HTML file:

//----------------- resizes the gadget display surface
function DoInit() {
    document.body.style.width = 90;
    document.body.style.height= 55;
<body onload="DoInit();">
<table border="5"><tr><td><center><i>Hello World!</i></center></td></tr></table>

Open in new window


Open a Windows Explorer and drill-down to locate the
following folder:

   userDir \ AppData\Local\Microsoft\Windows Sidebar\Gadgets\

...where userDir is your Windows User Name (the folder is in the "Desktop" virtual folder, just above "Computer" ) If you want, you can copy the following text and paste it into the address bar in any Explorer window (or in the Start/Search or Start/Run input boxes):
%localappdata%\Microsoft\Windows Sidebar\Gadgets

Open in new window

Looking in that folder, you will see the other gadgets that are already installed.  Each is in a folder that has a file extension of .gadget  A good way to learn about gadget programming is to examine the source files of the gadgets you can download from the Microsoft site.


Drag the HelloGadget.gadget folder from the desktop
and drop it into that Gadgets directory.
Fig. 1-2: Gadgets Folder


Right-click the desktop and select Gadgets.  
Your gadget is now visible in the gallery.  
Fig. 1-3:  Your gadget in the GalleryIt has the default icon, but the name is as was set in the XML file.  Drag it and drop it onto your desktop.

There you have it:  Your first gadget.  About all you can do with it is drag it around and close it.  But that's a start.  You can open the HTML file with your favorite text editor, make changes, and then drag it from the gallery to the desktop to see the effects of your changes.

Alas, the usually-dependable all-purpose JavaScript debugging tool --  the alert() function -- is not available when running as a gadget.  One option is to drop the HTML file onto a browser and run it there -- where alert() will work.  

With Windows 7, there is a new registry key that affects debugging.  Setting...


...will enable the display of script errors.  It's better than sitting there looking at the screen blankly and wondering why nothing is happening.

If you have Visual Studio, you can use its Just-In-Time debugging.  Just insert:

Open in new window

...at a good starting point in the <script> block.  The VS script debugger will come up and let you single-step, check variables, and so forth.  I've found this technique works best if you break your JScript out into a separate file (as opposed to putting it all in the HTML file).  See Debugging JScript Programs with Visual Studio 2008 for related info.

Packaging and Deployment
Microsoft made this very easy.  All you need to do is create a ZIP file that contains your two files.  Rename the ZIP file to give it an extension of .gadget and you are done.  When you right-click a file that has the .gadget extension, Windows asks if you want to install the gadget, and then it creates the AppData directory and unpacks the files into it.  The gadget  immediately becomes available in your gallery.

But, as we've seen, you don't need to create a deployment package:  While developing, you can create the folder manually and work directly with the source code.
Caution:  If you work this way (directly in the AppData folder), then be aware that if you choose to Uninstall in the Gadget Gallery, it will delete your files!   Keep a copy of the files handy in a different place.
Rather than a renamed ZIP file, you can instead create a renamed CAB file for deployment.  CAB files can be signed, so your users might avoid a scary "Unknown Publisher" notice when installing.

Up Next:
In the next installment, we'll create a more complex gadget that illustrates how to add a non-default icon, how to populate the "details" area of the gadget gallery, and most importantly, how to display a Settings dialog and save the settings so they'll be in effect each time your gadget starts.

See: Create a Win7 Maze! Gadget
And: Create a Win7 Drop Target Gadget
And: Create a Win7 Gadget with a Flyout Panel



Developing a Gadget for Windows Sidebar  (Written for Vista, but it mostly applies)

Gadgets for Windows Sidebar Debugging

If you liked this article and want to see more from this author,  please click the Yes button near the:
      Was this article helpful?
label that is just below and to the right of this text.   Thanks!
  • 4
  • 2
  • 2
  • +5
LVL 31

Expert Comment

by:James Murrell

Wow great just created my 1st one :

It monitors to work web pages for up time....

couple of questions - i have a button which refresh's how would it be possible to have auto refresh (every two/ five minutes)

Already got ideas for more gadgets... great work

now reading others

LVL 50

Author Comment

I'm glad you liked it.  
Your gadget is written in JavaScript and it supports the window object.  Just create a timer.
-- Dan

Expert Comment


It's really cool one. It tempted me to create my first gadget :)

Become a CompTIA Certified Healthcare IT Tech

This course will help prep you to earn the CompTIA Healthcare IT Technician certification showing that you have the knowledge and skills needed to succeed in installing, managing, and troubleshooting IT systems in medical and clinical settings.

Expert Comment

Great tutorial, see a beginners demo for making a windows gadget .

Expert Comment

Hi there.

So i finally found a way to get a active desktop feature in windows 7...aside from the snippage app that i dont really care for.

Its a sidebar gadget called active desktop....go figure right,

The only thing that I want to add to it is the ability to have the gadget refresh the designated web page every so often....say every 10 min.  I dont want to change anything else.

I have very little experience with HTML and the like...but im sure this would be a easy edit for someone.

Or feel free to create a new gadget with the refresh option and post it in the sidebar gallery as im sure theres many people out there that would like this gadget / active desktop as well. :)   Just a thought.

Thanks for reading.
Any and all help is greatly appreciated

Expert Comment

FYI -- If you're in Windows 7 Ultimate 64-Bit (or at least this worked for me),

1) Place the gadgets in "C:\Program Files\Windows Sidebar\Gadgets".
2) Create a folder within your "HelloGadget.gadget" folder called "en-US"
3) Place your "gadget.XML" file in the newly created "en-US" folder.
4) Modify the "gadget.XML" file by adding "..\" in front of the link to the HTML file so it goes up one level to search in the correct location:

 <base src="..\HelloGadget.html" apiVersion="1.0.0" type="HTML"/>

My Question for Dan/All:

Based on my 64Bit Windows 7 - if I want to debug , where should I put the registry value? (and should I make it a 64Bit key (REG_QWORD) instead of a32Bit? I was thinking it should go here (am I close?!?):

LVL 50

Author Comment

I'm not so sure that any debugging-related registry entry is useful or needed.  In my later efforts, I simply added the debugger; line to my JavaScript code and let VisualStudio pop up its full-featured debugger.

Expert Comment

Thanks for the tip Dan.

Great article!!

Expert Comment

i am not getting HelloGadget on right click on the desktop. please help me out in this situation. i am using windows 7 ultimate (64 bits).
LVL 50

Author Comment

A right-click on the desktop should bring up a menu that includes the "Gadgets" option.  Click it, and HelloGadget as well as many others, should then appear in the Gadget Gallery.

Expert Comment

thnxx ..now it is appearing on my desktop.
but please tell me how to apply events on it so that the gadget can be useful too.
i am thinking to make a workable gadget as my B.tech final year project.
please give me some kind of hint in this direction.
thnx a lot..
LVL 50

Author Comment

Please refer to the three related articles listed above (under the heading "Up Next").  A gadget can respond to user-interface events such as keystrokes, clicks, item drops, and rollovers, and to timer events (basically anything that can be sensed in a web page), plus whatever functionality you can add by using activeX objects such as the FileSystemObject.

Expert Comment

@dansrollins thanks u made my day

Featured Post

Bootstrap 4: Exploring New Features

Learn how to use and navigate the new features included in Bootstrap 4, the most popular HTML, CSS, and JavaScript framework for developing responsive, mobile-first websites.

This is Part 3 in a 3-part series on Experts Exchange to discuss error handling in VBA code written for Excel. Part 1 of this series discussed basic error handling code using VBA. http://www.experts-exchange.com/videos/1478/Excel-Error-Handlin…
Please check the video also in regards to recovery of deleted emails from office 365 admin center and through the MFCMAPI tool. I have mentioned each and every step with the proper steps that need to be taken care of.

Keep in touch with Experts Exchange

Tech news and trends delivered to your inbox every month