{"id":24165639,"url":"https://github.com/addyosmani/firew0rks","last_synced_at":"2026-01-12T05:33:48.981Z","repository":{"id":270522013,"uuid":"910629476","full_name":"addyosmani/firew0rks","owner":"addyosmani","description":"Fireworks in your terminal 🎆","archived":false,"fork":false,"pushed_at":"2024-12-31T23:23:12.000Z","size":1839,"stargazers_count":504,"open_issues_count":1,"forks_count":26,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-11T23:04:50.746Z","etag":null,"topics":["ascii-fireworks","fireworks","fireworks-algorithm","fireworks-animation"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/addyosmani.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-12-31T21:39:29.000Z","updated_at":"2025-01-11T20:09:45.000Z","dependencies_parsed_at":"2024-12-31T23:28:44.032Z","dependency_job_id":"ebf885c6-1832-4a5d-b8bb-f9ba8bf41940","html_url":"https://github.com/addyosmani/firew0rks","commit_stats":null,"previous_names":["addyosmani/firew0rks"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addyosmani%2Ffirew0rks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addyosmani%2Ffirew0rks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addyosmani%2Ffirew0rks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addyosmani%2Ffirew0rks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/addyosmani","download_url":"https://codeload.github.com/addyosmani/firew0rks/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233546518,"owners_count":18692232,"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","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":["ascii-fireworks","fireworks","fireworks-algorithm","fireworks-animation"],"created_at":"2025-01-12T20:01:30.151Z","updated_at":"2025-09-20T10:32:36.522Z","avatar_url":"https://github.com/addyosmani.png","language":"JavaScript","funding_links":[],"categories":["\u003ca name=\"animation\"\u003e\u003c/a\u003eAnimation","JavaScript"],"sub_categories":[],"readme":"# firew0rks\n\nPlay text art animations in your terminal! This package includes several pre-made animations like fireworks and a cozy fireplace.\n\n![Eowzf_jWMAAk43x](https://github.com/user-attachments/assets/58d4c0ef-9f0b-49ae-80f0-4e12db3e34f0)\n\n## Installation\n\n```bash\nnpx firew0rks\n```\n\n## Usage\n\n```bash\nnpx firew0rks [folder] [loops]\n```\n\nParameters (all optional):\n- `[folder]`: Folder containing text art frames (numbered 0.txt, 1.txt, etc.). Defaults to 'fireworks'\n- `[loops]`: Number of times to loop the animation (-1 for infinite). Defaults to 20\n\n## Examples\n\nRun with defaults (fireworks animation, 20 loops):\n```bash\nnpx firew0rks\n```\n\nPlay the fireworks animation with custom loops:\n```bash\nnpx firew0rks fireworks 3\n```\n\nEnjoy a cozy fireplace forever:\n```bash\nnpx firew0rks fireplace -1\n```\n\n## Local Development\n\nTo run the package locally:\n\n1. Clone the repository\n2. Run directly with Node:\n```bash\nnode index.js\n# Or with custom parameters:\nnode index.js fireplace 5\n```\n\n## Creating Your Own Animations\n\n1. Create a new folder for your animation\n2. Add text art frames as numbered .txt files (0.txt, 1.txt, 2.txt, etc.)\n3. Run firew0rks with your folder name\n\n## Acknowledgments\n\nThis project is a JavaScript port of [text_art_animations](https://github.com/rvizzz/text_art_animations) by rvizzz. Thank you for the inspiration and the amazing ASCII art animations!\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faddyosmani%2Ffirew0rks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faddyosmani%2Ffirew0rks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faddyosmani%2Ffirew0rks/lists"}