README.md 3.01 KB
Newer Older
1
[![icon](/data/pixmaps/idbutton.png?raw=true)](https://www.darktable.org/) darktable [![build status](https://travis-ci.org/darktable-org/darktable.svg?branch=master)](https://travis-ci.org/darktable-org/darktable) [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/470/badge)](https://bestpractices.coreinfrastructure.org/projects/470)
Jesper Pedersen's avatar
Jesper Pedersen committed
2 3
=========

4
darktable is an open source photography workflow application and raw developer. A virtual lighttable and darkroom for photographers. It manages your digital negatives in a database, lets you view them through a zoomable lighttable and enables you to develop raw images and enhance them.
Jesper Pedersen's avatar
Jesper Pedersen committed
5

6
[https://www.darktable.org/](https://www.darktable.org/ "darktable homepage")
Jesper Pedersen's avatar
Jesper Pedersen committed
7

8 9 10 11 12
Contributing
------------

* Write a blog about darktable
* Create a tutorial for darktable
13 14 15 16 17 18
* Help expand the [user wiki](https://www.darktable.org/redmine/projects/users/wiki)
* Answer questions on the [user mailing list](https://www.mail-archive.com/darktable-user@lists.darktable.org/)
* Share your ideas on the [developer mailing list](https://www.mail-archive.com/darktable-dev@lists.darktable.org/)
* Test [releases](https://www.darktable.org/install/)
* Review [pull requests](https://github.com/darktable-org/darktable/pulls)
* Start [hacking on darktable](https://www.darktable.org/redmine/projects/darktable/wiki/Contributing_code)
19

Jesper Pedersen's avatar
Jesper Pedersen committed
20 21 22
Building
--------

23 24 25
Note that [rawspeed](https://github.com/darktable-org/rawspeed) is tracked via a git submodule, so after checking-out the darktable, you need to update/checkout rawspeed,

```bash
26
git submodule init
27 28 29
git submodule update
```

30
### Easy way
Jesper Pedersen's avatar
Jesper Pedersen committed
31

32
```bash
33
./build.sh --prefix /opt/darktable --build-type Release
34
```
Jesper Pedersen's avatar
Jesper Pedersen committed
35

36
### Manual way
Jesper Pedersen's avatar
Jesper Pedersen committed
37

38
```bash
39 40 41 42 43
mkdir build/
cd build/
cmake -DCMAKE_INSTALL_PREFIX=/opt/darktable/ ..
make
sudo make install
44
```
Jesper Pedersen's avatar
Jesper Pedersen committed
45

46 47
### Further reading

48
There is a [comprehensive list](https://redmine.darktable.org/projects/darktable/wiki/Building_darktable_20) of build instructions for all the widely used Linux distributions.
49

Jesper Pedersen's avatar
Jesper Pedersen committed
50 51 52 53 54 55

**Tip:** Check that you have the latest [gphoto2 library](http://www.gphoto.org/ "gphoto2 homepage") installed in order to support the newest cameras.

Issue tracking
--------------

56
[https://www.darktable.org/redmine/projects/darktable/issues](https://www.darktable.org/redmine/projects/darktable/issues "darktable issue tracking")
Jesper Pedersen's avatar
Jesper Pedersen committed
57 58 59 60

Wiki
----

61 62
* [User wiki](https://www.darktable.org/redmine/projects/users/wiki "darktable user wiki")
* [Developer wiki](https://www.darktable.org/redmine/projects/darktable/wiki "darktable developer wiki")
Jesper Pedersen's avatar
Jesper Pedersen committed
63 64 65 66 67


Mailing lists
-------------

68 69
* Users [[subscribe](mailto:darktable-user+subscribe@lists.darktable.org) | [archive](https://www.mail-archive.com/darktable-user@lists.darktable.org/)]
* Developer [[subscribe](mailto:darktable-dev+subscribe@lists.darktable.org) | [archive](https://www.mail-archive.com/darktable-dev@lists.darktable.org/)]
70
* CI (read-only, high traffic!) [[subscribe](mailto:darktable-ci+subscribe@lists.darktable.org) | [archive](https://www.mail-archive.com/darktable-ci@lists.darktable.org/)]