{"id":15902030,"url":"https://github.com/erikh/fireworks","last_synced_at":"2025-07-30T09:04:20.373Z","repository":{"id":193602046,"uuid":"689139318","full_name":"erikh/fireworks","owner":"erikh","description":"python TUI fireworks","archived":false,"fork":false,"pushed_at":"2023-09-14T09:29:25.000Z","size":55,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-11T16:58:07.147Z","etag":null,"topics":["art","python","screensaver","tui"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/erikh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-08T22:50:11.000Z","updated_at":"2023-09-10T17:18:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"a1ecc851-532e-40f6-8517-f2fea8a7ae6e","html_url":"https://github.com/erikh/fireworks","commit_stats":null,"previous_names":["erikh/fireworks"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/erikh/fireworks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikh%2Ffireworks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikh%2Ffireworks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikh%2Ffireworks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikh%2Ffireworks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erikh","download_url":"https://codeload.github.com/erikh/fireworks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikh%2Ffireworks/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267842974,"owners_count":24153133,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["art","python","screensaver","tui"],"created_at":"2024-10-06T11:21:45.809Z","updated_at":"2025-07-30T09:04:20.342Z","avatar_url":"https://github.com/erikh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"This is an attempt at learning python in a fun way. It is not an attempt to\ncreate sustainable open source. You've been warned. :)\n\nThis is a TUI \"screen saver\" that displays fireworks on the terminal. It will\ndisplay them until Ctrl+C is pressed and is designed to work with `tmux`, etc,\nto provide some bling on your terminal when you only need half of it.\n\nNow with 256-color support! Click\n[here](https://www.youtube.com/watch?v=embSVDBlv5Q) for a demo on YouTube.\n\nUsage:\n\n-   Clone the repo and `cd` into it\n-   `pip install -r requirements.txt`\n-   `python main.py`\n\n**NOTE:** on OS X you will need homebrew python and then `pip3 install -r\nrequirements.txt` before things will work. I don't know why, but stock OS X\npython doesn't come with the `termios` library that seems to come standard with\npython 3.\n\nI learned a little bit about python and got to create something neat along the\nway. Big thanks to [@jpetazzo](https://github.com/jpetazzo) for help with\nsimplifying some of the drawing logic, packaging and general feedback.\n\nSome notes:\n\n-   10 fireworks are launched at start, and every 5 iterations (about half a second) a new one is launched. Fireworks trail north and have a chance of exploding on every frame. Each flare and explosion have random components to the trail and characters used. If the terminal is resized, it clears and rebuilds the scene anew.\n-   It is not very nice to your CPU! Maybe I'll fix that someday.\n-   I tried to take an asciicast of it but asciicasts.io won't allow uploads that large :) It's quite needy with the terminal.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferikh%2Ffireworks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferikh%2Ffireworks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferikh%2Ffireworks/lists"}