OSCR-UI 2025.9.14.2

Open Source Combatlog Reader

OSCR-UI

User Interface for the OSCR parser.

Companion Web Application

The STOCD team provides a companion web application for OSCR located at oscr.stobuilds.com. This allows users to view and download combat log data without OSCR installed, however uploads and more detailed analysis of combat logs requires OSCR or a parser that supports interracting with OSCR's backend such as CLA.

Windows Users

For Windows users we have an installer available on the Releases page.

Installation

PyPI

python3 -m pip install OSCR-UI

Externally Managed Python Environments (Arch)

The recommended way is using pipx to install from PyPi without --break-system-packages, if you don't already have it, you can install it through pacman.

pacman -Sy python-pipx
pipx install OSCR-UI

Github

python3 -m pip install git+https://github.com/STOCD/OSCR-UI.git

Running

oscr

Development

It is recommended to use a python virtual environment to house this app.

# Clone the repository
git clone https://github.com/STOCD/OSCR-UI.git
cd OSCR-UI

# Set up the virtual environment
virtualenv venv

# Windows
.\venv\Scripts\activate

# Linux
source ./venv/bin/activate

# Install OSCR + Requirements.
python3 -m pip install .