~damien/gtk-webby

#GTK Webby

Webby is a proof-of-concept application that behaves like a browser, but one that renders native GTK applications rather than websites.

For additional information, check out the blog post: https://damienradtke.com/post/building-gtk-applications-like-websites/

#Running

To run, first make sure you have the following installed:

Rust + Cargo
GTK4 development libraries

An easy way to do this is to use nix develop, or you can use your package manager.

Once these are installed, running is simply

# Vendor dependencies
# This step can be made optional by removing .cargo/config.toml
$ cargo vendor

# Run the application
$ cargo run

#Building the Flatpak

First, since Flatpak is sandboxed, you need to vendor the dependencies:

# Ensure a compatible version of Rust is used
# When building the Flatpak this may not be necessary
$ nix develop

# Build the flatpak
# The "prep" task is only necessary on first build, or after dependencies change
$ make prep build

# Run the flatpak
$ make run

Screenshot

#Examples

Running Webby will launch a window that can be used to load GTK "web" applications. A number of examples are included with Webby that only require Rust:

$ cd examples/hello
$ cargo run

Once the example is running, you can load it in Webby by using the URL http://localhost:8000.

#Tips

#GTK Inspector

When running the app, use Ctrl-Shift-D to open up the GTK inspector.

#"Live Reload"

To have pages automatically reload as you make changes, you can combine Webby's support for WebDriver with the provided watch-and-reload script (or another tool that does the same thing).

First, start Webby with WebDriver enabled:

$ cargo run -- --bind-webdriver=0.0.0.0:4444

Then, in another terminal, begin watching your directory for changes:

$ bin/watch-and-reload /path/to/src

When one of the files within your source directory changes, this script will send a WebDriver refresh request to Webby, which will cause the current page to reload.

#Lua Scripting Reference

Webby supports Lua scripting by embedding code within a <web:script type="lua"> tag.

#Global Functions

Name	Description
`find_widget(id: String) -> Widget`	Find a widget by its Builder ID and return a reference to it
`fetch(url: String, response: function(err, response))`	Fetch a URL asynchronously. The provided callback will be invoked with either `err` or `response` populated.
`alert(message: String)`	Open an alert dialog with a message
`submit_form(method: String, action: String, values: Table)`	Submit a form

Name	Description
`connect(signal: String, after: Boolean, callback: function())`	Connect a signal handler. Before invoking the callback, the global value `this` will be set to the widget
`get_property(property_name: String)`	Get a property value; only works for primitive return types (like strings or booleans)
`set_property(property_name: String, property_value: Any)`	Set a property value; only works for primitive types (like strings or booleans)
`get_text()`	Get the text from an Entry's buffer
`add_css_class(class: String)`	Add a CSS class
`remove_css_class(class: String)`	Remove a CSS class
`set_css_classes(classes: Array<String>)`	Set a list of CSS classes

refs

clone