https://github.com/revelaction/pixelchanged
pixelchanged is a simple bash script to detect changes in a region of your screen and execute commands when the change happens.
https://github.com/revelaction/pixelchanged
bash change grim screenshot slop slurp swaywm wayland x11
Last synced: 6 months ago
JSON representation
pixelchanged is a simple bash script to detect changes in a region of your screen and execute commands when the change happens.
- Host: GitHub
- URL: https://github.com/revelaction/pixelchanged
- Owner: revelaction
- License: mit
- Created: 2022-01-29T13:35:54.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-10-22T09:37:46.000Z (almost 2 years ago)
- Last Synced: 2025-03-26T09:12:30.611Z (7 months ago)
- Topics: bash, change, grim, screenshot, slop, slurp, swaywm, wayland, x11
- Language: Shell
- Homepage:
- Size: 39.1 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Authors: AUTHORS
Awesome Lists containing this project
README
[]()
`pixelchanged` is a simple `bash` script to detect changes in a region of your
screen and execute commands when the change happens.
https://user-images.githubusercontent.com/96388231/151698551-528610c2-0886-47db-8052-15f520708774.mp4
`pixelchanged` works in linux (wayland and x11).
# Installation
## Dependencies
Install the dependencies:
### Wayland
On debian based operating systems, install with:
```console
sudo apt install slurp grim awk
```
### X11
On debian based operating system, install with:
```console
sudo apt install imagemagick slop awk
```
## Install script
```console
curl -LO https://raw.githubusercontent.com/revelaction/pixelchanged/master/pixelchanged.sh
# make it executable
chmod +x pixelchanged.sh
# copy it to your path
cp pixelchanged.sh ~/bin
```
# Usage
```console
⤷ pixelchanged.sh
Please select a region of the screen
Selected region: 100x101+2346+397. Desktop type: x11
📡 Starting monitoring for changes of the selected region each 10 seconds.
```
# Examples
## Desktop notification
Per default, the script creates a desktop notification when it detects a change
in the selected region.
```bash
change_handler()
{
# put commands here that are executed when a change in the pixel happens
notify_desktop
# play_sound
}
```
## Play sound
To play a sound when the selected region changes just substitute the path to a
music file in the `play_sound` function.
```bash
play_sound()
{
check_command "cvlc"
cvlc --play-and-exit .opus
}
```
and uncomment the call to the function in `change_handler`
```bash
change_handler()
{
# put commands here that are executed when a change in the pixel happens
# notify_desktop
play_sound
}
```
# Customize
Modify the script to run arbitrary commands by first creating a bash function:
```bash
my_commands()
{
# my commands
}
```
Add the function call to the `change_handler` function:
```bash
change_handler()
{
# put your commands function here
my_commands
# notify_desktop
# play_sound
}
```