https://github.com/agentmorris/scoreblocker-2000
An awesome black rectangle I use to cover sports scores
https://github.com/agentmorris/scoreblocker-2000
Last synced: 5 months ago
JSON representation
An awesome black rectangle I use to cover sports scores
- Host: GitHub
- URL: https://github.com/agentmorris/scoreblocker-2000
- Owner: agentmorris
- License: mit
- Created: 2025-09-07T21:53:56.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-11-10T04:36:22.000Z (7 months ago)
- Last Synced: 2025-11-10T06:14:31.647Z (7 months ago)
- Language: Python
- Size: 243 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ScoreBlocker 2000
## 🏈 Overview
ScoreBlocker 2000 is advanced technology for sports fans who want to watch games without having scores from other games ruined by on-screen graphics. This sophisticated, futuristic tool is also known as a "big black rectangle".
## 🏟️ Features
* Always on top
* Frameless design (no distracting graphics, just a big black rectangle)
* Drag to move/resize
* Multi-monitor support with preset configurations
* Launch multiple instances simultaneously
## 🏃♂️ Mobility & Control
- **Left-click and drag**: Move ScoreBlocker 2000 anywhere on your screen
- **Drag from edges or corners**: Resize the window
- **Middle-click**: Show current coordinates and copy to clipboard (helpful for creating config files!)
- **Right-click**: Exit the application
## 🏁 Getting Started
### Installation
* Ensure you have Python installed on your Windows system
* Clone or download this repository
### Running Single Instance
**Option 1: Double-click the VBS script (recommended)**
```
run_score_blocker.vbs
```
**Option 2: Command line**
```bash
python score_blocker.py
```
**Option 3: Batch file**
```
run_score_blocker.bat
```
### Multi-Monitor Setup (Recommended for Multiple Windows)
For launching two ScoreBlocker windows simultaneously on specific monitors:
**Step 1: Create your configuration files**
Create JSON configuration files with your desired window positions. Sample configs are provided in `configs/monitor1.json` and `configs/monitor2.json`:
```json
{
"primary": {
"x": 100,
"y": 50,
"width": 300,
"height": 150
},
"secondary": {
"x": 1500,
"y": 50,
"width": 300,
"height": 150
},
"background_color": "#000000",
"border_color": "#D3D3D3"
}
```
You can store config files anywhere (even outside the repo) and reference them by path.
**Step 2: Launch your monitor setup**
Use the provided VBS launcher scripts:
- `scoreblocker_launch_monitor1.vbs` - Launches two windows using `configs/monitor1.json`
- `scoreblocker_launch_monitor2.vbs` - Launches two windows using `configs/monitor2.json`
- `scoreblocker_close_all.vbs` - Closes all running ScoreBlocker instances
Or use the command line:
```bash
python launch_monitor.py configs/monitor1.json
```
**Step 3: Create desktop shortcuts**
Create desktop shortcuts to `launch_monitor1.vbs` and `launch_monitor2.vbs` for quick access to your different monitor setups.
### Configuration File Format
Configuration files specify two window positions (primary and secondary) plus color settings:
```json
{
"primary": {
"x": 100,
"y": 50,
"width": 300,
"height": 150
},
"secondary": {
"x": 1500,
"y": 50,
"width": 300,
"height": 150
},
"background_color": "#000000",
"border_color": "#D3D3D3"
}
```
Customize `background_color` and `border_color` using hex color codes (e.g., "#FF0000" for red).
## 🏅 Technical Requirements
- **Operating System**: Windows
- **Python**: Any version with tkinter (usually included)
## ⚙️ Advanced Usage
### Command Line Options
```bash
python score_blocker.py --help
```
Available options:
- `--config_file PATH` - Use a specific configuration file
- `--position primary|secondary` - Launch at specific position from config
- `--close_all` - Close all running ScoreBlocker instances
### Custom Launchers
You can create your own launcher scripts to set up multiple windows with different configurations. See `launch_monitor.py` for an example.
## 🤝 Contributing
Found a bug? Want to add a feature? We welcome contributions! This is open-source software under the MIT license.
## 📜 License
MIT