Skip to content
Switch branches/tags

Run the program from sources

Getting the sources

First of all, clone the repo

Build Status

git clone
cd ./l5r-character-manager-3/
git checkout develop

Create a virtual environment

Install python3-venv and create a new virtual environment for python.

apt install python3-venv
python3 -m venv .venv
source .venv/bin/activate

Installing the dependencies

Before running the program you need to install the dependencies: Some of them can be installed using pip:

pip install -r requirements.txt
pip install git+

Windows users can download PyQt5 binaries from here:

Note for Windows users

You will need a basic compiler in order to build some of the dependencies (mainly lxml).

You will also need to install Python 3.6.x from here:

Note for Linux users

You will need to download one more dependency, the pdf toolkit, needed to export the character sheets. Use you package manager to install the pdftk package. I recommend this version:

Finally you launch the program

cd l5r

Getting the Datapacks

The software alone is not useful. You need game data in order to create and manage your characters.

Game data is provided through packages named "datapacks" that are downloadable from the project website:

however you might want to compile the datapack yourself; in order to do so follow these simple instructions.

Clone the datapack repository

The data pack sources are hosted in a different repo, to get them run:

git clone
git checkout develop

Build the datapacks

In the repo there is a convenience script that builds all the datapacks

cd scripts

Installing the datapacks

The preferred way to install datapacks is from the application menu. Click on Gear menu -> Import datapack... and select the files to import. Tipically datapacks have the .l5rcmpack extension. This operation is only needed the first time and on each datapack update.

If the program was installed using the setup and/or debian file then you can also doubleclick the datapack files.


If you make a modification to the software or datapack that add value to the application don't esitate to share it!

Please submit a pull request to the relative repository :)