NBA Highlights Video Generator
Videos
Posted on NBA Full Play Highlights.
Author
Ronen Huang
Time Frame
August 2025 to Present
FFmpeg Build
Download from https://www.gyan.dev/ffmpeg/builds/.
Ollama Build
Download from https://ollama.com/download and pull one time.
ollama pull lfm2.5-thinking:1.2b
NBA Team Abbreviations
- atl - Atlanta Hawks
- bkn - Brooklyn Nets
- bos - Boston Celtics
- cha - Charlotte Hornets
- chi - Chicago Bulls
- cle - Cleveland Cavaliers
- dal - Dallas Mavericks
- den - Denver Nuggets
- det - Detroit Pistons
- gsw - Golden State Warriors
- hou - Houston Rockets
- ind - Indiana Pacers
- lac - Los Angeles Clippers
- lal - Los Angeles Lakers
- mem - Memphis Grizzlies
- mia - Miami Heat
- mil - Milwaukee Bucks
- min - Minnesota Timberwolves
- nop - New Orleans Pelicans
- nyk - New York Knicks
- okc - Oklahoma City Thunder
- orl - Orlando Magic
- phi - Philadelphia 76ers
- phx - Phoenix Suns
- por - Portland Trail Blazers
- sac - Sacramento Kings
- sas - San Antonio Spurs
- tor - Toronto Raptors
- uta - Utah Jazz
- was - Washington Wizards
Manually Make Videos
The full play videos can be made from the reliable play by play rather than the unreliable box score.
from nba_video_generator.src import pipeline
pipeline(
[
("DiVincenzo", "2026-04-20", "min"),
],
{
"ffmpeg_path": r"C:\Users\ronen\Documents\Projects\nba_video_generator\src\nba_video_generator\ffmpeg-9.0.2-essentials_build\bin\ffmpeg.exe"
}
)
A date range can be specified as well.
from nba_video_generator.src import pipeline
pipeline(
[
("Booker", "2026-04-19", "2026-04-27", "phx"),
],
{"ffmpeg_path": r"C:\Users\ronen\Documents\Projects\nba_video_generator\src\nba_video_generator\ffmpeg-9.0.2-essentials_build\bin\ffmpeg.exe"}
)
Process
- Specify the player last name (as per NBA.com website), team abbreviation, and date(s) (yyyy-mm-dd).
- Programs crawls through play by play by quarter, keeping a list of links and times.
- Events within 5 seconds of each other are merged to a single event.
- Plays are concatenated together to make the video.
A video of the process is provided below.
https://www.youtube.com/watch?v=84GDSAL5CeE
Automatically Make Videos With Agent
Makes videos of the LLM determined best player performances of specified date (default today).
from nba_video_generator.nba_agent import run_agent
date = "2026-06-10"
ffmpeg_path = r"C:\Users\ronen\Documents\Projects\nba_video_generator\src\nba_video_generator\ffmpeg-9.0.2-essentials_build\bin\ffmpeg.exe"
run_agent(date, ffmpeg_path)
Process
- Specify the date (yyyy-mm-dd).
- LLM chooses players from pool of candidates that meet thresholds in src/nba_video_generator/nba_agent/config.py.
- The videos are made with the
pipelinemethod. The thumbnails with relevant statistics are made afterward. - (Optional) Upload to YouTube with Python. Example program in src/nba_video_generator/example_youtube_upload_scripts. Link to data api - https://developers.google.com/youtube/v3/guides/uploading_a_video.
A video of the process is provided below.
https://www.youtube.com/watch?v=IC8SrrvS4xE&feature=youtu.be
Automatically Make Game Top Plays Shorts - NEW
Makes shorts of the top 4 plays from each specified date (default today). Made scoring plays are excluded when they occur with 5:00 or less remaining in the fourth quarter and the team was already leading by at least 20 points. Fourth-quarter buzzer-beaters are also excluded unless they tie the game or change which team is leading.
from nba_video_generator.nba_shorts import make_shorts_for_date
date = "2016-06-19"
ffmpeg_path = r"C:\Users\ronen\Documents\Projects\nba_video_generator\src\nba_video_generator\ffmpeg-9.0.2-essentials_build\bin\ffmpeg.exe"
make_shorts_for_date(date, ffmpeg_path)
Web Interface
Run the video-generation and upload workflows from a local browser dashboard:
python -m pip install --upgrade nba-video-generator
nba-video-generator-web
After the new release is published, install it from PyPI as shown above. The
dashboard opens at http://127.0.0.1:8765. It includes forms for the
player pipeline (including date ranges and multiple players), the daily agent
(load finished games for a date and choose which to analyze), and top-plays
Shorts. Each video workflow lets you choose the output folder. When the player
pipeline cannot match a steal, block, turnover, or miss to an exact NBA play
event, it uses the action ID immediately before the first feed action found at
that game clock. Jobs run in the background and stream their output to the
activity panel. The YouTube upload workflow lets you select a video folder and
Google client_secrets.json using local file pickers. Uploads default to
private, preserve local files, and use a saved OAuth token under your home
directory. Only one workflow can run at a time. To choose another port or keep
the browser closed:
nba-video-generator-web --port 8766 --no-browser
1 maintainer
Metadata
1 maintainer
Release files for nba-video-generator 7.0.22
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| nba_video_generator-7.0.22.tar.gz | 71.5 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nba_video_generator-7.0.22-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 153.2 kB
Release files / nba_video_generator-7.0.22.tar.gz
| Download URL | nba_video_generator-7.0.22.tar.gz |
|---|---|
| Size | 71.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0bddf4687f109738f1822709407eabf8eb27059e825d760e9cedca4267c709d1
|
|
BLAKE2b-256 checksum How to use checksums |
096f719bea240c9deee076769e8edb2bdc14a038be1e31b01911a96844d082ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / nba_video_generator-7.0.22-py3-none-any.whl
| Download URL | nba_video_generator-7.0.22-py3-none-any.whl |
|---|---|
| Size | 81.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e8c40eb783a9928caee56e0312407faf6c14d692f5e2de445b3baab4fd938e28
|
|
BLAKE2b-256 checksum How to use checksums |
4778571afda25d828d57d29f28e5f47ea4790e69ccd0b3fe91591310d8a94043
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logSecurity for nba-video-generator 7.0.22
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for nba_video_generator-7.0.22.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
