Cog is a small single “window” launcher for the WebKit WPE port. It is small, provides no user interface, and is suitable to be used as a Web application container. The “window” may be fullscreen depending on the WPE backend being used.
This project provides the following components:
-
libcogcore
is a library with ready-to-use components typically needed for implementing applications which use the WebKit WPE/GTK+ API. -
cog
is the launcher itself, implemented using thelibcogcore
library. -
cogctl
is a tool which can be used to control acog
instance using the D-Bus session bus.
It is possible to disable building the cog
and cogctl
programs by passing
-DCOG_BUILD_PROGRAMS=OFF
to CMake.
For the master
and cog-0.3
branches:
- WPE WebKit 2.24.x, or WebKitGTK 2.20.x when building with
COG_USE_WEBKITGTK
. - libwpe 1.2.0.
- WPEBackend-fdo 1.2.0. (Optional, but recommended.)
- GLib 2.40 or newer.
For the cog-0.2 branch:
- WPE WebKit 2.22.x, or WebKitGTK+ 2.18.x when building with
COG_USE_WEBKITGTK
. - libwpe 1.0.0.
- WPEBackend-fdo 1.0.0. (Optional, but recommended.)
- GLib 2.40 or newer.
For the cog-0.1 branch:
- WPE WebKit 2.20.x, or WebKitGTK+ 2.18.x when building with
COG_USE_WEBKITGTK
. - WPEBackend 0.2.0.
- GLib 2.40 or newer.
Compiling Cog follows the usual procedure for projects which use
CMake: cmake . && make
should get you started, if your
system has the needed dependencies installed.
Documentation for libcogcore
is currently unavailable, and
contributions in this regard are very welcome.
Bug tracking: If you have found a bug, take a look at out issue tracker. Please see the “reporting bugs” section in the CONTRIBUTING.md file for guidelines on how to provide a good bug report.
For information on how to report bugs, or how to contribute to Cog, please check the CONTRIBUTING.md file.
This project is licensed under the terms of the MIT license. Check the COPYING file for details.