staticfx 2.0.0__py3-none-any.whl

staticfx-2.0.0.dist-info/METADATA

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: staticfx
+Version: 2.0.0
+Summary: Animated ASCII effects for your terminal, with a studio for making your own
+Author: ethanlabs101
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ethanlabs101/StaticFX
+Project-URL: Documentation, https://github.com/ethanlabs101/StaticFX/blob/main/docs/USAGE.md
+Project-URL: Changelog, https://github.com/ethanlabs101/StaticFX/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/ethanlabs101/StaticFX/issues
+Keywords: terminal,ascii,animation,cmatrix,screensaver,tui,ascii-art
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Artistic Software
+Classifier: Topic :: Terminals
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Dynamic: license-file
+
+# StaticFX
+
+Animated ASCII effects for your terminal. Think `cmatrix`, but with a
+thousand more effects, live theme switching, and a studio for making your own.
+
+![StaticFX demo: Matrix rain, the effect browser, a galaxy, the Studio](https://raw.githubusercontent.com/ethanlabs101/StaticFX/main/assets/demo.gif)
+
+Pure Python, no dependencies, runs in any modern terminal on Linux, macOS
+and WSL.
+
+## Install
+
+You need Python 3.10 or newer.
+
+```bash
+pipx install staticfx
+staticfx
+```
+
+(`pip install staticfx` works too; [pipx](https://pipx.pypa.io) just keeps it in
+its own environment.) To try it without installing anything:
+
+```bash
+git clone https://github.com/ethanlabs101/StaticFX
+cd StaticFX
+python3 -m staticfx
+```
+
+## The 30-second tour
+
+Key | Does
+--- | ---
+`←` `→` | Previous / next effect
+`m` | Browse and search every effect, with live preview
+`t` | Change the colour theme
+`l` | Looks: effect + theme + filters, saved under a name
+`n` | Make your own effect in the Studio
+`f` | Favourite
+`a` | Auto-cycle (screensaver mode)
+`?` | Every key
+`q` | Quit
+
+Everything is remappable in Settings (`o`). The full guide is in
+[docs/USAGE.md](https://github.com/ethanlabs101/StaticFX/blob/main/docs/USAGE.md).
+
+## What's inside
+
+There are 50 hand-written effects in seven groups. Rain: the classic, plus
+binary, hex and glitch versions. Particles: snow, embers, fireworks, orbits.
+Space: a starfield, a galaxy, a black hole, a wormhole. Waves and fields:
+plasma, aurora, a lava lamp, a synthwave grid. Geometry: a tumbling cube, a 4D
+tesseract, spirographs. Simulations: Game of Life, Langton's ant, fire, a maze
+that carves itself. Retro tech: boot screens, decryption, circuits, TV static.
+
+On top of those are 992 generated effects. Each one is a recipe of layered
+patterns (spirals, Julia and Mandelbrot fractals, Voronoi cells, metaballs,
+noise), warps (kaleidoscope, swirl, tile, fold) and filters. They're seeded,
+so `proc_042` is the same effect for everyone, forever. An automated quality
+check weeds out the duds, and 47 hand-picked ones live in the Gallery.
+
+Then there are your own. The Studio remixes any generated effect or starts
+from scratch, with a live preview and undo, and saves small JSON files you
+can share.
+
+You also get:
+
+- **26 colour themes**: originals like Matrix, Inferno and Vaporwave, takes on
+  popular editor schemes (Dracula, Nord, Gruvbox, Catppuccin, Tokyo Night), an
+  animated rainbow, and Strobe if you opt in (it's off by default for
+  photosensitivity reasons)
+- filters that work on anything: CRT scanlines, glitch, rainbow recolour
+- looks, which save an effect with its theme, speed and filters so you can
+  recall it with one key (a dozen come built in)
+
+![The theme menu, with a colour swatch for each theme](https://raw.githubusercontent.com/ethanlabs101/StaticFX/main/assets/themes.png)
+
+![The effect browser](https://raw.githubusercontent.com/ethanlabs101/StaticFX/main/assets/browser.png)
+
+## Make your own
+
+Press `n` for a new effect, or highlight a generated one in the browser and
+press `e` to remix it. Arrow keys change things; `s` saves it to
+**My Effects**.
+
+![The Effect Studio](https://raw.githubusercontent.com/ethanlabs101/StaticFX/main/assets/studio.png)
+
+See [docs/STUDIO.md](https://github.com/ethanlabs101/StaticFX/blob/main/docs/STUDIO.md) for what every control does, and
+[docs/EFFECT_FORMAT.md](https://github.com/ethanlabs101/StaticFX/blob/main/docs/EFFECT_FORMAT.md) for the file format if you'd
+rather write recipes by hand.
+
+## Command line
+
+```bash
+staticfx -e plasma -t ocean           # start on an effect and theme
+staticfx --look "Synthwave"           # start from a look
+staticfx --auto 30 --duration 600     # screensaver: new effect every 30s, quit after 10 min
+staticfx list fire                    # search effects
+staticfx render galaxy --size 80x24   # print one frame (add --ansi for colour)
+staticfx fetch                        # fastfetch/neofetch output over an effect
+staticfx new "Night Drive"            # create a random effect in My Effects
+staticfx export my_night_drive nd.sfx # share it
+staticfx doctor                       # check your setup
+```
+
+`staticfx --help` and `staticfx COMMAND --help` list everything.
+
+## Docs
+
+- [Usage](https://github.com/ethanlabs101/StaticFX/blob/main/docs/USAGE.md): every key, the browser, themes, looks, settings,
+  command line, troubleshooting
+- [The Studio](https://github.com/ethanlabs101/StaticFX/blob/main/docs/STUDIO.md)
+- [Effect file format](https://github.com/ethanlabs101/StaticFX/blob/main/docs/EFFECT_FORMAT.md)
+- [Writing a built-in effect](https://github.com/ethanlabs101/StaticFX/blob/main/docs/WRITING_EFFECTS.md) in Python
+- [Architecture](https://github.com/ethanlabs101/StaticFX/blob/main/docs/ARCHITECTURE.md): how it fits together, and why
+- [Releasing](https://github.com/ethanlabs101/StaticFX/blob/main/docs/RELEASING.md): publishing a new version to PyPI
+
+## Development
+
+```bash
+git clone https://github.com/ethanlabs101/StaticFX && cd StaticFX
+python3 -m pip install -e '.[dev]'
+python3 -m pytest          # ~650 tests, about a minute
+ruff check . && ruff format --check . && mypy
+```
+
+See [CONTRIBUTING.md](https://github.com/ethanlabs101/StaticFX/blob/main/CONTRIBUTING.md) for how changes are made and checked.
+
+## License
+
+[MIT](https://github.com/ethanlabs101/StaticFX/blob/main/LICENSE)

staticfx-2.0.0.dist-info/RECORD

@@ -0,0 +1,65 @@
+staticfx/__init__.py,sha256=DnAGcBnhL9HrQmAeCHtcVCr0t4cOgSIDuhdjswkCNvo,81
+staticfx/__main__.py,sha256=isRRgHGKuZ11h1lVDzQ1zcUdvAQx5x-gW6I4GjR5x_U,87
+staticfx/integrations.py,sha256=ktqsRcFA8z2k7ycGFlyf1jBk9h0nzdWwHpjIkhBbh94,1841
+staticfx/postfx.py,sha256=ZSZCMNwWmWeGRPococLcC3-6MKdtt8nF5sipMsNKC0I,2694
+staticfx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+staticfx/themes.py,sha256=OwlOBtEc14cT-l9QNZwrE9yhA0FgzZmdeUnbFk1CbKI,6090
+staticfx/app/__init__.py,sha256=YKVxh9MNdco0BTPt_hIzWNrMLFw4O1lmlAOdtgg-XYs,72
+staticfx/app/app.py,sha256=XVljA-0l0uQcn1s418pvYFJQRFFHPcrz4j0XiEyFUp4,13842
+staticfx/app/keymap.py,sha256=CqW3N-k4VQniHTEvp6lhwT4mQ4Ln7u-BNLstqyfhIAU,5597
+staticfx/app/player.py,sha256=PMvWOjJB_p2xi61wrf3ASdObDkdXynV6CBX_y_7kXAA,4855
+staticfx/app/session.py,sha256=8BSFZQIYd8Npzn4RESJ_ogFgzRhGIzn10Hz95PgxaDE,3434
+staticfx/cli/__init__.py,sha256=_j7ZaKLmY09p4M8afhKvjSYlzDbhnmNqiJtH_SEZheI,762
+staticfx/cli/commands.py,sha256=-8UNPEgFAXZ__qLNuAH4SoszXysrD_YFkakAWnvgads,10906
+staticfx/cli/parser.py,sha256=XWSHwlUazKHCAOI5p30D1_l8bdwLLstN62CmVcAH5JA,7384
+staticfx/core/__init__.py,sha256=kQ-pqiwiad60yWPN7aBJFasOzh6gZCM5wkeA-JG5MFE,88
+staticfx/core/clock.py,sha256=YqAn7k00477lPGNMxUXYtv2dx5KBkfbD-ZjS2ljjDWs,935
+staticfx/core/color.py,sha256=6WLIM8Ntm47vnNJPJXiOPYGcmOh5e2Am9r8IpbLmmc4,2728
+staticfx/core/frame.py,sha256=jSif8Ytzn6qcezYDOdkp-f6E6ujyuk2DmHIlaIPIVmw,3111
+staticfx/core/glyphs.py,sha256=HK_4Y7ui82_Q_-KUBqUcrnGmcUwHOnMzZibUdcUxx_s,454
+staticfx/core/keys.py,sha256=pwSZXd0YHXx9kTlJQgonr7noMVv0zKRqA-2dfAekJcw,3665
+staticfx/core/renderer.py,sha256=fyxO9RPh8124VGGkC2065OMp4OJCWt-gBIY3xYgLaWU,2860
+staticfx/core/terminal.py,sha256=04R_52vJYAC5t5Z-UiWpBtF-OSTUw7bdKVrQjzpSAvQ,4971
+staticfx/effects/__init__.py,sha256=_B-hP_7N7oujMGYWQ4sfNeTDPIvHDHxJ9VwfV-nX0B0,99
+staticfx/effects/base.py,sha256=F_jts7xCH-YR3dT4qoNu1XQSmQ7ualR0zEO0ZEJlj9g,2874
+staticfx/effects/curated.py,sha256=S3_qHuXncPR5zPTH5QzHtFJMGO4jNrFrY-nu1emGbyo,732
+staticfx/effects/registry.py,sha256=4Jandvv_jY70cL-265KFEKw7NLvLDO9onmFATdoHjIg,3764
+staticfx/effects/spec.py,sha256=Oar1GgpSqyhpaPMlpmJjJYk5M9w09hKwsdPKTR6U3DQ,1567
+staticfx/effects/builtin/__init__.py,sha256=8gj8W3F7XxILGUE7Q_aPnq-Drsp38LDr-n_4ZXxXGPQ,7437
+staticfx/effects/builtin/fields.py,sha256=mWd2nwMnSdwCUE0Z7m27xK2tAWHJAYm8QzpA5FLVt2w,11210
+staticfx/effects/builtin/geometry.py,sha256=mADj9Y6KHHuhVd0XBiPC0sokShCgl2TWAabb7T1eFNY,2159
+staticfx/effects/builtin/particles.py,sha256=9AsN6X8S0ZGBYFc4Kvw7tYZow9_QFYywmZheDx64CUg,20832
+staticfx/effects/builtin/shapes.py,sha256=_jwgyNH8x8wWkQBDUDb4umDjlUWb1NcUHXngva0tsw0,8285
+staticfx/effects/builtin/signals.py,sha256=74WbInLkuvQK3fl1pi_b45N6-So3PDwjWdRfrebN5fA,9756
+staticfx/effects/builtin/simulations.py,sha256=TIVIbWNI14MbjpoTqan9OYTmlhm9QSlaKhWN3y51nkQ,12773
+staticfx/effects/builtin/terminal.py,sha256=-8fDZdTcNmvGDxqZcg9XVdrjFip2OiOBElYl6nbG7rU,11489
+staticfx/effects/engine/__init__.py,sha256=HRVpMrbfe2gyDUZv2B7eKiKqJ8KuktvJvd_gD6eF6nU,460
+staticfx/effects/engine/effect.py,sha256=85wOPb18FMs-2Shpbml2B8pDLfIsuMWMic4y0wpOD9M,10739
+staticfx/effects/engine/filters.py,sha256=XIhr-ZE2Nshi3qmrNg2FALGB5fCgT872NZ_Zfr_GdZc,3121
+staticfx/effects/engine/generate.py,sha256=x_R_dnLLeAU6My6vdjOXuwgWdOTDo5W1Slauz3rCUdA,7717
+staticfx/effects/engine/layers.py,sha256=ooyx6yZ99RncL2ipYCba5hBaIhVFKKi3MfdugXD2h0w,11745
+staticfx/effects/engine/recipe.py,sha256=ONmfLBUAK3mGK22yqb3szLpgqwgdUEOZC_fShgPgCAM,8099
+staticfx/effects/engine/schema.py,sha256=5R9VuXABTGKvNMjTxJLpdEKdaNB_19MmTwxnf90hrNA,2958
+staticfx/effects/engine/warps.py,sha256=ax3qKnaNHEmEmvXZ_5NbgUeZTlHN_-2fh0Lf3mx2eng,5641
+staticfx/library/__init__.py,sha256=XXGCmtpjGRcpC51AHP6YGDtpmWusykgCQmQJ7q8cAFM,78
+staticfx/library/config.py,sha256=xqY1OtH2B30K8mYBKOtqA_o_MeSocb--wPEJhFFKID4,4652
+staticfx/library/effects.py,sha256=8gWcC4wlwqU9mb7VWmYzsAAzTPkoy-xt70LEhgNZ4Ck,5613
+staticfx/library/files.py,sha256=ZdeJER1B72Hx0fFi4l4l-WIAPwDUxKBLgYHX98GNub4,1391
+staticfx/library/legacy.py,sha256=zNEgDQ4VNgkovhGE1cE3S3Be42Ua0syjhsJA0h5AzDU,6816
+staticfx/library/looks.py,sha256=x84hqsn4MDjzmASqFU-FU0h4R0ON65wS1lQcUjCDVRw,4900
+staticfx/ui/__init__.py,sha256=F7o2USAC2VvSBWXiQv3GIEFoaA65xG5VBvJKIXJ60no,53
+staticfx/ui/browser.py,sha256=0PXXMU7jAS-C8x80PORmgdMB2jHs_edXBrNkDrQeSfw,10743
+staticfx/ui/dialogs.py,sha256=qU1FQdTCogOkDlkbtZAgDn7tZhdLsy1SnBJIrMhnU6c,3398
+staticfx/ui/help.py,sha256=7UVrcnUnDgE47Ynxi158Yw5xZj-DTXdIB6SiGuMkG1M,3814
+staticfx/ui/pickers.py,sha256=bLbF-QCJLT6PMcxnrXgeIhtu4-WCE05NC0ry67K2zzQ,7916
+staticfx/ui/play.py,sha256=6pfJgWSzfwqinNgDyEGAAE-jjgqzJWjfOPvaer5nKmU,8217
+staticfx/ui/screen.py,sha256=_tUioMHgj_FPH_iP8uDaUoc9lmr6gZ-B7zJv6KL8jOg,1096
+staticfx/ui/settings.py,sha256=s_T5UrEDyR5e_luDYtEkJBd956OleEg1cXlG0-ptcH4,9718
+staticfx/ui/studio.py,sha256=4VrDfRBVT04NH-CvZW1pegULNkcnEJCw4OvIOANMi6o,16931
+staticfx/ui/widgets.py,sha256=7kKfpFm7KUJbt0Z5MFmuUlFM_OAmEYxAR8QXD-AzBcg,6556
+staticfx-2.0.0.dist-info/licenses/LICENSE,sha256=nIS6IYmFH0orB9uhSFtIoQOS5p09AEizdUNUQ2goHZs,1070
+staticfx-2.0.0.dist-info/METADATA,sha256=1TkjqRuMAhAYqFu9RU6dradh58fbHuMLti3rhHLXj6U,6813
+staticfx-2.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+staticfx-2.0.0.dist-info/entry_points.txt,sha256=pFdULorGKcnfwBINsBYjHEIBLt9ZDqwGy7dwBowzbEA,47
+staticfx-2.0.0.dist-info/top_level.txt,sha256=X9HuiGwaW6CNT1oUtZZgXZIjRbvuAlkxLDC_hbYk4uM,9
+staticfx-2.0.0.dist-info/RECORD,,

staticfx-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

staticfx-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+staticfx = staticfx.cli:main

staticfx-2.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ethangrames04
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

staticfx-2.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+staticfx