Skip to content

Commit 1fb2783

Browse files
authored
Update README.md
1 parent 55c1da6 commit 1fb2783

File tree

1 file changed

+39
-7
lines changed

1 file changed

+39
-7
lines changed

README.md

Lines changed: 39 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,45 @@
11
# StreamBlock
2+
A lightweight Python application that creates draggable colored overlay blocks on your screen.
3+
4+
## Features
5+
- **Draggable Blocks**: Create movable colored rectangles anywhere on your screen
6+
- **Resizable**: Easily adjust block dimensions with right-click drag
7+
- **Color Customization**: Choose any color for your blocks
8+
- **Always on Top**: Blocks stay visible over all other applications
9+
- **Save/Load Layouts**: Preserve your block arrangements for future use
10+
- **Real-time Controls**: Modify, move, and delete blocks on the fly
11+
12+
## Download
13+
- **Windows**: Download the package from the Releases page
14+
- **Others**: Clone the project folder and run the .py (*you might have to remove the `win32gui` and `win32api` imports, not tested*)
15+
16+
## Usage
17+
1. **Create blocks**:
18+
- Choose a color using the "Choose Color" button
19+
- Click "➕ Add New Block" to create a new overlay
20+
21+
2. **Control blocks**:
22+
- **Move**: Left-click and drag
23+
- **Resize**: Right-click and drag from bottom-right
24+
- **Delete**: Double-click on the block
25+
- **Change Color**: Middle-click on the block
26+
27+
## Technical Details
28+
- **Framework**: tkinter (Python's standard GUI library)
29+
- **Image Processing**: Pillow (PIL)
30+
- **Windows Integration**: pywin32 for DPI awareness and screen metrics
31+
- **Data Storage**: JSON for layout persistence
32+
33+
34+
## Use Cases
35+
- **Live Streams**: Hide burned-in ads or watermarks during live stream viewing
36+
- **Live Streaming**: Hide personal information, notifications, or sensitive content
37+
- **Screen Recording**: Block out areas you don't want recorded
38+
- **Presentations**: Cover content until ready to reveal
39+
- **Privacy**: Temporarily hide desktop elements during screen sharing
240

3-
4-
5-
6-
7-
8-
<br>
9-
<br>
1041
<br>
1142

1243
![StreamBlock_logo_small](https://github.com/user-attachments/assets/817db0da-9c06-4d42-b9cc-019d15fc2542)
1344

45+

0 commit comments

Comments
 (0)