skip to navigation
August 9th, 2010 08:35 AM

Testing your Widget on a TV

This tutorial covers how to test your TV Widget on a TV.  In order to get your widget software on a TV, you must first submit your widget to the Widget Gallery Service. The final QA and approval process does not start until you send the Acceptance Criteria form to tvwidgets@yahoo-inc.com. Prior to submitting the Acceptance Criteria form, you can upload your widget as many times as you need for testing purposes. Once uploaded, you can then download your widget to specific Connected TV devices for specific test-users.


You must test the following on a TV (and not the Widget Development Simulator):

  • Performance
  • Memory Management
  • Color Quality on Television Monitors
  • Sound Quality
  • Media Playback

Before starting this process, make sure your widget runs in the Widget Development Simulator.

Get your Developer Code

1. Launch the the Widget Gallery widget by navigating to and selecting the Widget Gallery snippet.

2. Press the GREEN key on the remote control while you are in the Widget Gallery sidebar to launch the Settings view. The GREEN key on the remote control corresponds to the color-coded keys at the bottom of the sidebar, as seen below:

3. Select the Developer Settings button.

4. Toggle the Show My Test Widgets button to On, as seen below:

5. Sign-in with your Yahoo! ID.

6. A unique Developer Code for your TV is displayed. This four-digit code is bound to a tester’s Yahoo! ID and a device code. Note this code for future reference.

Upload your Widget to the Gallery

7. Make sure the .widget directory is zipped as follows:

  • Use the naming convention: widgetID-versionNumber.widget
  • For example: com.mycompany.mywidget-1.0.12.widget
  • Make sure you zip your widget from the .widget directory (and not from the Contents directory).
  • Rename the .zip extension to .widget.
  • The widget must be zipped without extra files, for example there should be no invisible files (starting with . or ._ ) nor any Thumbs.db files on Windows nor any .DS_Store files and __MACOSX folders on Mac.
  • You can use the following zip command:
    zip -x "*/.git/*" -x "*/.svn/*" -x "*/.DS_Store" -x "*/*~" -x "*/*.bck" -r <WIDGETFILE> <WIDGETPATH>

8. Go to the Widget Upload Tool: http://gallery.tv.widgets.yahoo.com/publisher/

9. Make sure you are signed in to the Widget Upload Tool with the Yahoo! ID that you use to manage all of your widget submissions. This Yahoo! ID may be the same Yahoo! ID that is associated with your Developer Code, however it is not required to be the same Yahoo! ID.

10. Make sure you fill out all mandatory fields identified with asterisks in the Widget Upload Tool form.

11. Make sure the widget ID in the widget.xml file is lower case.

12. Make sure there are no spaces in the parent widget file name.

13. You can associate more than one Developer Code with a specific Yahoo! ID by separating them with commas. For example: HFV5,XM89,R54H.

14. The icon and gallery images are the images that get displayed in the Widget Gallery. If you do not upload these images, defaults will be used.

15. Once you submit the form, select the My Widgets tab to see that your widget has been uploaded. Please note that there is no confirmation screen when the widget has finished uploading. If the widget shows up in the My Widgets tab, it has successfully uploaded and will be available in the Test Widgets category in the Widget Gallery on your TV.

16. If the widget does not show up in the My Widgets tab, it is usually caused by widget ID and widget file errors. Using upper case characters in the widget ID or using spaces in the widget file name are not permitted.

17. Using the right-mouse-button, click on the widget in the My Widgets tab to add and remove testers, to remove a widget, and to view the information related to your widget.

18. You can upload and test several versions of your widget prior to requesting approval.

View your Widget on a TV

19. Make sure you are signed in on the TV with you Yahoo! ID.

20. Open the Widget Gallery widget on the TV.

21. Select Categories and navigate to the last page.

22. Select the Test Widgets category

23. Select your widget and add it to your profile.  The widget will now be in your widget dock and ready to test.

Submit your Widget for Approval

24. When you are ready to submit your widget for approval, please send an email to tvwidgets@yahoo-inc.com containing the following information:

2 Responses to “Testing your Widget on a TV”

  1. [...] This post was mentioned on Twitter by Debra Young, ConnectedTV. ConnectedTV said: Developers: How to test a Widget on a TV: http://bit.ly/bsy4Jz #yctv #socialtv #connectedtv #iptv [...]

  2. whoah this weblog is magnificent i really like reading your posts. Keep up the good paintings! You know, a lot of people are searching round for this information, you can aid them greatly.

Leave a Reply