MMM-NRL

A MagicMirror² module that shows NRL match scores, upcoming fixtures, and results — built for footy fans who want it on their mirror without the fuss.

Supports NRL, NRLW, State of Origin, and Women's State of Origin. Built with NZ and Pacific audiences in mind.

• Shows the current round's matches — upcoming games, live scores, and recent results
• When a round finishes, it keeps showing the results until the next round's fixtures are available — so your mirror is never blank
• If you enable multiple competitions, each one gets its own section with a clear header so it stays easy to read on a small screen
• Live games get a faster refresh (every minute) and a blinking score so they stand out

Navigate to your MagicMirror modules folder and clone the repo:

cd ~/MagicMirror/modules
git clone https://github.com/EwwYumYuck/MMM-NRL
cd MMM-NRL
npm install

Add this to your config/config.js:

{
    module: "MMM-NRL",
    position: "top_right",
    config: {
        header: null    // null = auto ("NRL Matches", "State of Origin", etc.) or set a custom string
    }
}

That's it. By default it shows NRL Premiership fixtures for the current round, with logos, scores, venues, and team abbreviations all turned on.

Want NRLW and State of Origin on the same mirror? Just add them to the competitions array:

{
    module: "MMM-NRL",
    position: "middle_center",
    config: {
        header: "NRL / NRLW / Origin",
        competitions: ["nrl", "nrlw", "soo"],
        maximumEntries: 10
    }
}

Each competition shows as its own group with a header like NRL — Round 15 or SOO — Game 2. No extra config needed — it figures out the layout automatically.

Available competitions:

NRL — ROUND 15
[logo] SOU  12 - 8   BRI [logo]   ← result from last game
[logo] MEL  Wed 19:50  NQL [logo] ← coming up

NRLW — ROUND 1
[logo] BRI  20 - 14  DRG [logo]

SOO — GAME 2
[logo] NSW  Wed 20:00  QLD [logo]

Use maximumEntries to control how many matches show in total — handy if you have a small screen and multiple competitions enabled.

NRLW teams use the same names and codes as their NRL counterparts above.

Perth Bears and PNG Chiefs are already wired up — logos and abbreviations are ready to go and will appear automatically once the NRL API starts including them.

cd ~/MagicMirror/modules/MMM-NRL
git pull
pm2 restart MagicMirror

You only need to run npm install again if the changelog says new packages were added.

No breaking changes — existing configs work as-is.

• Alignment fix — all competitions (NRL, SOO, NRLW) now use equal fixed-width team columns so QLD/NSW display is consistent with MEL/BRI
• Fixed venue row HTML bug — venue row was incorrectly nested inside the match row; now properly rendered as a sibling <tr>
• DOM safety — replaced innerHTML with textContent/createElement throughout
• Extended SOO abbreviations — module now recognises "Queensland Maroons", "Queensland", "New South Wales Blues" etc. from the API

No breaking changes — existing configs work as-is.

• Compact grouped layout for multi-competition setups — each competition gets a section header (e.g. NRL — Round 15) instead of a venue row per match, which cuts vertical space roughly in half on small screens
• Current round only — the module now always shows the current round's fixtures; results stay visible after a round ends until the next round's games are published
• Compact date format — upcoming games in grouped mode show as Wed 19:50 rather than a two-line date and time
• showVenue now applies to single-competition mode only

No breaking changes.

• Multi-competition support — NRL, NRLW, State of Origin, Women's SoO all from one module
• Perth Bears and PNG Chiefs pre-wired for their 2027/2028 NRL entries
• Fixed a bug where the venue row was rendering incorrectly
• Fixed API errors showing silently instead of surfacing on the display
• Fixed Upcoming match state not being handled correctly
• Corrected Warriors abbreviation from NZL to WAR

• NRL Premiership fixtures, scores, and venues
• Team logos with colored and grayscale support
• Live match detection with faster refresh
• Configurable header, mode, team focus, and abbreviations

Issues and pull requests are welcome!

MIT