A CLI initiative tracker in the works.
Roll for Initiative!
What is this?
This is a terminal-based initiative tracker primarily aimed at Dungeons & Dragons 5th edition. I use the term "initiative" mostly for being recognizable, and most systems have something similar: a queue of actions that happen in order given a numeric value.
All initiative trackers I found only are bloated. They cram as many features as possible with little to no regards to UX. I'm going back to the basics: a CLI tool to manage initiative. No "create encounter". No "what is this creature's initiative bonus?" popup.
I hate the "create encounter" feature of these initiative trackers. I admit, this might be due to my GM style, but I don't want to plan every single encounter the night before. I don't know what my players will do, I need the flexibility to improvise.
The main motivation for me to create this, really, is just so I have a clean interface with really shallow menus and no setup time. This is the project philosophy.
help commandif you have any doubts.
- Tab completion is your friend. After beginning to type a command, press tab to cycle through the suggestions.
This is a TL;DR. You can find more information after this.
add name initiativeas many times as you like.
initiativemay be a number or a diceroll expression.
- Entries are ordered by their decreasing initiative value.
- If there is a tie, you can reorder them using
move lower_entry_name upor
move upper_entry_name down.
- Any time you want to see the queue but it's not visible, run
- Press enter when the input field is empty to advance to next entry.
- When a creature dies or for some other reason its entry is no longer relevant to the queue, type
That's pretty much what you need to know to use it at a basic level.
To install the
rfi command to your user scope, run:
pip install --user --upgrade roll-for-initiative
If you want to install directly from source, you can do:
cd /path/to/target/source/dir git clone https://github.com/wqferr/RFI cd RFI pip install --user --upgrade flit flit install -s
After installing it with either method, you can run it with
rfi on linux, or with
python -m rfi.app
on any platform if that doesn't work.
This application is made using the following libraries and tools:
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for roll-for-initiative-0.16.1.tar.gz
Hashes for roll_for_initiative-0.16.1-py2.py3-none-any.whl