Skip to content

kai9987kai/DiceRoller

DiceRoller

A small Python dice roller program with a simple Tkinter-based graphical interface.

Overview

DiceRoller is a lightweight desktop application for rolling dice from a small GUI.
The app lets you choose a die type, select how many dice to roll, and then generate random results.

Features

  • Simple graphical interface built with Tkinter
  • Select a die type from a dropdown
  • Choose the number of dice to roll
  • Uses dice face image assets for display
  • Lightweight and easy to run locally

Supported Dice

The current interface includes the following die options:

  • D4
  • D6
  • D8
  • D10

Requirements

  • Python 3
  • Tkinter
  • Pillow (PIL)

Installation

  1. Clone the repository:
git clone https://github.com/kai9987kai/DiceRoller.git
cd DiceRoller
  1. Install dependencies:
pip install pillow

Running the Project

Run the main Python file:

python "dice roller NEA BY KAI PIPER.py"

How to Use

  1. Open the application.
  2. Choose a die type from the dropdown.
  3. Select how many dice you want to roll.
  4. Click Start to generate the result.

Project Structure

  • dice roller NEA BY KAI PIPER.py — main application file
  • die1.png to die6.png — dice face images
  • LICENSE — Apache-2.0 license
  • CODE_OF_CONDUCT.md — code of conduct
  • SECURITY.md — security policy

License

This project is licensed under the Apache-2.0 License. See the LICENSE file for details.

Author

Created by Kai Piper.


One small improvement I would make next is to rename the main script to something shorter like `main.py` so the project is easier to run and maintain.
::contentReference[oaicite:1]{index=1}

About

DiceRoller is a lightweight desktop application for rolling dice from a small GUI. The app lets you choose a die type, select how many dice to roll, and then generate random results.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages