To use the UFRaw Gimp plug-in you need first to install Gimp 2.0 or higher. Gimp 2.4 is recommended. If you only plan to use UFRaw's stand-alone tool, there is no need to install Gimp, but the Gimp Tool Kit (GTK+2) is still needed. There is no need to install DCRaw itself since its code is incorporated into UFRaw.
There are UFRaw packages for several distributions:
It sometimes takes time until these packages are updated. If you want the latest and greatest version of UFRaw you'll might have to build it yourself.
To build UFRaw yourself you can either read the detailed instructions below or just download it and get the shorter version in the README file.
I'm using Debian GNU/Linux on a Pentium machine, but UFRaw can be built on different Unix flavors and many different architectures. Let me know if your system is not supported for some reason.
The following development packages are relevant for building UFRaw:
- The Gimp Tool Kit, GTK+2 (libgtk2.0>=2.6).
- For color management you need Little CMS (liblcms>=1.13).
- To build the Gimp plug-in you need Gimp (gimp>=2.0).
- To build the Cinepaint plug-in you need Cinepaint (cinepaint>=0.22).
- libtiff is required to create TIFF images.
- libjpeg is required to create JPEG images.
- libpng is required to create PNG images.
- libcfitsio3 is required to create FITS images.
- Exiv2 is required for EXIF support (does not support all camera models) (libexiv2>=0.11).
- To read gzipped raw files you need zlib.
- To read bzipped raw files you need libbz2.
- To be able to scroll the preview window you need GtkImageView (libgtkimageview>=1.3).
- lensfun is required to apply lens correction. This option is experimental.
./configure --with-lensfun. Read this before using it.
Only gtk+2.0 and liblcms are required. The others are optional, their relevant features will be enabled if they are found during configuration. In Debian you can get these packages with the command (requires root privelege):
apt-get install libgtk2.0-dev liblcms-dev libgimp2.0-dev
libtiff-dev libjpeg62-dev libpng12-dev libexiv2-dev zlib1g-dev
The libgtkimageview-dev package only exists in Debian testing and unstable. For cinepaint 0.22 there is no Debian package at the moment.
Now, you can download the UFRaw tarball
extract the files from it and enter the
tar xzf ufraw-0.21.tar.gz cd ufraw-0.21
Next, you should run the configuration script:
You will get a long output and at the end there will be a summary that should look approximately like:
configure: ====================== summary ===================== configure: build GIMP plug-in: yes configure: build CinePaint plug-in: yes configure: EXIF support using exiv2: yes configure: JPEG support: yes configure: PNG support: yes configure: FITS support: no configure: TIFF support: yes configure: gzip compressed raw support: yes configure: bzip2 compressed raw support: yes configure: Scrolling in preview using GtkImageView: yes configure: Lens defects correction via lensfun: no
There are also UFRaw specific flags for
--enable-mime - install mime files, see README for more information
--enable-extras - build extra (dcraw, nikon-curve) executables
--enable-dst-correction - enable DST correction for file timestamps.
--enable-contrast - enable the contrast setting option.
--enable-interp-none: enable 'None' interpolation (mostly for debugging).
--with-lensfun: use the lensfun library - experimental feature, read this before using it.
--with-prefix=PREFIX - use also PREFIX as an input prefix for the build
--with-dosprefix=PREFIX - PREFIX in the the prefix in dos format (needed only for ms-windows)
Next, you should build UFRaw by typing the command:
For installing the UFRaw Gimp plug-in, you have two options. You can install it only for the current user, which does not require root privileges, but only the current user will see the plug-in
gimp-tool --install-bin ufraw-gimp
or you can make a system wide installation (requires root privileges)
This will also install the stand-alone tools
and some related files (man page, icon and desktop definitions).
If you use the GIMP on OS X application bundle, then the UFRaw plug-in is already bundled with Gimp. As far as I know the stand-alone version of UFRaw is not included.
Another option is the point & click installer for the UFRaw-0.9.1 GIMP plug-in. It was designed for the GimpShop, but might also work with the standard Gimp.
A more recent option is this native Mac OS X version of UFRaw
Mac OS X is in principle just another Unix flavor based on FreeBSD. I have no experience working with the Mac, but I was reported that UFRaw can be built on the Mac OS X using the Fink package manager. Just follow the Unix instruction where your configuration command should look like
./configure --prefix=/sw --with-prefix=/sw
For MS-Windows users I have two installation versions. The "for dummies" version where you only need to download and run an installer and the "for geeks" version if you want to build the plug-in yourself.
I'm not a big fan of this operating system, so why does it get such special attention? UFRaw is a free software (as in free speech, not as in free beer). In this spirit I try to give the users the freedom to use it in any environment, even in environments like MS-Windows that try to take your freedom away by imposing proprietary standards on you. You are encouraged to use other free software like Gimp for editing your images, Firefox for surfing the net (in fact Firefox renders this page better), and LibreOffice for an office suite.
Another reason is that building UFRaw on MS-Windows is a bit tricky and not very convenient (did I say already that I don't like this operating system). I actually create the MS version of UFRaw in a Linux environment, but I guess that most of the users of the MS version don't have access to Linux, otherwise they would not need the MS version.
MS-Windows for dummies
UFRaw is now a stand-alone application (it used to depend on Gimp). You just need to download and run this.
The upside of UFRaw being a stand-alnoe installation is that it should work more reliably, without the DLL issues that many users had.
One downside is that the installer is much bigger (9MB) and requires much more disk space (53MB).
Another downside is that there is no GIMP plug-in. You only get a the stand-alone version of UFRaw. A plug-in executable (ufraw-gimp.exe) is included, but it does not function. It will not work with GIMP-2.8. There might be a way to get it to work with GIMP-2.6, but I did not try.
MS-Windows for geeks
I build UFRaw using a cross-compiler in Linux. It is also be possible to build UFRaw in the Cygwin environment, which imitates the Unix environment on MS-Windows. After setting up the environment and installing all the required packages the installation procedure is the same as for Unix. If you want to compile UFRaw in another environment or with a different compiler then you are on your own.
I use the Debian package mingw32 for cross compiling.
For the MSYS environment you should install the packages msys, mingw-runtime, w32api, binutils and gcc from the MinGW site.
can be installed by downloading and running the installation program
In addition to the default packages installed, you will also need the
following packages, which you can find in the
category in the setup:
- gcc: C compiler
- make: The GNU version of the 'make' utility
- pkgconfig: A utility used to retrieve information about installed libraries
You can build a native Cygwin binary of UFRaw using the developement packages from Cygwin ports, or you can use Cygwin to cross build a MinGW32 binary.
You will need the following development packages:
- gimp-dev (at least version 2.2)
- gtk+-dev (at least version 2.6)
- liblcms (at least version 1.13)
- exiv2 (at list version 0.11)
- gtkimageview (at list version 1.3)
Extract all these files under one directory,
In Linux I use the directory
Notice that all these libraries are
not for Cygwin but for MinGW32. This
is because they are used to cross build UFRaw on MinGW32.
pkg-config behaves differently under MinGW32.
Therefore, if you are cross compling, you will have to modify all the
*.pc files that come with the different packages. The following script should
do the trick (after updating TARGET to your needs):
TARGET=/opt/mingw32 for f in $TARGET/lib/pkgconfig/*.pc ; do cat $f | sed s+^prefix=.*+prefix=$TARGET+ > $f.tmp mv $f.tmp $f done
At this point you should start following the installation instructions for Unix users. In Debian you will need the following configuration command:
./configure --with-prefix=/opt/mingw32 --with-dosprefix=z:\\opt\\mingw32
--host=i586-mingw32msvc --target=i586-mingw32msvc --build=i386-linux
In Cygwin you will need the following configuration command:
./configure -with-prefix=/cygdrive/c/mingw32 --with-dosprefix=c:\\mingw32
--host=i686-mingw32msvc --target=i686-mingw32msvc --build=i686-cygwin
The window installer is created using
therefore if you want to create a UFRaw-installer
you should install Inno Setup first.
If you are cross-compiling ufraw on linux, you will need
This will allow you to
make windows-installer or to