MMM-StreamerStatus

[brandao.rafael]

[Module] MMM-StreamerStatus — See who’s live on Twitch, Kick & YouTube

Hey everyone! I’d like to share a new module I built: MMM-StreamerStatus.

It monitors a list of streamers across Twitch, Kick, and YouTube and shows you who’s currently live — with their game/category and
viewer count — right on your mirror.

---

Features

• Supports Twitch, Kick, and YouTube
• Two display styles: compact list or card grid (your choice)
• Shows platform icon, live indicator, current game/category, and viewer count
• Offline streamers can be shown dimmed or hidden entirely
• Smart polling: Twitch + Kick every 2 min, YouTube on a separate interval to stay within the free API quota
• OAuth token caching with automatic refresh for all platforms

---

Screenshot

---

Installation

cd ~/MagicMirror/modules
git clone https://github.com/brandaorafael/MMM-StreamerStatus

No npm install needed.

---

Configuration

{
module: “MMM-StreamerStatus”,
position: “top_right”,
header: “Live Now”,
config: {
twitchClientId: “your_client_id”,
twitchClientSecret: “your_client_secret”,
kickClientId: “your_client_id”,
kickClientSecret: “your_client_secret”,
youtubeApiKey: “your_api_key”,
displayStyle: “list”, // or “card”
showOffline: false,
streamers: [
{ name: “your_streamer”, platform: “twitch” },
{ name: “your_streamer”, platform: “kick” },
{ name: “Channel Name”, platform: “youtube”, channelId: “UCxxxxxxx” },
],
},
},

Full setup guide (including how to get API credentials for each platform) is in the README:
https://github.com/brandaorafael/MMM-StreamerStatus

Feedback and contributions welcome!

[brandao.rafael]

Formated configuration:

  {
    module: "MMM-StreamerStatus",
    position: "top_right",
    header: "Live Now",
    config: {
      twitchClientId: "your_client_id",
      twitchClientSecret: "your_client_secret",
      kickClientId: "your_client_id",
      kickClientSecret: "your_client_secret",
      youtubeApiKey: "your_api_key",
      displayStyle: "list",  // or "card"
      showOffline: false,
      streamers: [
        { name: "your_streamer", platform: "twitch" },
        { name: "your_streamer", platform: "kick" },
        { name: "Channel Name",  platform: "youtube", channelId: "UCxxxxxxx" },
      ],
    },
  },