textual-mandelbrot

April 22, 2025 ยท View on GitHub

mandelexp in action mandelexp in action

Introduction

Note

This repository is unlikely to get future updates; I've created a from-scratch reimplementation of the application called Complexitty. I suggest installing and playing with that instead.

This package provides a simple Mandelbrot set widget that can be used in Textual applications, and also provides an application that can be used to explore the classic Mandelbrot set in the terminal.

Installing

pipx

The package can be installed using pipx:

$ pipx install textual-mandelbrot

Homebrew

The package is available via Homebrew. Use the following commands to install:

$ brew tap davep/homebrew
$ brew install textual-mandelbrot

Running

Once installed you should be able to run the command mandelexp and the application will run.

mandelexp in action mandelexp in action

Exploring

If you use mandelexp to run up the display, the following keys are available:

KeysAction
Up, w, kMove up
Shift+Up, W, KMove up slowly
Down, s, jMove down
Shift+Down, S, JMove down slowly
Left, a, hMove left
Shift+Left, A, HMove left slowly
Right, d, lMove right
Shift+Right, D, LMove right slowly
PageUp, ]Zoom in
PageDown, [Zoom out
Ctrl+PageUp, }Zoom in deeper
Ctrl+PageDown, {Zoom out wider
*, Ctrl+UpIncrease "multobrot"
/, Ctrl+DownDecrease "multibrot"
Ctrl+Shift+UpIncrease "multibrot" in smaller steps
Ctrl+Shift+DownDecrease "multibrot" in smaller steps
HomeCenter 0,0 in the display
,Decrease iterations by 10
<Decrease iterations by 100
.Increase iterations by 10
>Increase iterations by 100
Ctrl+rReset to initial state
EscapeQuit the application
1Colour set 1
2Colour set 2
3Colour set 3