Skip to content
A small project that works on PS4 version of ESO. It mimics similar ability timer addons available on PC.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

ESO ability timer

Elder Scrolls Online Add-ons on PS4? Sure! This software mimics "ability timer" addons available on PC. It keeps track of when you have activated an ability and creates an animated bar based on the time data.

Important The software works only on two skills per character profile.


This project requires that you have ffmpeg installed with Blackmagic SDK. The code has been tested with FFmpeg 2.1.0 and Blackmagic Desktop 11.4 (and same version for SDK). My setup during dev phase was:

  • Ubuntu 18.04 Desktop
  • Blackmagic Intensity Pro 4K capture card
  • PS4 (with Elder Scrolls Online)
  • Python 3 with pip


The software's core functionality is to grab a frame from gameplay, crop the ability icons, and check whether the icon is activated or not. This comparison is performed using structural imilarity function from Sklearn. For this comparison to work, you must manually grab a frame when the icons activates. I have provided the icons I am using, but if your build uses completely different skills, you must grab these yourself.

Program's core logic

Assumed that you have a screenshot of the game taken at the moment when the ability icon is in its activated state, you can save the icon by modifying and running a helper script: ./tools/


Check the requirements section for other software.

git clone
pip install -r requirements.txt


Before using the script, you must configure the's profiles. Open the file in any text editor and change the values to your liking. The dict SKILLS_BEING_TRACKED should always contain exactly two skills and their duration in seconds. The abilitys location in the ability bar (index) is detected automatically.

When the setup is done, you can launch the software using various parameters. I recommend checking that the ffmpeg pipe is set up correctly by running the software with --nographics parameter. This will pass the grabbed image to OpenCV's imshow function without drawing any graphics or without performing any icon comparisons.

python --nographics

Assuming that the command above worked, you can exit the software by pressing 'Q' button on your keyboard.

To launch the software with a profile that you have set in, type

python --profile ProfileName

# e.g. python --profile StamDK 

By default, the software launches in windowed mode. If you are running a 1920x1080 monitor, you can run it in full screen by adding a parameter --fullscreen. Note that this does not scale the image. If you are running some other resolution, such as 2560x1440, the image will be in the top-left corner. Change your monitor to 1920x1080.

You can’t perform that action at this time.