A simple system tray widget for Windows that displays live cricket scores from Cricbuzz, built with Electron, React, and Vite.
- Fetches live match list from Cricbuzz homepage.
- Displays detailed scores for a selected match in a draggable, always-on-top window.
- Includes batting and bowling scorecards (when available).
- Shows match status (live, completed, result, Player of the Match).
- Pinning feature to keep the widget always on top.
- Light/Dark theme toggling.
- Auto-refreshes match list and detailed scores.
- Download: Go to the Releases Page on GitHub.
- Download the latest
CricketWidget Setup X.Y.Z.exe
file from the Assets section of the most recent release. - Run Setup: Double-click the downloaded setup file and follow the installation prompts.
- Launch: After installation, the widget should start automatically. If not, find it in your Start Menu.
- Tray Icon: A cricket icon will appear in your system tray (notification area).
- Select Match: Right-click the tray icon to see a list of current matches. Click on a match to view its detailed score in the main window.
- Window Interaction:
- Show/Hide: Left-click the tray icon or right-click and select "Show/Hide" to toggle the main window's visibility.
- Pinning: Use the pin icon (📌/➖) in the widget's header to toggle the always-on-top behavior. If unpinned, the widget hides when it loses focus.
- Dragging: Drag the widget by clicking and holding anywhere on its header/background.
- Toggle View: Right-click the tray icon and select "Toggle View" to switch between the match list and detailed score (if a match is selected).
- Toggle Theme: Right-click the tray icon and select "Toggle Theme" to switch between light and dark modes.
- Refresh: Right-click the tray icon and select "Refresh Data" to manually update the match list.
- Exit: Right-click the tray icon and select "Quit".
- Prerequisites:
- Node.js (version 20 or later recommended)
- pnpm (Install via
npm install -g pnpm
)
- Clone the repository:
git clone https://github.com/hk-vk/cricket-score-widget.git cd cricket-score-widget
- Install dependencies:
pnpm install
- Run the development server:
This will start the Vite development server for the React frontend and launch the Electron application.
pnpm run dev
To build the application for distribution (creates an installer in the release
folder):
- Ensure development dependencies are installed (
pnpm install
). - Run the distribution command:
pnpm dist
- The installer (
CricketWidget Setup X.Y.Z.exe
) will be located in therelease
folder.
Contributions, issues, and feature requests are welcome!
This project is licensed under the ISC License. See the LICENSE
file for details (if included).