Skip to content
Frametime logger for Linux Vulkan/OpenGL
Branch: master
Clone or download
Latest commit 357c2c8 May 4, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Update makefile and add license May 4, 2019
LICENSE Update makefile and add license May 4, 2019
Makefile Update makefile and add license May 4, 2019
README.md Clarify usage May 4, 2019
libperflogger.conf Add ld config file May 4, 2019
perflogger.sh Complete makefile and update readme and script May 4, 2019

README.md

libperflogger - Game performance logging library

Libperflogger is a library for monitoring frametimes in OpenGL/Vulkan games for Linux.

Installation

git clone https://github.com/Lurkki14/libperflogger
cd libperflogger
make
sudo make install

make install installs the libraries in /usr/local/lib/libperflogger, the script in /usr/local/bin and an ld config file into /etc/ld.so.conf.d

Usage

LD_PRELOAD="${LD_PRELOAD}:libperflogger.so" <program>

Environment variables:

PERFLOGGER_LOG_DIR=<dir> # Directory for the logfile - no logfile is saved if not set
PERFLOGGER_USE_STDOUT=1 # Display performance information in stdout

The supplied script can be used to simplify usage once 'make install' is ran:

perflogger <program> [options]

Options:

--log_dir=<dir> # Same as PERFLOGGER_LOG_DIR
--use_stdout # Same as PERFLOGGER_USE_STDOUT=1
--help # Display a help message

To use in Steam games, set the following launch option:

perflogger %command%

or

LD_PRELOAD="${LD_PRELOAD}:libperflogger.so" %command%

For viewing the logfile with gnuplot:

gnuplot -p -e 'set ylabel "milliseconds"; set xlabel "frames"; set yrange [0:100]; plot"<log location>" with lines'
You can’t perform that action at this time.