HowTo:Install POV

From POV-Wiki
Revision as of 03:42, 11 April 2021 by WikiSysop (talk | contribs) (Minor tweaks, syntax highlighting seems to work without changes.)
Jump to navigation Jump to search



Binaries are compiled for every new version of POV-Ray and are available on the POV-Ray website.

Running the setup.exe installer with standard options is enough to set POV-Ray up and in working order, though we do recommend also downloading the editor DLL's when prompted by the installer, as without the editor you will need to use another program to edit .POV source files.


  • Download the source from GitHub.
  • On older Linux distributions you may have to query-replace march=native to march=corei7 in the configure file (tested with Ubuntu 12.04 LTS 64-bit, gcc 4.6.3, and i7-4770K processor).
  • Navigate from a terminal into the folder where you uncompressed it and type:
./configure COMPILED_BY="your name <email@address>"

if you get an error, whatever will follow the "configure: error: " is the names of missing libraries on your system, it could be boost, libpng, or anything... Go to your package manager such as Synaptic or whatever, and install each of them preferably the specific version which is asked for. At the end of the configure command, this should be written:

Unix man page:/usr/local/share/man
  • then type:
make install

That's all, you should then have POV-Ray 3.7 installed.

[/content/User:Le_Forgeron/vault/Compilation Here] is a page with more options for compiling.


Below is the recipe used to compile POV-Ray for Slackware:

cd /media/space/software/Source/povray/povray-3.7.0/povray
git config core.sparsecheckout true
echo source/ >> .git/info/sparse-checkout
echo unix/ >> .git/info/sparse-checkout
echo vfe/ >> .git/info/sparse-checkout
echo distribution/ >> .git/info/sparse-checkout
echo doc/ >> .git/info/sparse-checkout
git remote add -f origin
git pull origin master

# * [new branch]      3.7-stable -> origin/3.7-stable
# * [new branch]      master     -> origin/master
# * [new tag]         v3.7.0.0   -> v3.7.0.0

#Backup /media/space/software/Source/povray/povray-3.7.0/povray to

cd unix/
cd ../
../configure COMPILED_BY="your name" --with-boost-thread=boost_thread
#POV-Ray 3.7.0 has been configured.

#Built-in features:
#  I/O restrictions:          enabled
#  X Window display:          enabled (using SDL)
#  Supported image formats:   gif tga iff ppm pgm hdr png jpeg tiff openexr
#  Unsupported image formats: -

#Compilation settings:
#  Build architecture:  x86_64-unknown-linux-gnu
#  Built/Optimized for: x86_64-unknown-linux-gnu (using -march=native)
#  Compiler vendor:     gnu
#  Compiler version:    g++ 4.7.1
#  Compiler flags:      -pipe -Wno-multichar -Wno-write-strings
-fno-enforce-eh-specs -s -O3 -ffast-math -march=native -pthread

#Type 'make check' to build the program and run a test render.
#Type 'make install' to install POV-Ray on your system.

#The POV-Ray components will be installed in the following directories:
#  Program (executable):       /usr/local/bin
#  System configuration files: /usr/local/etc/povray/3.7
#  User configuration files:   /home/dad/.povray/3.7
#  Standard include files:     /usr/local/share/povray-3.7/include
#  Standard INI files:         /usr/local/share/povray-3.7/ini
#  Standard demo scene files:  /usr/local/share/povray-3.7/scenes
#  Documentation (text, HTML): /usr/local/share/doc/povray-3.7
#  Unix man page:              /usr/local/share/man

make -j2
make check #the biscuit + coffee render fine
#As root
checkinstall # this does "make install" and also creates a Slackware package
#Edit 3 - Version to be 3.7.0
#This package will be built according to these values:

#1 -  Summary: [ povray ]
#2 -  Name:    [ povray ]
#3 -  Version: [ 3.7.0 ]
#4 -  Release: [ 1 ]
#5 -  License: [ GPL ]
#6 -  Group:   [ Applications/System ]
#7 -  Architecture: [ x86_64 ]
#8 -  Source location: [ povray ]
#9 -  Alternate source location: [  ]

Below is what was tried and finally used (# is a comment sign) compile some unofficial and official POV-Ray 3.8 for Termux on an armv7 achitecture, (32bits) of the Samsung Galaxy note 3 (both N900A and N9005, respectively with android 5 and 10): Android versions below 7 do not have X11 repo available and therefore no libxpm. Using --without-x is thus necessary for these versions ...But more recent terminals using android v 7 and above are welcome to remove and test for some way to have the X/sdl based preview working...!

#pkg install x11-repo #no more needed --without-x, theoretically the below libxpm neither
pkg upgrade
pkg install -y libllvm clang autoconf automake boost imagemagick git pkg-config #libxpm #sdl
git clone 

or to use HGPovray branch, replace the last line with:

git clone

then, get into the directory

cd /data/data/com.termux/files/home/povray/unix/
cd ../
#--disable-shared creates a portable app with included libraries
#--without-openexr is advised to create non-redistributable only, 
# so we still need to find a Termux package with this library.
# also add -libsdl to LIBS flag when testing for the preview display... 
# remove --without-x in case the above works
./configure COMPILED_BY="your name <email@address>" --without-x --disable-io-restrictions LIBS="-lboost_system -lboost_thread" CXX=clang++ CC=clang CFLAGS="-mcpu=native" CXXFLAGS="-mcpu=native"#--disable-shared for portable version

then (the"check" is optional):

make check 

the biscuit + coffee render fine.

When trying

make install

something's wrong with permissions so more work is required.

(DON'T FORGET TO REPLACE your name <email@address> WITH YOUR NAME AND EMAIL) Termux does not follow Filesystem Hierarchy Standard unlike majority of Linux distributions. You cannot find directories like /bin, /etc, /usr, /tmp and others at usual location. Thus, all programs should be patched and recompiled to meet requirements of the Termux environment otherwise they will not be able to find their configuration files or other data. In the case of POV, This limitation is not a show stopper, since command line accepts all the needed arguments. But please do share if you know what (probably small) modification would allow the "make install" to work. Meanwhile a command to launch a render from povray folder working directory looks like this, outputting image to (dcim) camera gallery:

./unix/povray +I./distribution/scenes/advanced/grenadine/grenadine.pov +W1080 +H1920 +Fj +L./include +L./distribution/scenes/advanced/grenadine +O$HOME/storage/dcim/grenadine

Mac OS/X

You can download some Mac builds of POV-Ray here:

Intel-based computers with system 10.6.8 and later (included 10.9) are supported.