MMM-MyStandings

A MagicMirror² module to display standings and rankings for your favorite leagues and divisions from many major sports, including Olympics.

The module will rotate through different sports. If you only want to show one sport or one division, the module will just display one without rotating.

This is a fork of the original MMM-MyStandings from user vincep5. It has been updated with bug fixes, security patches, and many feature additions.

Intended to match the design aesthetic of, and pair nicely with, MMM-MyScoreboard.

Preview

Installing the Module

cd ~/MagicMirror/modules
git clone https://github.com/dathbe/MMM-MyStandings

Dependencies:

• None!

Updating the Module

cd ~/MagicMirror/modules/MMM-MyStandings
git pull

Configuration

Add MMM-MyStandings module to the modules array in the config/config.js file. The following example config shows a minimal configuration option. More options are described below.

{
  module: "MMM-MyStandings",
  position: "top_right",
  config: {
    rotateInterval: 2 * 60 * 1000, // every 2 minutes
    sports: [
      // See below in the README for different league and group options 
      { league: "WNBA", groups: ["Women's National Basketball Assoc."] },
      { league: "MLB", groups: ["NL Wild Card"] },
      { league: "NCAAF", groups: ["Big Ten Conference", "Conference USA"] },
      { league: "NCAAF Rankings", groups: ["AFCA Coaches Poll"] },
      { league: "English Premier League" },
      { league: "FIFA World Cup", groups: ["Group C", "Group E"] }
    ]
  }
},

Option	Description
sports	The leagues and groups (i.e., divisions, conferences, or other combinations) you would like to display. See below for the various options. Type: array of dicts Default value: A random combination that gives a flavor of what the module can do.
updateInterval	Time in milliseconds to update data from ESPN Type: int Default value: 2 * 60 * 60 * 1000 (every 2 hours)
rotateInterval	Time in milliseconds to rotate through the leagues or divisions Type: int Default value: 1 * 60 * 1000 (every 1 minute)
nameStyle	Display abbreviation (e.g., "TOR"), full name (e.g., "Toronto Blue Jays"), or short name (e.g., "Blue Jays") for the team Type: string Options: abbreviation, full, or short Default value: short
showLogos	Display logos (true) or not (false) Type: boolean Default value: true
useLocalLogos	Display logos from folder if they are available (true) or displays all logos from the ESPN url (false) Type: boolean Default value: true
colored	Chooses whether to display the module in full color (true) or grayscale (false) Type: boolean Default value: true
coloredLogo	Chooses whether to display logos in full color (true) or grayscale (false). If colored property is true, this has no effect Type: boolean Default value: true
coloredHeader	Chooses whether to display headers in full color (true) or grayscale (false). If colored property is true, this has no effect Type: boolean Default value: true
coloredRank	Chooses whether to display the ranks in full color (true) or grayscale (false). If colored property is true, this has no effect Type: boolean Default value: true
showByDivision	Rotate through each division/group separately (true) or show all divisions/groups at once stacked on top of one another (false). Note that false only combines divisions of the same type. For example, in MLB, divisions will be grouped together, NL/AL leagues will be grouped together, playoffs will be grouped together, and wild cards will be grouped together. Type: boolean Default value: true
fadeSpeed	Time in milliseconds to fade in the module Type: int Default value: 2000 (2 seconds)
rankingLength	The number of teams to display when using NCAAF Rankings, NCAAM Rankings, NCAAW Rankings, or Olympics Type: int Default value: 25
addLeagueToTitle	Adds the league name to the displayed table title Type: boolean Default value: true
highlightTeams	Allows table rows for specific teams to be highlighted. See below for options and formatting Type: array of dicts Default value: None

Available Leagues and Groups

For any league, select the groups you want to rotate through or no groups to rotate through all divisions (smallest level groups) in the league:

• { league: "MLB" } will rotate through all MLB divisions
• { league: "English Premier League" } will display English Premier League overall standings (because there are no divisions/groups)
• { league: "NFL", groups: ["AFC East", "AFC North"] } will rotate between AFC East and AFC North
• { league: "NBA", groups: ["Atlantic"] } will display only the Atlantic Division

Available NBA Groups (click to expand)

Divisions

• Atlantic
• Central
• Southeast
• Northwest
• Pacific
• Southwest

Conferences

• Western Conference
• Eastern Conference

Overall

• National Basketball Association

Available WNBA Groups (click to expand)

Conferences

• Eastern Conference
• Western Conference

Overall

• Women's National Basketball Assoc.

Available NBA G League ("NBAG") Groups (click to expand)

Conferences

• Eastern Conference
• Western Conference

Overall

• NBA Development League

Available MLB Groups (click to expand)

Divisions

• American League East
• American League Central
• American League West
• National League East
• National League Central
• National League West

Leagues

• American League
• National League

Overall

• Major League Baseball

Playoffs

• AL Playoffs - will remove teams from standings when eliminated from the regular season playoff race
• NL Playoffs - will remove teams from standings when eliminated from the regular season playoff race
• AL Wild Card - will remove teams from standings when eliminated from the regular season wild card race
• NL Wild Card - will remove teams from standings when eliminated from the regular season wild card race

Available NFL Groups (click to expand)

Divisions

• AFC East
• AFC North
• AFC South
• AFC West
• NFC East
• NFC North
• NFC South
• NFC West

Conferences

• American Football Conference
• National Football Conference

Overall

• National Football League

Playoffs

• AFC Playoffs - will remove teams from standings when eliminated from the regular season playoff race
• NFC Playoffs - will remove teams from standings when eliminated from the regular season playoff race

Available CFL (Canadian Football League) Groups (click to expand)

Divisions

• West Division
• East Division

Available NHL Groups (click to expand)

Divisions

• Atlantic Division
• Metropolitan Division
• Central Division
• Pacific Division

Conferences

• Western Conference
• Eastern Conference

Overall

• National Hockey League

Playoffs

• West Playoffs - will remove teams from standings when eliminated from the regular season playoff race
• East Playoffs - will remove teams from standings when eliminated from the regular season playoff race
• West Wild Card - will remove teams from standings when eliminated from the regular season wild card race
• East Wild Card - will remove teams from standings when eliminated from the regular season wild card race

Available MLS Groups (click to expand)

Conferences

• Eastern Conference
• Western Conference

Available NCAA Football ("NCAAF" or "NCAAF Rankings") Groups (click to expand)

Conferences

Use the league NCAAF

• American Athletic Conference
• Atlantic Coast Conference
• Big 12 Conference
• Big Ten Conference
• Conference USA
• FBS Independents
• Mid-American Conference
• Mountain West Conference
• Pac-12 Conference
• Southeastern Conference
• Sun Belt - East
• Sun Belt - West

Rankings

Use the league NCAAF Rankings

• AP Top 25
• AFCA Coaches Poll
• FCS Coaches Poll
• AFCA Division II Coaches Poll
• AFCA Division III Coaches Poll

Available NCAA Men's Basketball ("NCAAM" or "NCAAM Rankings") Groups (click to expand)

Conferences

Use the league NCAAM

• America East Conference
• American Athletic Conference
• Atlantic 10 Conference
• Atlantic Coast Conference
• ASUN Conference
• Big 12 Conference
• Big East Conference
• Big Sky Conference
• Big South Conference
• Big Ten Conference
• Big West Conference
• Colonial Athletic Association
• Conference USA
• Horizon League
• Ivy League
• Metro Atlantic Athletic Conference
• Mid-American Conference
• Mid-Eastern Athletic Conference
• Missouri Valley Conference
• Mountain West Conference
• Northeast Conference
• Ohio Valley Conference
• Patriot League
• Southeastern Conference
• Southern Conference
• Southland Conference
• Southwestern Athletic Conference
• Summit League
• Sun Belt Conference
• West Coast Conference
• Western Athletic Conference

Rankings

Use the league NCAAM Rankings

• AP Top 25
• Coaches Poll

Available NCAA Women's Basketball ("NCAAW" or "NCAAW Rankings") Groups (click to expand)

Conferences

Use the league NCAAW

• ASUN Conference
• America East Conference
• American Athletic Conference
• Atlantic 10 Conference
• Atlantic Coast Conference
• Big 12 Conference
• Big East Conference
• Big Sky Conference
• Big South Conference
• Big Ten Conference
• Big West Conference
• Colonial Athletic Association
• Conference USA
• Horizon League
• Ivy League
• Metro Atlantic Athletic Conference
• Mid-American Conference
• Mid-Eastern Athletic Conference
• Missouri Valley Conference
• Mountain West Conference
• Northeast Conference
• Ohio Valley Conference
• Patriot League
• Southeastern Conference
• Southern Conference
• Southland Conference
• Southwestern Athletic Conference
• Summit League
• Sun Belt Conference
• West Coast Conference
• Western Athletic Conference

Rankings

Use the league NCAAW Rankings

• AP Top 25
• Coaches Poll

Available Olympics groups (click to expand)

Sort Order

• Total - overall medal count
• Gold
• Silver
• Bronze

Available Soccer Leagues (click to expand)

These are LEAGUES, not GROUPS

For any soccer league that does not have any groups, you should list only the league (e.g., { league: "English Premier League" }). If the soccer league does have groups, listing just the league will rotate through all groups (e.g., { league: "FIFA World Cup" }). Or you can list the groups you would like to display.

International Soccer

• AFC Champions League Two
• AFC Asian Cup Qualifiers
• ASEAN Championship
• Africa Cup of Nations
• Africa Cup of Nations Qualifying
• African Nations Championship
• Copa América
• FIFA Club World Cup
• FIFA Confederations Cup
• Men's Olympic Soccer Tournament
• Women's Olympic Soccer Tournament
• FIFA Women's World Cup
• FIFA World Cup
• FIFA World Cup Qualifying - AFC
• FIFA World Cup Qualifying - CAF
• FIFA World Cup Qualifying - Concacaf
• FIFA World Cup Qualifying - CONMEBOL
• FIFA World Cup Qualifying - OFC
• FIFA World Cup Qualifying - UEFA
• FIFA Under-17 World Cup
• FIFA Under-20 World Cup
• UEFA Champions League
• UEFA Conference League
• UEFA Europa League
• UEFA European Championship
• UEFA European Championship Qualifying
• UEFA European Under-19 Championship
• UEFA European Under-21 Championship
• UEFA Nations League
• SAFF Championship
• UEFA Women's European Championship

UK/Ireland Soccer

• English League Championship
• English EFL Trophy
• English League One
• English League Two
• English National League
• English Premier League
• Irish Premier Division
• Northern Irish Premiership
• Scottish League Cup
• Scottish Championship
• Scottish League One
• Scottish League Two
• Scottish Premiership
• Welsh Premier League
• English Women's Super League

European Soccer

• Austrian Bundesliga
• Belgian Pro League
• Danish Superliga
• Spanish LALIGA
• Spanish LALIGA 2
• French Ligue 1
• French Ligue 2
• German 2. Bundesliga
• German Bundesliga
• Greek Super League
• Israeli Premier League
• Italian Serie A
• Italian Serie B
• Maltese Premier League
• Dutch Keuken Kampioen Divisie
• Dutch Eredivisie
• Norwegian Eliteserien
• Portuguese Primeira Liga
• Romanian Liga 1
• Russian Premier League
• Swiss Super League
• Swedish Allsvenskan
• Turkish Super Lig

South American Soccer

• Copa Argentina
• Argentine Nacional B
• Argentine Primera B
• Argentine Primera C
• Argentine Primera D
• Argentine Liga Profesional de Fútbol
• Bolivian Liga Profesional
• Brazilian Campeonato Carioca
• Brazilian Campeonato Gaucho
• Brazilian Campeonato Mineiro
• Brazilian Campeonato Paulista
• Brazilian Serie A
• Brazilian Serie B
• Brazilian Serie C
• Chilean Primera División
• Colombian Primera A
• Colombian Primera B
• CONMEBOL Libertadores
• CONMEBOL Sudamericana
• LigaPro Ecuador
• Paraguayan Primera División
• Peruvian Liga 1
• Liga UAF Uruguaya
• Venezuelan Primera División

North American Soccer

• Concacaf Gold Cup
• Concacaf Nations League
• Concacaf Nations League Qualifying
• Concacaf W Championship
• Costa Rican Primera Division
• Guatemalan Liga Nacional
• Honduran Liga Nacional
• Jamaican Premier League
• Mexican Liga de Expansión MX
• Mexican Copa MX
• Mexican Liga BBVA MX
• Salvadoran Primera Division
• NCAA Men's Soccer
• NCAA Women's Soccer
• MLS
• North American Soccer League
• NWSL
• U.S. Open Cup
• USL Championship

Asian Soccer

• AFC Champions League Elite
• Australian A-League Men
• Australian A-League Women
• Chinese Super League
• Indonesian Liga 1
• Indian I-League
• Indian Super League
• Japanese J.League
• Malaysian Super League
• Singaporean Premier League
• Thai League 1

African Soccer

• CAF Champions League
• CAF Confederation Cup
• Ghanaian Premier League
• Kenyan Premier League
• Nigerian Professional League
• South African First Division
• South African Premier Division
• Ugandan Premier League
• Zambian Super League
• Zimbabwean Premier Soccer League

Available Aussie Football, Lacrosse, & Rugby Leagues (click to expand)

These are LEAGUES, not GROUPS

Australian Rules Football

• AFL - Australian Football League

Lacrosse

• PLL - Premier Lacrosse League
• NLL - National Lacrosse League

Rugby

• Premiership Rugby
• Rugby World Cup
• Six Nations Rugby
• The Rugby Championship
• European Rugby Champions Cup
• United Rugby Championship
• Super Rugby Pacific
• Olympic Men's 7s Rugby
• Olympic Women's Rugby Sevens
• International Test Match Rugby
• URBA Top 12 Rugby
• Mitre 10 Cup Rugby

Logos

You can add your own custom personal logos into the logos_custom folder, and they will not be disturbed when you update the module. Specific guidance can be found here. (But if you have a logo that you think should be added for all users, please share it by opening an issue.)

Team Highlighting

The highlightTeams property allows you to highlight specific team/league combinations.

highlightTeams is a list of dicts. The required keys are as follows:

• league: The league of the team you want to highlight. Matches the league value from the sports property.
• teamAbbreviation: The team that you want to highlight. Matches the abbreviation value for the team.

The row for each specified team will have a new class applied in the format highlight-league-teamAbbreviation (example: highlight-nhl-nyi for NHL's New York Islanders)

In order to apply highlighting, you can add an entry to custom.css for the class. Alternatively, you can specify the background and foreground (font) colors using additional dict keys:

• bgColor: The color to use for highlighting the row. Use hex codes (#000000)
• fgColor: The color to use for the text in the row. Use hex codes (#FFFFFF)

Example:

config: {
  highlightTeams: [
    { league: "NHL", teamAbbreviation: "PIT", bgColor: "#FCB514",  fgColor: "#000000" }, //apply the bg and fg color directly
    { league: "NFL", teamAbbreviation: "NYG"}, //must include an entry in custom.css for the class highlight-nfl-nyg
  ]
}

Displaying Different Standings in Different Seasons

There are several ways to display standings for a given league only at certain times of year (e.g., hiding it when the league is not in season). You could use a separate module such as MMM-ModuleScheduler, which can display or hide an entire module instance based on your schedule.

Another way to do it is to dynamically create a module with the desired leagues based on the date by adding some javascript to your config.js file, as offered by user mikeyounge in this discussion thread.

Contributing

If you find any problems, bugs or have questions, please open a GitHub issue in this repository.

Pull requests are of course also very welcome 🙂

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Developer commands

You will need to first install the dev dependencies:

cd ~/MagicMirror/modules/MMM-MyStandings
git switch development
npm install

Please create all PRs against the development branch for testing and eventual merging into master.

• node --run lint - Run linting checks.
• node --run lint:fix - Fix automatically fixable linting errors.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Thank You

Special thank you to vincep5, who created the original version of this module and did most of the work.