3.1.2 • Published 1 month ago

playball v3.1.2

Weekly downloads
5
License
MIT
Repository
github
Last release
1 month ago

Playball!

Watch MLB games from the comfort of your own terminal

screenshot

Why?

MLB Gameday and MLB.tv are great, but sometimes you want to keep an eye on a game a bit more discreetly. playball puts the game in a terminal window.

Quick Start

Just want to try it out?

$ npx playball

Install

Ready for the big leagues? Install the package globally

$ npm install -g playball

Then run it

$ playball

Keys

Global

keyaction
qquit
cgo to schedule view
sgo to standings view

Schedule View

keyaction
/j, /k, /h, /lchange highlighted game
enterview highlighted game
pshow previous day's schedule/results
nshow next day's schedule
treturn to today's schedule

Game View

keyaction
/j, /kscroll list of all plays

Configuration

Playball can be configured using the config subcommand. To list the current configuration values run the subcommand with no additional arguments:

playball config

You should see output similar to:

color.ball = green
color.favorite-star = yellow
color.in-play-no-out = blue
color.in-play-out = white
color.in-play-runs-bg = white
color.in-play-runs-fg = black
color.on-base = yellow
color.other-event = white
color.out = red
color.strike = red
color.strike-out = red
color.walk = green
favorites = 

To get the value of a single setting pass the key as an additional argument:

playball config color.strike

To change a setting pass the key and value as arguments:

playball config color.strike blue

To revert a setting to its default value provide the key and the --unset flag:

playball config color.strike --unset

This table summarizes the available settings:

keydescriptiondefaultallowed values
color.ballColor of dots representing balls in top row of game viewgreenOne of the following: black, red, green, yellow, blue, magenta, cyan, white, grey. Any of those colors may be prefixed by bright- or light- (for example bright-green). The exact color used will depend on your terminal settings. The value default may be used to specify the default text color for your terminal. Finally hex colors (e.g #FFA500) can be specified. If your terminal does not support true color, the closest supported color may be used.
color.favorite-starColor of star indiciating favorite team in schedule and standing viewsyellowSee above
color.in-play-no-outColor of result where ball was put in play and no out was made (single, double, etc) in list of plays in game viewblueSee above
color.in-play-outColor of result where ball was put in play and an out was made (flyout, fielder's choice, etc) in list of plays in game viewwhiteSee above
color.in-play-runs-bgBackground color for score update in list of plays in game viewwhiteSee above
color.in-play-runs-fgForeground color for score update in list of plays in game viewblackSee above
color.on-baseColor of diamonds representing runners on base in top row of game viewyellowSee above
color.other-eventColor of other events (mound visit, injury delay, etc) in list of plays in game viewwhiteSee above
color.outColor of dots representing outs in top row of game viewredSee above
color.strikeColor of dots representing strikes in top row of game viewredSee above
color.strike-outColor of result where play ends on a strike (strike out) in list of plays in game viewredSee above
color.walkColor of result where play ends on a ball (walk, hit by pitch) in list of plays in game viewgreenSee above
favoritesTeams to highlight in schedule and standings viewsAny one of the following: ATL, AZ, BAL, BOS, CHC, CIN, CLE, COL, CWS, DET, HOU, KC, LAA, LAD, MIA, MIL, MIN, NYM, NYY, OAK, PHI, PIT, SD, SEA, SF, STL, TB, TEX, TOR, WSH. Or a comma-separated list of multiple (e.g. SEA,MIL)

Development

git clone https://github.com/paaatrick/playball.git
cd playball
npm install
npm start

Contributions are welcome!

3.1.2

1 month ago

3.1.1

9 months ago

3.1.0

9 months ago

3.0.0

2 years ago

2.2.2

3 years ago

2.2.1

4 years ago

2.2.0

4 years ago

2.1.0

4 years ago

2.0.4

4 years ago

2.0.3

5 years ago

2.0.2

5 years ago

2.0.1

5 years ago

2.0.0

5 years ago

1.1.0

6 years ago

1.0.1

6 years ago

1.0.0

8 years ago

0.1.4

9 years ago

0.1.3

9 years ago

0.1.2

9 years ago

0.1.1

9 years ago

0.1.0

9 years ago