WPE Cog Upstream
  • C 95.6%
  • Meson 3.2%
  • Roff 0.6%
  • Shell 0.5%
Find a file
2026-04-03 17:45:30 +02:00
.github CI: Update to latest actions version and base image 2025-02-13 11:28:50 +02:00
core core, wl: Factor out view fullscreening 2024-08-26 16:35:33 +03:00
data meson: Use a generated depfile for gi-docgen 2025-02-13 11:31:19 +02:00
dbus Rename DY_DEFAULT_APPID to COG_DEFAULT_APPID 2018-11-15 00:46:26 +01:00
docs meson: Use a generated depfile for gi-docgen 2025-02-13 11:31:19 +02:00
examples core: Remove view and viewport handling from CogShell 2024-01-03 22:43:09 +02:00
hooks Added precommit hook that checks the formatting style, making sure it conforms to clang-format (#340) 2021-08-09 15:55:48 +01:00
launcher cog-launcher: fix system dbus appid connection 2025-06-23 16:43:06 +03:00
platform feat: add surface layer v1 2026-04-03 17:45:30 +02:00
subprojects meson: Add a Wrap subproject for xcb-keysyms 2023-11-30 21:18:00 +02:00
.check-style-ignore check-style: Ignore sources imported from elsewhere 2023-10-23 15:59:04 +03:00
.clang-format CI: Switch to clang-format version 13 2021-11-08 19:06:04 +02:00
.clang-tidy clang-tidy: Add option to silence GLib macro warnings 2023-12-19 14:26:13 +02:00
.editorconfig Add an .editorconfig file 2018-04-13 09:14:33 +01:00
.gitignore meson: Add a Wrap subproject for xcb-keysyms 2023-11-30 21:18:00 +02:00
CONTRIBUTING.md docs: Change CMake references to Meson ones 2022-07-20 17:22:58 +03:00
COPYING Add license text, upate copyright headers 2018-03-08 01:50:26 +00:00
meson.build build: make libmanette support explicit 2024-08-28 13:40:16 +03:00
meson_options.txt build: make libmanette support explicit 2024-08-28 13:40:16 +03:00
NEWS Release version 0.19.1 2023-11-30 22:05:36 +02:00
README.md docs: Change CMake references to Meson ones 2022-07-20 17:22:58 +03:00

Cog

Cog (boat)

Build - Native Build - ARM Code Style

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 WPE WebKit API.

  • cog is the launcher itself, implemented using the libcogcore library.

  • cogctl is a tool which can be used to control a cog instance using the D-Bus session bus.

It is possible to disable building the cog and cogctl programs by passing -Dprograms=false to Meson.

Dependencies

Stable releases have the following dependencies:

  • WPE WebKit 2.28.x
  • WPEBackend-fdo 1.8.x (optional, recommended)

Note that building from the master branch will often require development releases of WPE WebKit, libwpe, and WPEBackend-fdo; while older Cog releases may have different version requirements.

Using Cog

Compiling Cog follows the usual procedure for projects which use Meson: meson setup build && ninja -C build should get you started, if your system has the needed dependencies installed.

Documentation is available at igalia.github.io/cog but it is currently incomplete. 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.

Contributing

For information on how to report bugs, or how to contribute to Cog, please check the CONTRIBUTING.md file.

License

This project is licensed under the terms of the MIT license. Check the COPYING file for details.