Daily Sports Schedules & Standings Emails

I am the type of person that needs information put right in front of me if I want to guarantee that I'll see it. This project was made to send myself emails every morning, containing that day's schedule & the current standings for MLB, NBA, and NFL games & teams.

Features

• Show the schedule for MLB, NBA, and NFL games happening that day
• Show the current standings for the leagues
• Highlight your favorite teams, so you can immediately find them on the schedule & standings

To Use

• Fork this repo.
• [LOCALLY ONLY] If you'd like to test locally, pull down and run yarn install.
• Update src/config.js with your appropriate settings.
  • config.send_email.*: the various league emails
  • config.email_client.*: SMTP settings for your email client (Gmail is already set)
  • config.user.*: Localized game start times + 12/24hr display
  • config.${league}.*: Choose your favorite teams to highlight them in the email

Note

These can be updated at any point to customize the email to your liking. Feel free to come back to the config.user.* and config.${league}.* parts after everything works.

• If your email provider offers it, generate an app specific password for your account
  • For Gmail, you can do that here
• [LOCALLY ONLY] Create a .env file at the project root.
  • The file contents should look as follows:

MAIL_FROM="Daily Sports Email <yourEmail@here>"
MAIL_TO="yourEmail@here"
MAIL_USER_EMAIL="yourEmail@here"
MAIL_USER_PASSWORD="yourAppSpecificPasswordHere"

• [LOCALLY ONLY] Update your .env file with the appropriate values.
  • For the MAIL_USER_PASSWORD, use your app-specific password here.
  • For Gmail's app-specific passwords, they will look like this that more less; remove the spaces so it's thisthatmoreless.
• Update your .github/workflows/daily_sports_schedules_and_standings.yml schedule cron to the correct time.
  • The default, cron: "0 12 * * *", executes at 8am Eastern / 5am Pacific.
  • Learn more at https://crontab.guru.
• [LOCALLY ONLY] Run node src/main.js. You should see a few console logs, and you should receive an email.
• [LOCALLY ONLY] If If everything works right, commit & push to your repo.

Caution

Do NOT upload your local .env file to your GitHub. .gitignore should prevent this.

• In your repo, go to Settings > Secrets and variables > Actions. Add the secrets from the .env file here, and set the values appropriately.
  • If you did not test locally, reference the "Create a .env file" and "Update your .env file" steps above.
• In your repo, go to Actions, and find the workflow. Run it via the dropdown. You should receive an email. Hooray!
• Wait until your schedule cron time. You should receive an email. Double hooray!

For MLB

You do not need any additional information.

For NBA

You will need a SportsData.IO account, and an NBA API Free Trial. Add a SPORTS_DATA_KEY_NBA value to your .env file for local testing, and/or to your Github Secrets for running the automation.

For NFL

You will need a SportsData.IO account, and an NFL API Free Trial. Add a SPORTS_DATA_KEY_NFL value to your .env file for local testing, and/or to your Github Secrets for running the automation.

To Do

• README
• MLB Schedule API & format
• MLB Standings API & format
• MLB Email
• Highlight MLB teams if they're a favorite
• NFL Schedule API & format
• NFL Standings API & format
• NFL Email
  • Send one on Tues/Weds for the upcoming week
  • Send one each day for games that day
• Highlight NFL teams if they're a favorite
• NBA schedule API & format
• NBA standings API & format
• NBA Email
• Highlight NBA teams if they're a favorite
• Command to generate .env and src/config.js files locally
• Favorite team email(s) each Monday?
• Option to only show favorite teams
• Options to show schedule, standings, or both