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

1. Clone the repository.
2. Open NBAExtension.sln in Visual Studio 2022 (17.12+) with the Windows App SDK workload.
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
• User preferences for favorite teams
• Player stats integration
• Team standings
• WinGet distribution (0.0.1.x via Inno; 0.0.2.0+ via Microsoft Store)
• Add releases to GitHub (no clue how to do this yet)
• 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