Next is the next generation browsing experience designed for power users. 100% of the functions and classes are exposed to the end-user allowing for infinite customization.
- Zooming page
- Jumping to links (link-hints)
- Visiting URLs
- Searching via search engine
- Jumping to Headings
- Input (Minibuffer)
- Buffers ("tabs")
- Download manager
- Opening files
- Clearing the Echo Area
- Proxy and Tor support
- Certificate host whitelisting
- Cloning Git repositories
- Downloading videos
- Password manager
- Advanced Topics
- Start-up options
- Decide how to open files
- Loading Files
- Creating your own interactive commands
- Getting input from the user
- Network resource dispatch (including ad-blocking)
- Startup behaviour
- Run Next in a security sandbox
- Font size on HiDPI displays
Within a tab, all navigation is possible using only the keyboard. To navigate up and down on a web page, the following keybindings are provided.
C-n: Move down
C-p: Move up
scroll-left: Move left (no keybindings for now)
scroll-right: Move right (no keybindings for now)
M->: Jump to bottom of page
M-<: Jump to top of page
Note_: Next also ships VI-style keybindings.
Use the zoom keybindings to make everything on a web page larger or smaller.
C-x C-=: Increase size
C-x -: Decrease size
C-x C-0: Restore defaults
Jumping to links (link-hints)
In order to visit a link, one never has to remove their fingers from the keyboard. It works like this:
- Enter in a special key combination
- Several strings will appear on screen "AZ" "CY", these special strings represent links that you can visit
- Enter in one of these strings into the minibuffer
- Visit the page
The full key-bindings for link-hint based navigate are found below:
C-g: Go to link in current tab
M-g: Create new tab with link, focus on new tab
C-u M-g: Create new tab with link, keep focus on current tab
When ambiguous URLs are inputted, Next will attempt the best guess about what the user wishes. If the user does not supply a protocol in a URL,
https will be assumed. To visit a site supporting only
http, the user must explicitly type the full URL with
C-l: Change URL of current document
M-l: New document-mode tab
Searching via search engine
From the new URL prompt, any input that is not recognized as a URL will be searched using the default search engine. Any query that starts with a known search engine prefix will use the corresponding search engine for the query.
For instance, to search "parrot" on Wikipedia:
M-lto open a new URL prompt.
From a Lisp REPL, you can query the list of search engines with
It will return something like
~a in the search engine URI is a place holder for the search pattern.
To set the list of search engines, do:
(in-package :next-user) (defclass my-browser (browser) ((search-engines :initform '(("default" "https://duckduckgo.com/?q=~a" "https://duckduckgo.com/") ("yt" "https://www.youtube.com/results?search_query=~a" "https://www.youtube.com/") ("wiki" "https://en.wikipedia.org/w/index.php?search=~a" "https://en.wikipedia.org/"))))) (setf *browser-class* 'my-browser)
and to append a search engine to the list, you can do
(in-package :next-user) (defclass my-browser () ((search-engines :initform (append '(("yt" "https://www.youtube.com/results?search_query=~a" "https://www.youtube.com/") ("wiki" "https://en.wikipedia.org/w/index.php?search=~a" "https://en.wikipedia.org/")) (get-default 'browser 'search-engines))))) (setf *browser-class* 'my-browser)
Jumping to Headings
Jumping to different headings based on fuzzy completion is available via the following keybindings:
C-.: Jump to heading
All input is handled within a special area called the minibuffer. The minibuffer will appear at the bottom of the screen when the user is responsible for inputting some value. The minibuffer may also suggest completions.
Any time a function activates the minibuffer there are two applicable returns:
C-return: Return Immediate - Return EXACTLY what has been typed into the minibuffer, ignoring completions.
return: Return Complete - If completion function provided, return the selected completion candidate. If completion not provided return the EXACT text inputted into the minibuffer. If completion function provided, no completion applicable (selected), and the :empty-complete is a truthy value, the function will accept the EXACT text inputted into the minibuffer.
When that makes sense (e.g. for the
delete-buffer command), multiple entries can be marked. The default bindings are:
C-spaceto toggle the mark of an entry.
M-ato mark all visible entries.
M-uto unmark all visible entries.
When the input is change and the candidates are re-filtered, the selection is not alterered even if the marked elements don't show.
Once at least one candidate is marked, only the marked candidates are processed upon return. The candidate under the cursor is not processed if not marked.
Many browsers implement the concept of multiple views with "tabs". Tabs are inherently flawed as they don't scale: it's hard to manage more than a few dozen of them.
In Next, multiple views are implemented as "buffers". Each buffer can use its own set of "modes". A mode is a collection of settings, key bindings, commands, etc. Regular web pages use the
document-mode by default.
The standard keybindings for buffer management are:
C-x b: Switch buffer
C-x Left: Switch to previous buffer
C-x Right: Switch to next buffer
C-x k: Delete a buffer
C-x C-k: Delete the current buffer
M-l: Open URL in new buffer
C-l: Change URL of current buffer
C-t: Make new empty buffer
Switching Tabs by Order
In addition to switching tabs by selecting the current tab, you can cycle through them. This enables you to jump back and forth between two tabs that are next to each other.
C-[: Switch tab previous
C-]: Switch tab next
A mode is a collection of features, ranging from key bindings to network options. It can be enabled or disabled on a per-buffer basis via the command of the same name, e.g.
Each buffer has its own list of modes. The first mode in the list has highest priority: this is important, for instance, to determine which key binding takes precedence in case of conflict. See Keybinding for more details.
Modes are CLOS objects that are instantiated per-buffer. No buffer shares the same instance of a mode (by default at least).
Modes are typically defined in their separate Common Lisp package. This allows for defining mode-specific functions and variables in a separate namespace.
To enable a mode for all buffers by default, add the mode to the list of default modes:
Windows vs. buffers
When opening a link from an external program, or when clicking on a link while
C is pressed, Next can load the URL either
- in a new window if
(open-external-link-in-new-window-p *browser*)is non-nil;
- in a new buffer otherwise.
You can change the default behaviour by adding the following to your configuration file:
There are a number of keybindings provided to enable searching within a buffer.
C-s s: Search for a given term: This command will place a hint next to every match on a given web-page.
C-s n: Next match: This command will move the next match to the top of the browser screen.
C-s p: Previous match: This command will move the previous match to the top of the browser screen.
C-s k: Clear search: Remove the search hints from the screen.
History is represented as a tree that you can traverse. More complex than the "forwards-backwards" abstraction found in other browsers, the tree makes sure you never lose track of where you've been.
In the example below, the user performs the following actions:
- Starts page
- Visits page
- Returns to page
- Visits page
- Returns to page
forwardskeybind in history
It is at this point that a normal browser would not be able to navigate you forwards to your visit of
Ancient Greek. Instead of erasing your history, Next offers smart navigation and prompts the user. Do you wish to go forwards to
Ancient Greek or to
The standard keybindings for forward-backward navigation are:
C-f: Navigate Forward
C-b: Navigate Backward
M-f: Navigate Forward Tree
M-b: Navigate Backward
By using navigate forward tree you will be prompted for which branch you'd like to visit as in the example above. The simple navigate forward command will simply visit the first child of the current node in the tree.
In order to navigate and manage your bookmarks, a few functions are provided:
C-m s: Bookmark Current Page
C-m u: Bookmark URL (input URL via minibuffer)
C-m o: Open Bookmark
C-m g: Bookmark Anchor (input URL via link hints)
C-m k: Delete Bookmark
Bookmarks can have tags, a shortcut string, a search-url and a timestamp.
You can filter them with selectors: use
- or write a compound query inside parenthesis in which you can use
+lisp -blog +blog (or lisp emacs) +foo -bar (or (and john doe) (not (and tic tac)))
Bookmarks are stored in a plain text format, so than you can read and manipulate them easily with any other program.
When you download a file, you are taken to a
*Downloads* buffer, which shows the ongoing download progress and the list of files downloaded during the current session. You can switch to this buffer as usual, and also with
To open a file, use
M-x download-open-file. See the customization section to control how files are open.
M-x open-file (bound to
C-x C-f), you are prompted a list of files, and you can select one with the usual fuzzy completion. You can go one directory up with
C-l, and enter the directory at point with
Next will open itself directories and supported media types (new in Next 1.3.5), otherwise it will try to open the file with the system's default using
xdg-open. See the command help for further details, and the customization section to override the default behavior.
Note: this feature is alpha and is meant to grow in Next 1.4 and onwards.
Next opening a directory:
Next opening a video. We can treat it like any other buffer:
Clearing the Echo Area
In the area at the bottom of the screen where the minibuffer resides, Next will occasionally display messages. These can be dismissed by using the binding
To exit Next enter the key-combination
C-x C-c and the program will quit. All of your open tabs and form data will not be persisted. The only information saved will be your filled in passwords, cookies, and other information within your cache.
Proxy and Tor support
You can surf the web behind a proxy by issuing the command
proxy-mode. Its default server address is
socks5://127.0.0.1:9050, meaning it works out of the box for Tor.
You can change the default proxy with
At the time of writing, there are differences between the Gtk and the Qt port: the Gtk one sets proxies per-buffer, whereas it is currently global for the Qt one.
To enable proxy for all buffers by default, add the proxy mode to the default modes. See Modes for details.
Certificate host whitelisting
By default the WebKit engine refuses to establish a secure connection to a host with an erroneous certificate (e.g. self-signed ones). The buffer mode
certificate-whitelist allows to mitigate this problem by providing a mechanism to specify a list of hosts for which certificate errors shall be ignored. A hostname does not contain a protocol like HTTP or HTTPS and is basically the domain name of the server serving the web content to which a URL refers, e.g. the hostname in the URL https://next.atlas.engineer/ is
To enable this mode put the following statements into your
(in-package :next-user) (setf next/certificate-whitelist-mode:*default-certificate-whitelist* (make-instance 'certificate-whitelist :whitelist '("next.atlas.engineer"))) (defclass my-buffer (buffer) ((default-modes :initform '(web-mode root-mode proxy-mode certificate-whitelist-mode)))) (setf buffer-class 'my-buffer)
Cloning Git repositories
git-clone) command to clone a Git repository to disk. It asks you for the destination and then runs asynchronously.
This feature is meant to grow with Next 1.4 and onwards!.
By default, the command looks into the following directories for existing projects:
"~/projects" "~/src" "~/work" "~/common-lisp" "~/quicklisp/local-projects"
You can change the list like this:
When there is one single choice, it doesn't ask for confirmation.
You can set your username for GitHub and other forges. It helps the clone command in doing the right thing©. For example, if it sees that you are cloning a repository of yours (the user/organization name of the cloned repository equals your vcs-username), it will use a git remote url instead of https.
next/vcs:*vcs-username* as a default username.
Change also the
Note that the forge name should be a domain, such as github.com.
M-x download-video will try to download the video at the current URL. For example, it works with any YouTube video.
It will ask for a target repository and will notify on success or failure.
It uses by default the program youtube-dl, that you must have installed first.
Disclaimer: this feature is meant to grow with Next 1.4 and onwards!
To customize it, see all the variables and functions in video-mode.
Next provides a password manager interface to KeepassXC or Pass.
The two commands to know to use it are
copy-password, to choose a password from the minibuffer and to copy it to the clipboard.
Execute Extended Command
You can execute any command by name by typing
M-x. This will bring up a list of candidates that you can fuzzily complete.
The help system allows you to look up variable and function docstrings directly within Next. Docstrings will appear in a new help buffer.
C-h v: Look up a variable docstring
C-h c: Look up a command docstring
Eval Lisp forms
The command line option
--eval EXPR= allows you to execute a Lisp expression:
next --eval '(format t "hello Next!")'
The plateform port is not started. If you want to execute commands against a running Next process, see the
start-swank command and the developer setup.
SLIME with a compiled version of Next
SLIME provides a way of interacting with Next, and with Lisp code in general (e.g. in a REPL).
From the SLIME manual:
SLIME extends Emacs with support for interactive programming in Common Lisp. The features are centered around slime-mode, an Emacs minor-mode that complements the standard lisp-mode. While lisp-mode supports editing Lisp source files, slime-mode adds support for interacting with a running Common Lisp process for compilation, debugging, documentation lookup, and so on.
To use SLIME with a compiled version of Next use the keybinding
C-h s to launch a Swank server. SLIME will connect to the Swank server and give you completion, debugging, documentation, etc. The port for Swank is define in
*swank-port* and its default value is different from that of Swank on Emacs to avoid collisions with an Emacs
After launching the Swank server in Next, execute the following within Emacs:
127.0.0.1for the host
- Enter the port number set in the Next variable
To customize the port that Swank starts on, edit the global variable
*swank-port* in your init file.
All customization begins by creating a
~/.config/next/init.lisp file. Within your init file you can write your own keybindings and customizations. If the directory
~/.config/next/ does not already exist, you will have to make it.
The first line of an init file should contain the following package declaration in order to modify Next-specific variables and functions:
Following the package declaration, you can write or override any functions and variables.
When you are done, you can load your changes while Next is running with the command
load-init-file. Or load any file with
Next will warn you its best about type mismatches (new in Next 1.3.5). You should be confident that "if it loads, it works"©.
Keys are defined with the
(defvar *my-keymap* (make-keymap) "My keymap.") (define-key :keymap *my-keymap* "C-x o" #'example "space" #'scroll-page-down) ;; Bind in current buffer's first mode. This won't affect other buffers. (define-key :keymap (getf (keymap-scheme (find-mode (current-buffer) 'my-mode)) :emacs) "C-x C-c h" #'hello-local-world)
Read on for an explanation of the meanings of
In the previous example, the key sequence
C-x o would invoke the
example command. If later another command is bound to
C-x, all other bindings starting with
C-x will be overridden.
The following keys exist as special keys:
S: Super (Windows key, Command Key)
M: Meta (Alt key, Option Key)
s: Shift key
Keymaps and key binding schemes
A keymap is a collection of key-to-command bindings.
Modes can define key binding schemes, which are sets of keymaps indexed by a scheme name like
The currently active key binding scheme is selected by the
current-key-scheme buffer slot. When a key is hit, Next looks up the keymaps of the corresponding scheme for all active modes in the current buffer.
You can change the default binding scheme for any buffer by setting
current-key-scheme to the appropriate value.
To create a keymap, use the
The user can define key bindings by creating a mode that is loaded before any other mode. In your configuration file:
(in-package :next-user) (defvar *my-keymap* (make-keymap) "Keymap for `my-mode'.") (define-mode my-mode () "Dummy mode for the custom key bindings in `*my-keymap*'." ((keymap-schemes :initform (list :emacs *my-keymap* :vi-normal *my-keymap*)))) (defclass my-buffer (buffer) ((default-modes :initform (cons 'my-mode (get-default 'buffer 'default-modes))))) (setf *buffer-class* 'my-buffer)
You can customize the behaviour of modifiers in arbitrary ways thanks to the
modifier-translator slot of the
For instance, if you want swap
(defun my-translate-modifiers (modifier-state &optional event) "Swap control and meta." (declare (ignore event)) (let ((plist '(:control-mask "meta" :mod1-mask "control" :shift-mask "shift" :super-mask "super" :hyper-mask "hyper"))) (delete nil (mapcar (lambda (mod) (getf plist mod)) modifier-state)))) (defclass my-browser (gtk-browser) ((modifier-translator :initform #'my-translate-modifiers))) (setf *browser-class* 'my-browser)
The override map is the first keymap that is looked up for a binding when a key is pressed. Override maps are stored in every buffer. They are exposed to the user as a mean to override any binding from any mode. They should not be modified by any library.
VI is a modal text editor that is famous for its modal key bindings. In normal mode, all keys are commands, they won't insert any text anywhere.
In insert mode, all textual keys insert the corresponding text.
Next offers two modes,
vi-insert-mode to simulate this behaviour. For instance, in
j scrolls the page down and
k scrolls up.
To go from normal mode to insert mode, press
i. To go from insert mode to normal mode, press
The default keybindings for
"Z Z": kill "[": switch-buffer-previous "]": switch-buffer-next "g b": switch-buffer "d": delete-buffer "D": delete-current-buffer "B": make-visible-new-buffer "o": set-url-current-buffer "O": set-url-new-buffer "m u": bookmark-url "m d": bookmark-delete "C-o": load-file "C-h v": variable-inspect "C-h c": command-inspect "C-h s": start-swank ":": execute-command "W": new-window
The minimal config that sets your Next in vi mode, is:
next command accepts URLs as parameters, as well as some options.
The available options are:
Using the session
By default, Next will restore the previous session, and save the current one to disk.
You can disable this behavior with a command line option:
next --session nil
and a lisp parameter:
To quit Next without saving the session, use the command
Decide how to open files
download-open-file call the function
You can override this behaviour by binding another function to the variable
next:*open-file-function*, in which you can fallback to the default function.
For example, below we open directories with
emacsclient and some music ad videos with
(defun my-open-files (filename) "Open music and videos with mpv, open directories with emacsclient." (let ((args) (extension (pathname-type filename))) (cond ((uiop:directory-pathname-p filename) (log:info "Opening ~a with emacsclient." filename) (setf args (list "emacsclient" filename))) ((member extension '("flv" "mkv" "mp4") :test #'string-equal) (setf args (list "mpv" filename)))) (handler-case (if args (uiop:launch-program args) ;; fallback to Next's default. (next/file-manager-mode:open-file-function filename)) (error (c) (log:error "Error opening ~a: ~a" filename c))))) (setf next/file-manager-mode:*open-file-function* #'my-open-files)
To load a file again, or reload an init file use the function load-file. Within the minibuffer prompt enter the full path to the file you wish to load.
C-o: Load File
A convenience function for reloading the init file called
load-init-file can also be keybound.
Creating your own interactive commands
Creating your own invokable commands is the same as creating any other
defun except the form is
define-command. A docstring is highly recommended and will produce a style warning when it is missing.
An example of a trivial command definition can be seen below.
These functions will help you retrieve information:
(current-buffer)returns the current, visible buffer in Next.
- use the accessors
(title …)accessors to get its url and its title.
(buffers *browser*)returns a hash-table of all the buffers in the current session. The keys are the buffers id (a string), the values the buffer object.
Getting input from the user
Getting input from the user via the minibuffer is an asynchronous command. That is why the
read-from-minibuffer function is wrapped within a continuation-passing-style macro
with-result. The form therefore takes the following look:
Network resource dispatch (including ad-blocking)
The dispatching of network queries can be fully customized in the
resource-query-function slot of the
resource-query-default function for an example which dispatches downloads, new window requests,
This function can also serve as an entry point to URL-based resource blocking.
Resource blocking (Ad-blocking)
Next provides the
blocker-mode. It filters networks requests (including ads)by the host name. A default filter list is automatically updated from https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts.
Multiple lists of hosts can be added and blocker mode will filter based on all the lists.
To add a list, add an instance of the
hostlist class to the
hostlists slot. For instance, you can add this to your
(in-package :next-user) (defvar *my-blocked-hosts* (next/blocker-mode:make-hostlist :hosts '("platform.twitter.com" "syndication.twitter.com" "m.media-amazon.com"))) (define-mode my-blocker-mode (next/blocker-mode:blocker-mode) ((hostlists :initform (list *my-blocked-hosts* next/blocker-mode:*default-host-list*)))) (defclass my-buffer (buffer) ((default-modes :initform (cons 'my-blocker-mode (get-default 'buffer 'default-modes))))) (setf *buffer-class* 'my-buffer)
hostlist class also support fetching the list from a URL. The list can be persisted to the file specified in the
Some actions will draw elements on the HTML page, for instance
go-anchor will draw link hints as boxes with indices.
The style of those boxes is defined in the
box-style slot of the
Like any other slot, you can set the default value from your
init.lisp. For instance, to change the style to using upper case, no gradiant, and square boxes:
(in-package :next-user) (defclass my-buffer (buffer) ((box-style :initform (cl-css:inline-css '(:background "#C38A22" :color "black" :border "1px #C38A22 solid" :font-weight "bold" :padding "1px 3px 0px 3px" :padding "1px 3px 0px 3px" :position "absolute" :text-align "center" :text-shadow "0 3px 7px 0px rgba(0,0,0,0.3)"))))) (setf *buffer-class* 'my-buffer)
A hook holds a list of handlers. Handlers are specialized functions
Hooks can be run, that is, their handlers are run according to the
combination slot of the hook. This combination is a funtion of the handlers.
Hooks are exposed to the users so that they can customize the behaviour of specific actions in arbitrary ways.
Many hooks are executed at different points in Next, among others:
- Global hooks, such as
- Window / buffer related hooks.
- Commands "before" and "after" hooks.
- Modes "enable" and "disable" hooks.
For instance, if you want to force
www.reddit.com, you can set a hook like the following in you
(defun old-reddit-hook (url) (let* ((uri (quri:uri url))) (if (search "www.reddit" (quri:uri-host uri)) (progn (setf (quri:uri-host uri) "old.reddit.com") (let ((new-url (quri:render-uri uri))) (log:info "Switching to old Reddit: ~a" new-url) new-url)) url))) (defclass my-buffer (buffer) ((load-hook :initform (next-hooks:make-hook-string->string :handlers (list #'old-reddit-handler) :combination #'next-hooks:combine-composed-hook)))) (setf *buffer-class* 'my-buffer)
Some hooks like the above example expect a return value, so it's important to make sure we return
url here. See the documentation of the respective hooks for more details.
List of available hooks
All commands have an associated "before" and "after" list of hooks: the
help command has
To add a hook handler, call
Now when you press
M-x help, you'll see
<INFO> [18:15:45] next (hello-hook) - hello
Initialization and exit hooks
after-init-hook: Hook run after both the Lisp side and the
platform port have started.
- argument: None.
before-exit-hook: Hook run before both the Lisp side and the
platform port get terminated.
- argument: None.
load-hook: Hook run after the URL to be visited was parsed. The URL isn't loaded yet.
- argument: The URL that is going to be visited.
- return: Handlers must return a (possibly new) URL (see example above).
window-make-hook: Hook run after the window is created on the platform port.
- argument: The window.
window-delete-hook: Hook run before the window is deleted.
- argument: The window.
window-set-active-buffer-hook: Hook run before the given buffer is added to the window and marked the active buffer.
- arguments: The window and the buffer.
buffer-make-hook: Hook run after the buffer is created on the platform port.
- argument: The buffer.
buffer-delete-hook: This hook is run before the buffer is deleted on the platform port.
- argument: The buffer object.
before-download-hook: hook run before downloading a URL.
- argument: The URL.
after-download-hook: Hook run after a download has completed.
- argument: The
- argument: The
enable-hook: This hook is run when enabling the mode.
- argument: The mode.
disable-hook: This hook is run when disabling the mode.
- argument: The mode.
Once the platform port has been started, the default action of Next is to run
startup-function defaults to
default-startup and takes URLs that are passed to Next as command line arguments.
You can assign you own function to
startup-function to change the behaviour of Next on startup, such as which URL it should display, if it should restore the previous session or not, etc.
Run Next in a security sandbox
For improved security while you browse the internet, you can run Next with Firejail on GNU/Linux.
Font size on HiDPI displays
On HiDPI displays the font size used for displaying web and next's minibuffer content might be too tiny.
To fix this issue for the GTK port use this
StumpWM mouse scroll
If the mouse scroll does not work for you, see the StumpWM FAQ for a fix.