/Kitten-RNG

Kittens as an entropy source

Primary LanguagePython

Kitten Random Number Generator

What?

It's a wonderfully practical python module that generates random numbers based off a kitten livestream (in reference to a meme).

Installation

Make sure you have a 3.* version of python installed along with pip. Then you install via pip from pypi:

python -m pip install --upgrade kitten-rng

Usage

The Command Line Tool

To get a massive random number based off the kitten livestream:

python -m KRNG

The Module

To get a random number from the cat livestream:

from KRNG import RNGs

number = RNGs.KRN()
print(number)

To get a random number generator seeded with a Kitten Random Number (KRN):

from KRNG import RNGs

rng = RNGs.KPRNG()
print(rng.random())

Why?

So I was watching Tom Scott videos when I heard this. So, now I have created a tool that makes a random number based of a kitten livestream that can be found here. What a wonderfully practical invention.

How?

So I used pafy to get the url for the actual video file, and then fed that url into a cv2 VideoCapture and got the first frame (which I can do because pafy only gets a few frames of the livestream). Then I feed that data into a sha256 urllib hash function and convert that to a number.