<!--
Since version 2.0.0-beta.1, _cf4ocl_ is also distributed in binary
format (available at the [releases page](https://github.com/FakenMC/cf4ocl/releases)).
This avoids [building cf4ocl from source](Build and install from source).
However, the user still needs to have the _cf4ocl_ dependencies
installed, namely OpenCL and GLib.

The following table describes, for several OSes, the package names or
binary locations of the libraries and tools used for: (a) running
_cf4ocl_ based applications (such as the provided utilities,
[ccl_devinfo](http://fakenmc.github.io/cf4ocl/docs/latest/index.html#ug_devinfo)
and [ccl_kerninfo](http://fakenmc.github.io/cf4ocl/docs/latest/index.html#ug_kerninfo));
and, (b) developing _cf4ocl_ based applications.

| OS/purpose                  | GLib                     | OpenCL |
| --------------------------- | ------------------------ | ------ |
| Debian/Ubuntu (runtime)     | _libglib2.0-0_ package   | [An OpenCL runtime](OpenCL implementations) |
| Debian/Ubuntu (development) | _libglib2.0-dev_ package | _ocl-icd-opencl-dev_ package or [an OpenCL SDK](OpenCL implementations) |
| Fedora/CentOS (runtime)     | _glib2_ package          | [An OpenCL runtime](OpenCL implementations) |
| Fedora/CentOS (development) | _glib2-devel_ package    | _opencl-headers_ and _ocl-icd-devel_ packages or [an OpenCL SDK](OpenCL implementations) |
| OS X (both)                 | _glib_ [homebrew](http://brew.sh/) formula | Included in OS |
| Windows (runtime)           | GLib [32](http://www.gtk.org/download/win32.php) or/and [64](http://www.gtk.org/download/win64.php)-bit runtimes | [An OpenCL runtime](OpenCL implementations) |
| Windows (development)       | GTK+ 3.x [32](http://www.gtk.org/download/win32.php) or/and [64](http://www.gtk.org/download/win64.php)-bit all-in-one bundles | [An OpenCL SDK](OpenCL implementations) |
-->

Experimental binaries are provided for Linux (64 bits), Windows (32/64 bits) and
Mac OS X (64 bits). These should be installed manually, and except for OS X,
require that an ICD (OpenCL.dll/libOpenCL.so) supporting OpenCL >= 2.0 is
previously installed. Windows binaries include a number of third-party DLLs
required to run the utilities (i.e. GLib and friends). On Linux, GLib should be
installed via the package manager. On OS X, GLib should be installed using
[Homebrew](http://brew.sh/) or similar tool.

**New** There is a [Homebrew formula](http://braumeister.org/formula/cf4ocl)
formula for OS X. This is the recommended approach for installing _cf4ocl_ on
OS X. Acknowledgements to [Jan-Gerd Tenberge](https://github.com/janten) for
providing this formula.

In the future, we hope to provide complete binary packages or simpler
installation methods than building or installing from source. More specifically,
we're currently seeking help to:

* Add _cf4ocl_ to [Debian](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=766080),
Fedora and other Linux distributions.
* Provide complete Linux binaries in deb, rpm and other packaging formats.
* ~~Have a [Homebrew](http://brew.sh/) formula for OS X.~~ *DONE*
* Provide a Windows installer containing the required dependencies.

At the moment, the CMake build process can produce Linux DEBs and RPMs, as well
as Windows .EXE installers. However the created packages are not quite perfect,
so they are not yet included in the releases.