sontek/snowmachine

A python script that allows your terminal to snow.

snowmachine

A python script that allows your terminal to snow. View it in action here:

• https://asciinema.org/a/624427
• https://asciinema.org/a/376826
• https://asciinema.org/a/376827

homebrew:

brew tap sontek/snowmachine
brew install sontek/snowmachine/snowmachine

pypi:

pip install snowmachine

nix:

nix-shell -p snowmachine --command snowmachine

docker:

docker run --rm -ti sontek/snowmachine

Getting Started

You can make it snow:

$ snowmachine snow

or render a tree:

$ snowmachine tree

You can also tell it to stack the snow if you prefer.

$ snowmachine snow --stack=pile

If you don't like the unicode particles you can tell it to use asterisk or some other character. If you use cmd.exe for example, this will be required.

$ snowmachine snow --stack=pile --particle="*"

You can also change the particle colors if you would like:

$ snowmachine snow --color=rainbow

In addition you can change the speed of particles:

$ snowmachine --speed=5

You can find a bash(shell) script version of this here: https://gist.github.com/sontek/1505483

Screenshot:

snowmachine's Issues

Background snow gen

Hi! Very fun project!

Would it be feasable to let the terminal snow... While you run other commands? A 'background snow' of sorts

Add little character that plows the snow

snowmachine tree error

[root@ ~]# snowmachine tree
Usage: snowmachine [OPTIONS]
Try 'snowmachine --help' for help.

Error: Got unexpected extra argument (tree)

Create ability to have it print tree

BSD Licensing

Hi! I was curious about the licensing of this repository. I saw that there were some references to BSD in setup.py:

$ rg 'BSD' -C 2 setup.py
21-    description=("A python script that will make your terminal "
22-                 "snow"),
23:    license = "BSD",
24-    setup_requires=['setuptools-git'],
25-    install_requires=requires,
--
34-        "Environment :: Console",
35-        "Environment :: Console :: Curses",
36:        "License :: OSI Approved :: BSD License",
37-    ],
38-    entry_points = {

However, I didn't see a BSD license included within the repository or mentioned on the frontpage.

Would you consider including a copy of the BSD license (or any other license you'd like to use) within the repository?

Make the stacking setup limit how high it goes and not grow too fast in 1 column

Maybe limit the height of a column to its closest neighbors

add support to print snowman

feat: Add amd64 docker image support

Currently the provided docker image is only for ARM64 not for x86 devices (which a still the most wiedly used devices)

In case you only have a MacBook with M1, you can use GH Actions to build and push multi-arch images to Dockerhub: https://github.com/marketplace/actions/build-and-push-docker-images

And a Keybord Interrupt handler would be nice to not print the exception when you kill the app.

If appreciated I'm happy to provide a PR for this