NBA Command Palette Extension

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, standings, and player stats without leaving your workflow.

⚠️ Work in Progress: This extension is actively being developed and is available on the Microsoft Store. Every list now groups its results into labeled sections. Next up: favorite-team preferences and auto-refresh for live games.

✨ 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

📈 League Standings

Check the playoff picture at a glance:

• Eastern and Western Conference shown as separate sections
• Seeded 1–15 with each team's win/loss record
• Filter by conference
• Team logos and direct links to ESPN

New in 0.0.3.0: every list page (Games, Standings, Team Leaders, Rosters) now groups its results into labeled sections with headers instead of one flat list.

🚀 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)

1. Clone the repository.
2. Open NBAExtension.sln in Visual Studio 2022 (17.12+) or later. Install these via the Visual Studio Installer first:
   • Windows application development workload (Windows App SDK + WinUI + the single-project MSIX deploy tooling)
   • Desktop development with C++ workload — or at minimum the MSVC v14x C++ x64/x86 build tools (the CsWinRT AOT step shells out to MSVC)
   • Windows 11 SDK 10.0.26100 (matches the project's target platform)
3. 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.
4. Open PowerToys Command Palette and search for "NBA".

🎮 Usage

1. Open Windows Command Palette (must be installed via PowerToys)
2. Type NBA or search for "View Upcoming NBA Games"
3. Browse upcoming games sorted by date
4. Use fuzzy search to filter by team name (e.g., type "lakers" or "LAL")
5. Click any game to view full details on ESPN
6. 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

• View upcoming games for the week
• Display team records
• Live score updates
• Fuzzy search functionality
• View team leaders (season stats)
• View game leaders (in-progress/completed games)
• Team roster viewing with detailed player info
• Player injury status tracking
• Team standings (Eastern/Western, sectioned)
• Sectioned list pages with headers
• Add releases to GitHub
• User preferences for favorite teams
• Player stats integration
• WinGet distribution (0.0.1.x via Inno; 0.0.2.0+ via Microsoft Store)
• Auto-refresh for live games

🤝 Contributing

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

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. 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