Push background image to Cisco IP Phone

Use this application to push an image to either a single phone or to a subnet of phones. It’s a free app but as always donations of teacakes and/or Guinness are  welcome 🙂

Prerequisites to running the Application
O/S: Windows with port 80 free4
Java: Requires JRE 7 and above. You can check this by running “java -version” in a DOS prompt.
Tested on Windows 7 and Vista

Java version MS-DOS prompt

Java version MS-DOS prompt

Otherwise, follow this link  to Java Version, click on Verify Java version, allow the plug-in to run and in a few seconds you should see something like this:

Java JRE version Web Browser

Java JRE version Web Browser

If you dont have version 7+ of Java JRE you can download it from here Java JRE

Current version: NetPacket Push Img Phone

Ver:0_102 Date 13th of Jan 2015
Notes: Fix bug with space in filename

Ver:0_101 Date 10th of Oct 2014
Notes: Base build

Image Format
Image must be in .PNG format. This is the only format supported by all the IP Phones and this application.
Each phone model supports a specific set of dimensions [width x height x bits per pixel (bpp)]. Ref: Cisco IP Phone Images Format

How to use the Application
Before using the app, it’s worth pointing out its limitation. Pushing an image out to a subnet will do just that, it will try to push the image to all the IP Phones within the subnet regardless of the model of IP Phone. It’s importent to note (as mentioned above) that different IP Phones support different image dimensions. You can still push an unsupported image (in terms of dimensions) to a phone and most of the time it will work, but how the phone will render and display it is unpredictable.

1. Log into Cisco CUCM and create/find the User ID you will be using for this application “User Management > End User > Find or Add New
2. Under “Device Information” associate with the users all the phones you will push the background image to.

End User Phones

End user associated with Cisco IP Phones

3. Once the CUCM part of the setup is completed, start the application
PushImageStep1From the screenshot above:

  1. User ID that was associated with the phones on CUCM as part of step 1 and 2 above.
  2. Password for that is configured on CUCM for that User ID
  3. Select the Phone model. Note this allows the application to check the image format is correct for that phone.
    • This option does not select the type of phones this image will be used for.
    • If the Phone model is not listed select “Other”. You will then be asked what size of thumbnail (width and height) you’d like the application to generate and push to the Phone. The thumbnail is used to show the user a preview of the image before it is selected as the background image.
  4. Select the image you’d like to push to the Phone(s).  Only “.png” files and files that are in the same directory as the application can be used.
  5. This displays the IP address and hence the NIC card that will be used by this application. Port 80 will need to be free on this IP for the application to work
  6. When all of the above steps have been completed, move to the “Push to IP Address” tab
Push Image to IP Phone

Push Image to IP Phone using IP Address

The fields depicted in the screenshot above are self explanatory. The image is getting pushed to a single phone with IP address If you’re pushing the image to a subnet when the application completes the task, it will create a log file “Subnet.txt” in the directory it’s being run in, giving details of each IP Address it has tried to push the image to.

Future plans of this application could be to integrate it with CUCM so you can push the image to, for example, all 7945 phones in a specified Device Pool … but at the moment this does most of my daily tasks.

Tags: , ,

About Alexis Katsavras

Working as Freelance Cisco Unified Communications Consultant in the UK. www.NetPacket.co.uk