Skip to content
ChaseCarHG edited this page Mar 30, 2026 · 21 revisions

NightscoutTV for Roku

a client screensaver/app for Roku to display read-only information from a running Nightscout server

NightscoutTV for Github

DISCLAIMERS

NIGHTSCOUT #WeAreNotWaiting

(!) IMPORTANT - As with Nightscout, it is important to understand that this project:
• is an open-source, community-based project and is not supported by any company
• is not officially approved or regulated for diabetes therapy and/or treatment in any way
You must understand that you take full responsibility for building and running this DIY system and you agree to do so at your own risk.
(!) SAFETY • This project requires a working internet connection and availability of any third-party cloud services used
• Do not rely only on Nightscout as the only way you have of knowing your blood glucose values and trends
• Make sure you're ready to cope with an unexpected failure and always have alternative ways to check your blood glucose levels
The Roku platform is neither Safety-Grade nor Medical Grade. People change the channel. For a dedicated display, consider a SugarPixel.

Screenshots

Keep scrolling... there's more after these screenshots...

002
NightscoutTV-Demo-24hr

... or Ctrl+Click below to preview shorter timespans...

PREREQUISITES

  1. Fully-operational Nightscout Server setup, with:
    a. HTTPS:// access URL.
    b. Access token with "readable" permission.
    • To set up an access token, navigate to your Nightscout URL, authenticate, then top-right Hamburger Icon > Admin Tools > Subjects > Add New Subject > Name "roku", Roles "READABLE" > Click Save button.
    c. Uploader sending it at least Continuous Glucose Monitor Information (Recommended: Nighscout Foundation's XDrip+).
    d. (Optional) Other uploaders contributing information, e.g. jwoglom-tconnectsync

INSTALLATION

Select from either of the two methods below:

Sideloading (Manual Install)

  • See README.md for Sideloading Instructions & Roku Platform Limitations

Roku Store (Easy Install and still FREE!)

  • Coming soon! This link will work upon arrival.
  • Status: Currently appealing to Roku to allow interactivity (timespan changes & manual refresh) only when manually launched in App Mode.
  • Note the Roku Store prohibits interactivity when in Screensaver Mode. The latest releases fully comply with (and embrase) this requirement.

USAGE

  1. To ensure it's now your Default Screensaver:
    a. Go to Roku Home > Settings > Theme > Screensavers > NightscoutTV for Roku (dev) > Set as screensaver.
    (If the option doesn't exist, then it's already set as the screensaver.)
  2. To adjust the Screensaver Start Time:
    a. Go to Roku Home > Settings > Theme > (scroll down to "Additional settings") > Screensaver Start Time.
  3. To manually launch NightscoutTV as an app:
    a. Go to Roku Home > (find the Black "Nightscout Owl" on a Green-Rectangle background -- sideloaded apps tend to go to bottom of the list) > Open it!

TESTING THUS FAR

• Platform: 4800X Roku Ultra boxes running Software Version 15.1, with Display Resolutions of 720p and 1080p.
• Features: CGM, Bolus/Treatment, Temp-Basil (e.g. from Tandem tslim X2) and Profile-Basil (each displayed in a unique shade of blue), CAGE, and SAGE.

HOW YOU CAN HELP

• Check out the Nightscout Project and the Nightscout Foundation. Without their work, this project wouldn't be here.
• Check out the NightscoutTV Issues list.

  • Some items just need testing, and maybe your Nightscout server has what I don't have.
  • Some items need localization. If you're interested in NightscoutTV support in YOUR language -- let me know in the issue for it!
  • Some items warrant a developer who can handle Roku's Brightscript. There's enough already built out to learn from and scale to add those new features.
  • Unfortunately, there's no Webkit or similar on Roku, so it all has to be made using Roku's available programming.

AGAIN -- VALIDATE DATA RELIABILITY BEFORE MAKING DECISIONS ON IT.