pixelfresh

Surface Pro 4 Flickergate Mitigation Tool - Automatically refreshes display pixels to prevent screen flicker.

Installation

From Source

pip install -e .

Building with Nuitka (Native Binary)

chmod +x build.sh
./build.sh
# Binary will be at ./dist/pixelfresh
sudo cp ./dist/pixelfresh /usr/local/bin/pixelfresh

Configuration

Copy the example config:

mkdir -p ~/.config/pixelfresh
cp config.example.toml ~/.config/pixelfresh/config.toml

Edit ~/.config/pixelfresh/config.toml to customize intervals.

Usage

Start the Daemon

pixelfresh start --daemon

Commands

pixelfresh status          # Show current mode and refresh count
pixelfresh toggle-ultra    # Toggle ultra mode on/off
pixelfresh enable-ultra    # Enable ultra mode
pixelfresh disable-ultra   # Disable ultra mode (return to normal)
pixelfresh stop            # Stop the daemon

Hyprland Integration

Add this to your ~/.config/hypr/hyprland.conf:

bind = $mod, U, exec, pixelfresh toggle-ultra
bind = $mod SHIFT, U, exec, pixelfresh enable-ultra

How It Works

• Normal Mode: Refreshes pixels every 30 minutes with 5 second sleep
• Ultra Mode: Refreshes pixels every 2 minutes with 2 second sleep (for gaming)

Troubleshooting

hyprctl not found

Make sure Hyprland is installed and hyprctl is in your PATH.

Config file not found

Create the config directory:

mkdir -p ~/.config/pixelfresh
cp config.example.toml ~/.config/pixelfresh/config.toml