https://github.com/zdharma-continuum/zsh-morpho
https://github.com/zdharma-continuum/zsh-morpho
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/zdharma-continuum/zsh-morpho
- Owner: zdharma-continuum
- License: other
- Created: 2021-11-06T11:28:14.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-04-16T04:42:51.000Z (about 2 years ago)
- Last Synced: 2025-01-13T14:19:21.443Z (5 months ago)
- Language: Shell
- Size: 48.8 KB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Introduction
Terminal screen saver for Zshell. Implements morphogenesis and Mandelbrot images. Written in pure Zshell (possible
thanks to floating point numbers and to `zsh/mathfunc` module). Supports running external commands, for example
`cmatrix`.
Screen saver will start after configured time, in last terminal in which a command has been executed.
Video – view on [asciinema](https://asciinema.org/a/47242). You can resize the video by pressing `Ctrl-+` or `Cmd-+`.
[](https://asciinema.org/a/47242)
## Configuration
There are 4 zstyles:
```zsh
zstyle ":morpho" screen-saver "zmorpho" # select screen saver "zmorpho"; available: zmorpho, zmandelbrot, zblank, pmorpho
# this can also be a command, e.g. "cmatrix"
zstyle ":morpho" arguments "-s" # arguments given to screen saver program; -s - every key press ends
zstyle ":morpho" delay "290" # 5 minutes before screen saver starts
zstyle ":morpho" check-interval "60" # check every 1 minute if to run screen saver
```
To test screen savers run them directly from command line, e.g. issue "`pmorpho`".
## Installation
The plugin is "standalone", which means that only sourcing it is needed. So to install, unpack `zsh-morpho` somewhere
and add `source {where-zsh-morpho-is}/zsh-morpho.plugin.zsh` to `zshrc`.
If using a plugin manager, then `Zinit` is recommended, but you can use any other too, and also install with `Oh My Zsh`
(by copying directory to `~/.oh-my-zsh/custom/plugins`).
### [Zinit](https://github.com/zdharma-continuum/zinit)
Add `zinit load zdharma-continuum/zsh-morpho` to `.zshrc`. The plugin will be loaded next time you start `Zsh`. To
update issue `zinit update zdharma-continuum/zsh-morpho` from command line.
### Zgen
Add `zgen load zdharma-continuum/zsh-morpho` to `.zshrc` and issue a `zgen reset` (this assumes that there is a proper
`zgen save` construct in `.zshrc`).
### Antigen
Add `antigen bundle zdharma-continuum/zsh-morpho` to `.zshrc`. There also should be `antigen apply`.
### Oh-My-Zsh
1. `cd ~/.oh-my-zsh/custom/plugins`
1. `git clone https://github.com/zdharma-continuum/zsh-morpho.git`
1. Add `zsh-morpho` to your plugin list