WidZett

A customizable desktop widget engine for Linux, built with GTK and WebKit.

Description

WidZett allows you to run HTML/JS/CSS based widgets on your Linux desktop. It consists of a C-based engine (widzett-engine) that renders the widgets and a Python-based manager for configuration and control.

Prerequisites

To compile and run WidZett, you need the following dependencies:

• gtk+-3.0
• webkit2gtk-4.1
• x11
• xfixes
• python3
• python3-gobject (for the manager)

On Fedora/RHEL-based systems:

sudo dnf install gtk3-devel webkit2gtk4.1-devel libX11-devel libXfixes-devel python3-gobject

On Debian/Ubuntu-based systems:

sudo apt install libgtk-3-dev libwebkit2gtk-4.1-dev libx11-dev libxfixes-dev python3-gi

Compilation

To build the widzett-engine binary, simply run:

make

To clean up build artifacts:

make clean

Directory Structure

• src/: Contains the C source code for the main engine and the Python manager.
  • main.c: The core C code for the widget window.
  • manager/: The Python code for the widget manager and configuration.
• widgets/: Contains the default widgets. Each widget is a directory with an index.html file.

Usage

1. Compile the engine using make.
2. Run the manager:

   python3 src/manager/widzett-manager.py