1 unstable release

Uses old Rust 2015

0.1.0 Nov 15, 2016

#32 in #key-bindings

BSD-2-Clause

165KB
2K SLoC

Rust 1.5K SLoC Lua 661 SLoC // 0.0% comments

webkitten

Webkitten is a command-driven web browser toolkit inspired by luakit and Vim.

Webkitten allows you to:

  • Browse the web (nearly) pointing device-free
  • Run custom scripts for browser interaction on demand or triggered by events
  • Edit human-readable configuration files
  • Assign keybindings to your custom scripts
  • Alter web pages with custom CSS and JavaScript
  • Create custom browsing modes based on the sites you visit
  • Customize your own content blocking

Running a reference implementation

In addition to the tooling, Webkitten includes two reference implementations of the browser interface:

  • webkitten-cocoa: A Cocoa WebKit implementation of Webkitten with Lua scripting
  • webkitten-gtk: [WIP] A WebKit2 GTK+3 implementation of Webkitten with Lua scripting

Use make run to run the default implementation for your platform, and see the User Guide and the contrib directory for commands to kick start your configuration. Use make install to install the binary into your PATH.

Building your own browser

Using the webkitten toolkit requires implementing the ui module and starting the application with an implementation of ui::ApplicationUI:

// Create runtime configuration
let run_config = RunConfiguration {
  path: path_to_config_toml,
  start_pages: vec!["https://example.com"]
};

// Create engine
let engine = Engine::new(run_config);

// Create UI
let mut ui = MyCustomUI::new(engine);

// Go go go
ui.run();

Then the UI should notify the EventHandler when events occur, such as pressing the Return key in the command bar or web content failing to load. Provided this contract is met, the scripting engine can automate interactions with the UI, making it easy to customize.

While named "webkitten", new UI bindings do not necessarily need to be WebKit-based, though the bindings were designed with WebKit in mind.

Development

Webkitten is largely written in Rust and uses Cargo for dependency management. Questions, suggestions, and patches welcome - see the Contribution Guide for more information.

Building

To build, run make. To run the reference implementations, use make run.

For all other commands, try make help.

Dependencies

~3MB
~80K SLoC