NBA Command Palette Extension joadoumie

windows-commandpalette-extension

Use this command to install NBA Command Palette Extension:

winget install --id=joadoumie.NBACommandPaletteExtension -e

All things NBA for the Windows Command Palette

NBA Command Palette Extension

NBA Logo

All the things you may desire for the NBA right at your fingertips.

📋 Overview

NBA Command Palette Extension brings real-time NBA game information directly into your Windows Command Palette. Stay updated on games, scores, schedules, and player stats without leaving your workflow.

> ⚠️ Work in Progress: This extension is actively being developed. Next milestone: ship 0.0.2.0 through the Microsoft Store so PowerToys actually finds it.

✨ Features

🏀 View Upcoming Games

Browse all NBA games for the upcoming week with rich details:

Live game information with team records (e.g., Lakers (14-4) vs. Pelicans (4-14))
Real-time scores for games in progress
Game status indicators with quarter and time remaining
Team logos and visual indicators
Smart search with fuzzy matching to quickly find your favorite teams
Date and time in EST with automatic timezone conversion
Direct links to ESPN for full game details

📊 Team & Game Leaders

View statistical leaders for any matchup:

View Team Leaders for upcoming games - see season leaders for both teams (PPG, RPG, APG)
View Game Leaders for live/completed games - see game-specific performance stats
Player headshots and details (jersey number, position)

👥 Team Rosters

Browse complete team rosters with comprehensive player information:

Full roster listings for any NBA team
Player details view with bio, physical stats, and career information
Injury status tracking with visual indicators (available/injured)
Player attributes: position, jersey number, height, weight, age, experience
Quick links to player stats, game logs, news, biography, and splits on ESPN
Player headshots and visual presentation
Direct access from any game listing to view either team's roster

🚀 Installation

> Upgrading from 0.0.1.x? Those builds shipped as an Inno .exe that > registered a COM server but wasn't discoverable by PowerToys Command > Palette. Uninstall them from Settings → Apps → Installed apps > (search "NBA Command Palette Extension") before installing 0.0.2.0.

Option 1: Microsoft Store

Install from the Microsoft Store listing — this is the recommended path. The Store signs and delivers the MSIX, and PowerToys picks it up automatically via the Command Palette AppExtension contract.

Option 2: winget

winget install joadoumie.NBACommandPaletteExtension

winget routes to the Store listing under the hood, so this is equivalent to Option 1.

Option 3: From source (for contributors)

Clone the repository.
Open NBAExtension.sln in Visual Studio 2022 (17.12+) with the Windows App SDK workload.
Set the active platform to x64 (or ARM64) and Release, then Deploy the NBAExtension project. Deploying registers the MSIX on your machine so PowerToys can find it.
Open PowerToys Command Palette and search for "NBA".

🎮 Usage

Open Windows Command Palette (must be installed via PowerToys)
Type NBA or search for "View Upcoming NBA Games"
Browse upcoming games sorted by date
Use fuzzy search to filter by team name (e.g., type "lakers" or "LAL")
Click any game to view full details on ESPN
Right-click or use context menu to view team rosters or statistical leaders

Search Tips

Type team names: lakers, warriors, celtics
Using abbreviations: LAL, GSW, BOS is NOT CURRENTLY SUPPORTED... and idk if it ever will be? maybe?
Search by matchup: lakers vs warriors

Key Components

Source Generation: Uses JSON source generation for AOT compatibility and performance
Caching: 5-minute cache for API responses to reduce load
Fuzzy Search: Smart search algorithm for quick team filtering
Dynamic Updates: Real-time score updates for live games
Context-Aware Commands: Different leader views based on game status
Rich Details View: Enhanced player and team information with metadata

🗺️ Roadmap

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

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

🙏 Acknowledgments

Microsoft friends for the Command Palette Extensions SDK. So much fun to build with.
NBA fans everywhere 🏀

📞 Support

If you encounter any issues or have suggestions:

🐛 Report a bug
💡 Request a feature
⭐ Star this repository if you find it useful!

Made with ❤️ by NBA fans for NBA fans