xBFI

xBFI is a program that allows you to use Black Frame Insertion on a Linux or Windows desktop. xBFI accomplishes this by creating a blank window which will run on top of other programs whose transparency repeatedly turns on and off.

Black Frame Insertion is a technique where black frames are inserted between real frames to increase motion clarity, leading to a smoother picture. This technique is useful on a wide range of displays, such as LCD and OLED monitors running a game at 120FPS on a 240Hz display, or 30kHz CRTs running a 240p game at 60FPS. It is also incorporated on some high-end displays on a hardware level, but many displays still lack access to it.

Installation

The code snippets below are written for a Linux system with Git, CMake, and Make installed.

1. Clone repo with submodules

git clone --recurse-submodules https://github.com/wAABBsif/xbfi.git

2. Enter xbfi directory

cd xbfi

3. Generate Makefile using CMake

cmake ./

4. Build xBFI

make

5. (optional) If you want to run xBFI by simply typing xbfi as a command on Linux, you can move the generated xbfi file to /usr/bin

sudo mv ./xbfi /usr/bin/xbfi

Usage

Many desktop environments will require some adjustment to make xBFI properly run over top of other windows. For example, in KDE Plasma, you may need to tick "Keep Below Others" on fullscreen programs.

xBFI can be used without any parameters.

xbfi

If you're unsure how to run xBFI or which parameters to use, you can use the '-h' parameter for help.

xbfi -h

xBFI has a delay before it begins to draw Black Flame Insertion, you can use the 'd' parameter to change this.

xbfi -d <seconds of delay>

You can specify a monitor to run xBFI on with the '-m' parameter.

xbfi -m <number of monitor>

You can pick the number of frames the black screen is disabled, and the number of frames it's enabled with the '-n' parameter.

xbfi -n <number of frames disabled> <number of frames enabled>