aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAkshay Nair <phenax5@gmail.com>2025-08-05 10:01:25 +0530
committerAkshay Nair <phenax5@gmail.com>2025-08-05 10:01:25 +0530
commit705cb51d5c2c3da80bdf8bfab8381f0ab05b6b32 (patch)
tree9edbafc24eda1dee5a3a7bb2b32863a872288668
parente6d09718e62c89055d38274e1fa7b42daea6e555 (diff)
downloadnull-browser-705cb51d5c2c3da80bdf8bfab8381f0ab05b6b32.tar.gz
null-browser-705cb51d5c2c3da80bdf8bfab8381f0ab05b6b32.zip
Update readme
-rw-r--r--README.md20
-rw-r--r--media/screenshot.jpgbin0 -> 157695 bytes
2 files changed, 19 insertions, 1 deletions
diff --git a/README.md b/README.md
index 7f762e2..e6c6003 100644
--- a/README.md
+++ b/README.md
@@ -3,9 +3,11 @@
# null-browser [WIP]
A simple, fast web browser built using [qtwebengine (chromium)](https://wiki.qt.io/QtWebEngine), that is configured and extended using lua.
+
## What does it do?
This web browser is just a stack of web views that can be controlled using lua. Don't expect a full featured web browser, expect the **opposite**.
+
## What does it not do? How can I do it?
- **No url bar**
- use dmenu, rofi, fzf in a terminal, etc. for url input
@@ -37,13 +39,28 @@ This web browser is just a stack of web views that can be controlled using lua.
Any feature you want, you implement yourself. Either from scratch or build on top of a built-in module.
+
+## Built-in modules
+- Vi-style keybindings
+- Hints: f-key search for links
+- Plain-text history
+- Statusline showing the current keymode, url and tabs count
+- Tabline showing a list of tabs
+
+Using the builtin modules, you can get something like this:
+![screenshot defaults](./media/screenshot.jpg)
+
+Or do your own thing, I don't care.
+
+
## Who is it for?
I built this for myself and people like me who enjoy tinkering with their tools.
Out of the box, it is almost unusable... by design.
+
## Install
### Nix flake
-- Add this repo to nixos flake config: `inputs.null-browser.url = "github:phenax/null-browser";`
+- Add this repo to your flake: `github:phenax/null-browser`
- Or build it in a directory: `nix build github:phenax/null-browser`
- Or run it without installing: `nix run github:phenax/null-browser`
- Or add to profile: `nix profile install github:phenax/null-browser`
@@ -53,6 +70,7 @@ Out of the box, it is almost unusable... by design.
- Run `make build` to build it
- `sudo make install PREFIX=/usr/local` to install it
+
## Configuring
WIP
diff --git a/media/screenshot.jpg b/media/screenshot.jpg
new file mode 100644
index 0000000..384b35c
--- /dev/null
+++ b/media/screenshot.jpg
Binary files differ