README.md
1PhotoFlow [](https://travis-ci.org/aferrero2707/PhotoFlow)
2=========
3
4The aim of the project is to provide a fully non-destructive photo retouching program with a complete workflow including RAW image development.
5
6Here is the general feature (wish)list:
7
8- Fully non-destructive, layer-based photo editing workflow with realtime preview of the final image
9- Support for 8-bits and 16-bits integer as well as 32-bits and 64-bits floating point precision, selectable at runtime and on a per-image basis
10- Allows to load and edit images of arbitrary size, thanks to the underlying rendering engine based on the VIPS library
11- Fully color managed workflow: user-defined input, work and output profiles, soft-proofing, etc...
12- Support for layer grouping and layer masks
13- Support for common photo editing tools: levels, curves, brightness-contrast control, blurring, sharpening, cropping, resizing, colorspace conversions, etc..., all implemented in the form of image layers
14
15You can follow the development of photoflow and learn about its usage in the dedicated blog: http://photoflowblog.blogspot.fr/
16
17# Windows and OSX installers
18
19Up-to-date Windows and OSX installers are available from the [releases](https://github.com/aferrero2707/PhotoFlow/releases) web page.
20
21# Installing from PPA (Ubuntu Linux and derivate distributions)
22
23There are up-to-date packages available for Ubuntu 14.04/14.10 and Mint 17/17.1 in two diferent PPAs:
24
25- *Highly Explosive* PPA:
26
27To add the PPA and install photoflow, do the following:
28
29 sudo add-apt-repository ppa:dhor/myway
30 sudo apt-get update
31 sudo apt-get install photoflow
32
33or to install the daily git builds from the "stable" branch:
34
35 sudo apt-get install photoflow-git
36
37# Arch Linux packages
38
39Pre-compiled packages are available from the [releases](https://github.com/aferrero2707/PhotoFlow/releases) web page. To install a given version, download the photoflow-git-x.x.x-1-x86_64.pkg.tar.xz archive (where `x.x.x` must be replaced with the version to be installed) and then run
40
41 sudo packman -U photoflow-git-x.x.x-1-x86_64.pkg.tar.xz
42
43To compile from sources, download the PKGBUILD file and run this command in the download directory:
44
45 makepkg -i
46
47# Fedora packages
48
49User Oleastre is providing up-to-date VIPS and PhotoFlow packages for Fedora.
50
51To install PhotoFlow, just execute the following commands as root:
52
53 dnf copr enable oleastre/PhotoFlow
54 dnf install photoflow
55
56Additional details can be found here: https://copr.fedoraproject.org/coprs/oleastre/PhotoFlow/
57
58# Downloading and compiling
59
60Photoflow can be compiled under both gtk 2.x and gtk 3.x.
61
62The pixel rendering engine of PhotoFlow is based on VIPS (http://www.vips.ecs.soton.ac.uk). You have to install a recent version of VIPS in order to compile PhotoFlow.
63
64Once VIPS is set up and running, follow these steps to download and compile PhotoFlow:
65
661. get master branch from GitHub:
67
68 $ git clone https://github.com/aferrero2707/PhotoFlow.git
69
702. The build system is based on CMake, so you have to have it installed in your system.
71 You need the following dependencies to build Photoflow: gettext, glib-2.x, libxml-2.0, pkg-config, swig, gtk-doc-tools, automake, gobject-introspection, gnu make, cmake, libtiff, libjpeg, libfftw3, exiv2, lensfun and gtkmm-2.x or gtkmm-3.x.
72 PhotoFlow provides an helper script to simplify the building process;
73 in order to use it you have to go into the "build" subdirectory and run the "build.sh" script:
74
75 $ cd PhotoFlow/build
76 $ bash ./build.sh
77
78 If you have installed VIPS in an unusual place, you can edit the build script and set the PKG_CONFIG_PATH variable accordingly
79
80 To compile the code in debug mode, use
81
82 $ bash ./build.sh debug
83
84 instead.
85
86 If you do not already have a very recent version of VIPS installed in your system, a second helper script is provided
87 which will download, configure and compile libvips for you, and link it against photoflow:
88
89 $ cd PhotoFlow/build
90 $ bash ./build_all.sh
91
92
933. If all goes well, you can now open an image file with PhotoFlow:
94
95 $ ./Release/bin/photoflow image_file_name
96
97
98# Current status
99
100PhotoFlow is in a early development stage. The present version allows to open an image file and apply basic editing filters via non-destructive adjustment layers. The individual layers can be activated and de-activated using the radio buttons on the right of the image. Moreover, the layers structure can be saved to disk and re-opened again via the command line.
101Loading and processing of RAW images (demosaicing, white balance, exposure adjustment, etc.) is now available, at least at a basic level.
102
){kind=link}