All Projects → luakit → Luakit

luakit / Luakit

Licence: gpl-3.0
Fast, small, webkit based browser framework extensible by Lua.

Programming Languages

c
50402 projects - #5 most used programming language
lua
6591 projects
Roff
2310 projects
Makefile
30231 projects
CSS
56736 projects
Vim Script
2826 projects

Projects that are alternatives of or similar to Luakit

Lgf
Game development framework for Lua
Stars: ✭ 68 (-95.85%)
Mutual labels:  luajit
Love
LÖVE is an awesome 2D game framework for Lua.
Stars: ✭ 1,305 (-20.43%)
Mutual labels:  luajit
Luajit Imgui
LuaJIT ffi binding for imgui, backends and extension widgets
Stars: ✭ 107 (-93.48%)
Mutual labels:  luajit
Pure lua sha
SHA1, SHA2 and SHA3 functions written in pure Lua and optimized for speed
Stars: ✭ 78 (-95.24%)
Mutual labels:  luajit
Android Luajit Launcher
Android NativeActivity based launcher for LuaJIT, implementing the main loop within Lua land via FFI
Stars: ✭ 87 (-94.7%)
Mutual labels:  luajit
Lua Cassandra
Pure Lua driver for Apache Cassandra
Stars: ✭ 95 (-94.21%)
Mutual labels:  luajit
Pelagia
Automatic parallelization (lock-free multithreading thread) tool developed by Surparallel Open Source.Pelagia is embedded key value database that implements a small, fast, high-reliability on ANSI C.
Stars: ✭ 1,132 (-30.98%)
Mutual labels:  luajit
Vifm
Vifm is a file manager with curses interface, which provides Vim-like environment for managing objects within file systems, extended with some useful ideas from mutt.
Stars: ✭ 1,822 (+11.1%)
Mutual labels:  vim-like
Lua Resty Route
URL Routing Library for OpenResty Supporting Pluggable Matching Engines
Stars: ✭ 88 (-94.63%)
Mutual labels:  luajit
Edgedeflector
A tiny helper application to force Windows 10 to use your preferred web browser instead of ignoring the setting to promote Microsoft Edge. Only runs for a microsecond when needed.
Stars: ✭ 1,371 (-16.4%)
Mutual labels:  web-browser
Brat
Brat is a little language for people who don't like to be told what to do.
Stars: ✭ 78 (-95.24%)
Mutual labels:  luajit
Penlight
A set of pure Lua libraries focusing on input data handling (such as reading configuration files), functional programming (such as map, reduce, placeholder expressions,etc), and OS path management. Much of the functionality is inspired by the Python standard libraries.
Stars: ✭ 1,265 (-22.87%)
Mutual labels:  luajit
Cocos2d Lua Community
基于Cocos2d-x 4.0,打造易用稳定的Cocos2d-x lua引擎。
Stars: ✭ 96 (-94.15%)
Mutual labels:  luajit
Luajit Msgpack Pure
MessagePack for LuaJIT (using FFI, no bindings, V4 API)
Stars: ✭ 71 (-95.67%)
Mutual labels:  luajit
Lua Resty Http
Lua HTTP client cosocket driver for OpenResty / ngx_lua.
Stars: ✭ 1,647 (+0.43%)
Mutual labels:  luajit
Cyberfox
cyberfox code repository
Stars: ✭ 66 (-95.98%)
Mutual labels:  web-browser
Utf8.lua
pure-lua 5.3 regex library
Stars: ✭ 94 (-94.27%)
Mutual labels:  luajit
Onionbrowser
An open-source, privacy-enhancing web browser for iOS, utilizing the Tor anonymity network
Stars: ✭ 1,702 (+3.78%)
Mutual labels:  web-browser
Motan Openresty
A cross-language RPC framework for rapid development of high performance distributed services based on OpenResty.
Stars: ✭ 117 (-92.87%)
Mutual labels:  luajit
Webwhir
A simple HTML rendering engine.
Stars: ✭ 99 (-93.96%)
Mutual labels:  web-browser

Luakit

luakit is a fast, light and simple to use micro-browser framework extensible by Lua using the WebKit web content engine and the GTK+ toolkit.

Don't Panic!

You don't have to be a developer to use luakit on a daily basis. If you are familiar with vimperator, pentadactyl, jumanji, uzbl & etc you will find luakit behaves similarly out of the box.

Requirements

  • GTK+ 3
  • Lua 5.1 or LuaJIT 2
  • lfs (lua file system)
  • webkit2gtk
  • sqlite3
  • gstreamer (for video playback)

Installing

Luakit is available on most Linux Distributions and BSD system via their package managers.

  • Debian/Ubuntu: apt-get install luakit
  • Gentoo: emerge luakit
  • Guix: guix install luakit
  • Arch: pacman -S luakit
  • FreeBSD: pkg install luakit
  • OpenBSD: pkg_add luakit

Installing from source

Make sure you system fulfills the requirements listed above, then install luakit with the following commands:

$ git clone https://github.com/luakit/luakit.git
$ cd luakit
$ make
$ sudo make install

Uninstall with:

$ sudo make uninstall

Note: If you are on BSD, you might need to use gmake.

Use Luakit

Just run:

$ luakit [URI..]

Or to see the full list of luakit launch options run:

$ luakit -h

Luakit works with vim-style bindings. To find out more, type :help within luakit.

Configuration

Luakit configuration files are written in lua. This means you can program within the config files, which make the configuration options endless.

There are three ways to customize luakit.

1. within luakit

After starting luakit, type :settings. This page shows you webkit engine related settings.

2. userconf.lua

Create a file called $HOME/.config/luakit/userconf.lua. Then add your configuration there. Configuration in this file supersedes configuration set in :settings

3. copy rc.lua

The most powerful customization is to copy rc.lua from /etc/xdg/luakit/rc.lua to $HOME/.config/luakit/rc.lua

When this file is found, /etc/xdg/luakit/rc.lua is ignored.

Be informed that when luakit is updated, you may need to adapt changes from /etc/xdg/luakit/rc.lua to your own copy.

Colors and fonts

Copy the /etc/xdg/luakit/theme.lua to $HOME/.config/luakit/theme.lua. You can change fonts and colors there.

Development Information

This section contains information about the compile and testing process.

Luakit honors the PREFIX variable. The default is /usr/local.

$ make PREFIX=/usr
$ sudo make PREFIX=/usr install

Note that you also have to set the PREFIX when uninstalling!

Luakit uses luajit by default, to use lua you can turn off luajit with:

$ make USE_LUAJIT=0

To build with local paths (interesting for package maintainer and contributers). You may wish to build luakit with:

$ make DEVELOPMENT_PATHS=1

This lets you start luakit from the build directory, using the config and libraries within the same.

Take a look at config.mk for more options.

If you made changes and want to know if luakit is still working properly, you can execute the test suite with:

$ make test

Tipps and fixes:

Video playback

If you're having issues with video playback, this is often related to buggy graphic drivers. It often helps to set LIBGL_DRI3_DISABLE before starting luakit:

$ export LIBGL_DRI3_DISABLE=1

Webkit process limit

Since Webkit 2.26, the webkit engine used in luakit is creating a new process for each tab. This has the benefit that a webkit webview crash will only crash one tab. The downside is lower performance and increased memory use.

If you value speed over stability, you can ask webkit to use one process for all tabs by setting WEBKIT_USE_SINGLE_WEB_PROCESS before starting luakit:

$ export WEBKIT_USE_SINGLE_WEB_PROCESS=1

HiDPI Monitor Configuration

If you have a HiDPI monitor (> 1920x1080) and find that web pages are too small, you can change the webview.zoom_level on the settings page (luakit://settings/) to 150 or 200 as per your taste.

Reporting Bugs

Please note that most rendering related issues come from the used webkit engine and can not be fixed by luakit. If you think your issue is luakit related, please use the bug tracker at:

https://github.com/luakit/luakit/issues

Coming from a very old luakit version? Look at the MIGRATION document.

IRC

Join us in #luakit on the irc.oftc.net network.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].