DMing

DMing is a CLI (command-line interface) collection useful when running a TTRPG (tabletop role-playing game).

DMing(Dungeon Mastering): Performing as a dungeon master, or running a tabletop role-playing game, especially Dungeons & Dragons.

Installation

pipx install dming

Usage

DMing provides a grouped command for all tools. The standalone roll command remains available as a shortcut for dming roll.

Roll Dice

Use the command roll <dice>.

Examples:

• roll 1d20: roll a d20 die
• roll 1d100: roll a d100 die
• roll 2d20kh1: roll with advantage
• roll 2d20kl1: roll with disadvantage
• roll 2d20dl1: roll with advantage
• roll 2d20dh1: roll with disadvantage
• roll 1d20+4: roll a d20 die with a +4 modifier
• roll 1d20-4: roll a d20 die with a -4 modifier

Add -d or --details to show every die, which dice were selected by a keep or drop filter, and the complete arithmetic formula. Use --plain for output without styling or emojis.

$ roll --details 2d20kh1
🎲 2d20kh1
├─ 2d20kh1: 19, 9 → 19 (keep highest 1)
├─ Math: 19
└─ Result: 19

$ roll --details 2d20
🎲 2d20
├─ 2d20: 4, 4
├─ Math: 4 + 4
└─ Result: 8

$ roll --details --plain 2d20
Roll:   2d20
2d20:   4, 4
Math:   4 + 4
Result: 8

Chance Tables

Use dming chance <die> to show the chance of meeting or exceeding each target with a standard roll, advantage, or disadvantage. Tables support one die with an optional modifier. The Roll Needed column shows the lowest natural roll that reaches each target.

$ dming chance d20
$ dming chance d20+5
$ dming chance d20-3 --min-target 5 --max-target 30

The default range starts at target 1 and ends at the greater of the die size or the highest modified total. Override either boundary with --min-target and --max-target. Percentages use ordinary threshold rules; natural minimum and maximum rolls do not introduce automatic failure or success rules.

Unit Conversions

Use dming convert to show Rich reference tables that convert common US customary measurements to metric units.

$ dming convert distance
$ dming convert weight

Distance prints separate tables for inches, feet, and miles. The Squares column expresses each distance as a number of 5-foot grid spaces. Weight shows pounds converted to kilograms. Measurement units appear in the table headers, such as (ft.), (m.), (lb.), and (kg.).

Supply repeatable unit options to build a table from custom values. When any custom values are supplied, only the requested unit tables are shown.

$ dming convert distance --foot 5 --foot 30
$ dming convert distance --inch 6 --mile 1
$ dming convert weight --pound 2.5 --pound 10

2024 Rules References

Use dming rules for fixed Rich tables from the official 2024 D&D rules.

$ dming rules abilities
$ dming rules carrying
$ dming rules difficulty
$ dming rules proficiency
$ dming rules sizes

Each table is based on an official 2024 rule:

• Ability Modifiers
• Typical Difficulty Classes
• Proficiency Bonus by Level or Challenge Rating
• Creature Size and Space
• Carrying Capacity

Creature sizes also include metric dimensions. Carrying-capacity entries also include kilogram equivalents for carrying and for dragging, lifting, or pushing.

Using the Library

from dming.dice import roll

operation, result = roll("1d20+2")

Alternatives

• JavaScript: Dice Roller & Parser.

Development

For development instructions, see the DMing development guide.

Releases

GitHub Releases are the canonical release history. See DMing releases for release notes and downloadable artifacts.