From your point of view, everything is clear, because you are the author: you know what you are doing, why, etc.

But for a visitor of your github like me, even if I do a lot of Python, it's hard to understand quickly what it's about.

As I don't have 10 minutes to spend for each ShowHN, a video would be great to understand what it's about :)

I'd recommend something like I did here: https://github.com/maartenbreddels/ipyvolume

Just a medium quality animated gif that loads fast and gives people some idea of what it can do helps a lot. Most visitors spend only a few seconds, and don't want to click or go through the docs just to understand if they could use it. I had to read the comments here to understand, and it looks like a nice project, so it deserves this :)