The mandulia package

[Tags: gpl, program]

Mandulia provides a zooming visualisation of the Mandelbrot Set as many Julia Sets. Featuring a profiled and optimized renderer, and a Lua configuration and scripting interface.

Mandulia supports additional compile-time flags for speed, but by default these are disabled because they don't work on all systems. These flags are -ffast for miscellaneous optimizations, and -ffast -fSSE4 to use SSE4 instructions too.

Changes from mandulia-0.6: the optimization flags are disabled by default as they were causing problems on some systems; reduced visual jitter for smoother animation; smoother colour gradations; access runtime statistics from Lua scripts.

[Skip to ReadMe]


Versions0.4, 0.5, 0.6, 0.7
Change logChangeLog
Dependenciesarray, base (==4.*), bytestring, containers, directory, filepath, GLUT (>=2.2), hslua (>=0.2), time [details]
Copyright(C) 2010 Claude Heiland-Allen <>
AuthorClaude Heiland-Allen
Home page
Source repositoryhead: git clone git://
this: git clone git:// v0.7)
UploadedSat Aug 14 17:14:16 UTC 2010 by ClaudeHeilandAllen
Downloads670 total (31 in last 30 days)
0 []
StatusDocs not available [build log]
All reported builds failed as of 2015-09-29 [all 5 reports]


fastEnable optimizations that might break some compilers.DisabledAutomatic
sse4Enable optimizations for SSE4 CPUs.DisabledAutomatic

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Maintainers' corner

For package maintainers and hackage trustees

Readme for mandulia-0.7


Mandelbrot/Julia set explorer.


Multi-core CPU with lots of RAM recommended:

    mandulia configuration

Currently there is one preset configurations available:
'main' -- keyboard navigation with randomized attract mode.

To render videos (see below):

    mandulia configuration |
    ppmtoy4m -S444 -F25:1 |
    ffmpeg2theora -v 8 -f yuv4mpegpipe -o mandulia.ogv -


'main' defines the following key bindings:

Escape   -- quit
F11      -- toggle full screen
a        -- enter attract mode immediately
r        -- record for 10 minutes (assuming 25fps)
s        -- record for 1 frame (aka screenshot)

Note that recording is via PPM images on 'stdout', so to avoid flooding
your terminal with binary data be sure to redirect it somewhere else.

As a side-effect, the following count as 'activity':

PageUp   -- zoom in
PageDown -- zoom out
cursors  -- move around
End      -- stop moving
Home     -- return to base
[ ]      -- change speed
#        -- reset speed
{ }      -- change weight
~        -- reset weight

Attract mode is entered after 1 minute (assuming 25fps) of inactivity,
and left on any activity.

Other configurations may differ, check their sources for details.


Mandulia can be reconfigured without recompilation, using Lua scripts.
The first (non RTS) argument to 'mandulia' will be executed on startup.
First it will try to load it as a file, then via Lua's 'require()'.
See 'defaults.lua' to see the available interface, and 'main.lua' for an
example of keyboard navigation.  Note that some variables only take
effect on startup, and later modification will be ignored.