Skip to content

Mouse-Free Navigation ​

Mise Browser is built around a keyboard-driven workflow, enabling efficient navigation of complex web pages without reaching for a pointing device.


Link Hints allow you to click any link, button, or input field on a web page using short letter combinations:

  1. Press Ctrl + F to trigger the hint labels.
  2. Mise injects two-letter tags over every clickable element on the page, using an ergonomic left-hand home-cluster layout: q, w, e, a, s, d, z, x, c, r, f, v.
  3. Type the two letters corresponding to your target element:
    • Links navigate immediately.
    • Text inputs and search bars automatically receive focus for immediate typing.
  4. Press Escape or press Ctrl + F again to dismiss hints without clicking.

The link hinter script is injected directly upon guest page readiness and operates independently of tab indexing, ensuring transferred, restored, and background tabs always receive link hinting capabilities. While hints are active, the status bar mode badge reflects HINTS mode live.


Ephemeral Tab Peek ("Glance") ​

Mise features a transient link preview modal ("Glance") inspired by the preview workflows in Zen and Arc, but engineered with zero background memory residue:

  1. Triggering Glance:
    • Shift + Click: Hold Shift and click any hyperlink on a webpage to preview it immediately.
    • Vim Hint Sequence (gh): Press g followed by h within 500ms in NORMAL mode (or press Ctrl + G) to display purple link hints (#bb9af7). Typing a hint code opens the target link in the Peek preview frame.
  2. Transient Isolation:
    • Spawns a floating modal frame over the active webview without creating a permanent tab in the tab list.
    • Runs in the current workspace container partition, sharing authentication state without leaking session data.
  3. Instant Dismissal:
    • Press Escape or click the close button to unmount the preview frame immediately.
    • Invokes guest webview destruction to halt all media, abort event listeners, and detach DOM nodes completely, releasing memory back to the operating system.
    • Keyboard focus returns directly to the underlying page without intermediate clicks.
  4. Promotion to Permanent Tab:
    • Press Ctrl + Enter or click Open in Tab to convert the transient preview into a permanent tab within your active workspace.

Status Bar Address Bar (Ctrl + L / o) ​

Press Ctrl + L or o at any time to focus the centered address bar fixed in the bottom status bar:

  • Direct Navigation: Type any full or partial URL and press Enter. Upon navigation, keyboard focus immediately returns to the guest webview so Vim normal mode shortcuts (f, j, k, r, etc.) are active immediately without requiring a manual mouse click.
  • Live Search Autocomplete: As you type, Mise queries your browsing history and active bookmarks live. Use the Up and Down arrow keys to select a suggestion and press Enter. Suggestions expand smoothly upwards above the status bar.
  • Direct Calculator: Type any arithmetic expression (e.g. 240 * 1.2, 15% of 200, sqrt(144)) to compute the answer live in the upward dropdown menu. Press Enter to copy the answer to your clipboard, or press the Down Arrow or Tab to put the result into the address bar and continue calculating.
  • DuckDuckGo Bangs: Type any DuckDuckGo bang (e.g. !w Arch Linux, !gh MiseBrowser, !yt ambient) to route directly to thousands of external search destinations.
  • Workspace Switching: Type ws followed by a workspace name (e.g. ws work) to switch workspaces instantly from the address bar.
  • Terminal Execution & Oversight: Type terminal commands directly (e.g. pacman -Syu, btop, git status) or with explicit prefixes ($, >, :sh, term). High-risk system calls (sudo, curl, wget) and script files (.sh, .py, etc.) are automatically formatted with the oversight prefix for scanning, copied safely to your clipboard, and an external terminal is spawned for deliberate pasting.
  • Local File Containment: Entering local file paths (starting with / or file://) is strictly restricted to valid PDF documents, automatically mediating them through the offline PDF viewer. Navigation to arbitrary local file paths is blocked with a status bar alert to protect system security.
  • Press Escape to blur the address bar, dismiss suggestions, and return focus directly to the active web page.

DuckDuckGo Bang Redirection ​

DuckDuckGo Bangs and Address Bar Calculator

Mise supports over 13,500 DuckDuckGo bangs directly from the status bar address bar. Bangs route queries directly to the target website:

  • !w Arch Linux: Redirects directly to the Arch Linux article on Wikipedia.
  • !gh MiseBrowser: Redirects directly to GitHub repository search.
  • !yt lo-fi: Redirects directly to YouTube video search.
  • !a NetworkManager: Redirects directly to the ArchWiki page.
  • !so promises: Redirects directly to Stack Overflow.

Popular bangs display rich destination badges in the autocomplete dropdown. You can place the bang at the beginning or end of your query (e.g. !w Arch Linux or Arch Linux !w).


Custom Search Aliases & Shorthand Bangs ​

In addition to DuckDuckGo bangs, Mise includes native search engine prefixes that execute instantly without redirect delays. Prefix any query with an alias in the status bar address bar (Ctrl + L or o):

  • g <query>: Google
  • ddg <query>: DuckDuckGo
  • yt <query>: YouTube
  • gh <query>: GitHub
  • a <query>: ArchWiki
  • aur <query>: Arch User Repository
  • pkg <query>: Arch Linux Packages
  • so <query>: Stack Overflow
  • r <query>: Reddit
  • sp <query>: Startpage
  • b <query>: Brave Search
  • k <query>: Kagi

User-Customised Search Engines ​

You can add your own search engines or override existing shortcuts directly in Preferences (Ctrl + H) or inside ~/.config/mise-browser/config.json:

json
"custom_search_aliases": {
    "aur": "https://aur.archlinux.org/packages?K=%s",
    "nix": "https://search.nixos.org/packages?query=%s",
    "mdn": "https://developer.mozilla.org/en-US/search?q=%s"
}

Any custom alias is recognised immediately in the address bar and displays an interactive suggestion badge in the autocomplete dropdown.


Live Address Bar Calculator ​

The address bar includes a built-in mathematical expression evaluator that runs completely locally without external network requests:

  • Basic Arithmetic: 240 * 1.2, (100 + 25) / 5, 150 - 45
  • Powers & Roots: 2^10, sqrt(144), cbrt(27)
  • Percentages: 15% of 200, 25% * 80
  • Trigonometry & Logarithms: sin(0), cos(pi), log2(256), log10(1000)
  • Constants: pi, e

Selecting the calculator result copies the computed value to your system clipboard and displays a status bar confirmation.


Search Engine Aliases ​

When typing queries into the address bar, prepend shorthand prefixes to route searches directly to specific services:

Shorthand AliasSearch DestinationExample Query
g <query>Google Searchg linux kernel archives
ddg <query>DuckDuckGoddg rust async tutorial
a <query>Arch Linux Wikia hyprland config
pkg <query>Arch Linux Package Searchpkg neovim
gh <query>GitHub Repository Searchgh electron
yt <query>YouTube Searchyt ambient coding music
r <query>Reddit Searchr archlinux
so <query>StackOverflowso javascript closures
sp <query>Startpage Searchsp private search
b <query>Brave Searchb web standards
k <query>Kagi Searchk technical docs

If no alias is entered, Mise uses your configured default search engine set in Preferences.


Auto-Collapsing Vertical Sidebar (36px Strip) ​

To dedicate maximum horizontal screen real estate to web content, Mise features an auto-collapsible vertical sidebar:

  • Compact 36px Strip: In its default collapsed state, the sidebar shrinks to a 36px icon bar displaying only your custom workspace glyph badge (tinted in your container's custom accent colour) and crisp tab favicons. Instant peripheral visual identity ensures you always know which container is active.
  • Smooth Flyout on Hover: Moving your mouse pointer over the 36px strip smoothly expands the sidebar to 260px as an overlay flyout with drop shadow. Because this expands as an overlay, the active webview never resizes, preventing GPU lag and page reflows on fanless hardware.
  • Shortcut Expansion: Press Ctrl + Shift + Z to toggle sidebar expansion, or press Ctrl + S to focus the sidebar and expand it immediately for arrow-key navigation. Pressing Escape or Ctrl + W collapses the sidebar smoothly back to the 36px strip.
  • Pinning: Click the pin icon button at the bottom of the sidebar, toggle Auto-Collapse Sidebar in Preferences (Ctrl + H), or run Pin / Unpin Sidebar in the Command Palette to pin the sidebar permanently open at 260px.

Mise maintains clean separation between sidebar navigation and active web page interaction:

  • Ctrl + S: Shifts keyboard focus to the vertical tab sidebar, smoothly expanding it. Use the Up and Down arrow keys (or j / k) to cycle through open tabs, and press Enter to switch to the highlighted tab.
  • Ctrl + W: Shifts keyboard focus directly into the active webview, automatically collapsing the sidebar back to the 36px strip.
  • Ctrl + X: Closes the currently active tab.
  • Ctrl + R: Reloads the active tab.

Mise Browser provides a Vim-inspired modal navigation engine that frees you from chorded modifiers during routine web browsing. The engine distinguishes between four primary operational states reflected in the status bar mode badge:

  1. NORMAL Mode: The default state. Home-row keys control page scrolling and browser actions without requiring Ctrl or Alt chords.
  2. INSERT Mode: Automatically entered whenever you click or focus a text input, search box, or content-editable field (or press i explicitly). Keystrokes pass directly into the field. Pressing Escape blurs the field and immediately returns to NORMAL mode.
  3. PASSTHROUGH Mode: Designed for rich web applications like Google Docs, sheets, design suites, and cloud terminals. In passthrough mode, all keystrokes pass directly to the guest web application without browser interception. Toggle passthrough mode at any time using Shift + Escape or by clicking the mode badge in the status bar.
  4. HINTS Mode: Automatically active while link hints are displayed over the page (Ctrl + F or f in NORMAL mode). The status bar indicator synchronises live via guest DOM mutation monitoring, returning to NORMAL mode upon hint selection or dismissal.

NORMAL Mode Keymap ​

KeyActionDescription
jScroll DownScroll down by 80px
kScroll UpScroll up by 80px
dDark ReaderToggles high-contrast dark theme on active tab
uHalf Page UpScroll up by half the viewport height
hScroll LeftScroll left by 80px
lScroll RightScroll right by 80px
ggJump to TopJump to top of page
GJump to BottomJump to bottom of page
tNew TabOpens a new tab with default search engine
xClose TabCloses the current active tab
oAddress BarFocuses centered status bar address bar
rReloadReloads active tab
RForce ReloadReloads active tab ignoring cache
HHistory BackNavigates back in page history
LHistory ForwardNavigates forward in page history
/Find in PageOpens the in-page search bar
nFind Next MatchJumps to next search match in page
NFind Previous MatchJumps to previous search match in page
fLink HintsInjects two-letter hint tags over clickable links
eReader ViewToggles native distraction-free reader view
mMute TabMutes or unmutes audio output on active tab
MGlobal MuteMutes or unmutes audio across all tabs
pPin TabToggles pinned status on active tab
wDashboardOpens the Workspace Dashboard tree
sFocus SidebarMoves focus to vertical sidebar tab list
yYank URLCopies current URL to clipboard with status bar feedback
iInsert ModeExplicitly enters INSERT mode
Shift + EscapePassthrough ModeToggles PASSTHROUGH mode on or off

Pinned Tabs & Accidental Closure Guard ​

Keep vital dashboards, communications, and media tabs protected from accidental closure and easily accessible:

  • Instant Pinning: Press F4 (or press p in NORMAL mode, or click the pin icon in the tab item) to pin or unpin any tab.
  • Top-Anchored Priority: Pinned tabs are neatly grouped and anchored at the very top of the active workspace tab list, marked with a distinctive golden pin dot badge.
  • Accidental Closure Guard: If you press Ctrl + X while viewing a pinned tab, Mise blocks closure and displays a status bar warning reminding you that the tab is pinned. This prevents losing ongoing research, active streams, or draft forms.
  • Persistent Pinning: Pinned tab states persist in ~/.config/mise-browser/session.json across reboots and window reloads.

Workspace Badges, Tab Jumping & Favicons ​

  • Direct Tab Jumping: Focus the sidebar (Ctrl + Tab or s) and press 1 through 9 to jump directly to any numbered tab without waking intermediate tabs into memory.
  • Dynamic Tab Number Badges: Small index badges (1 to 9) appear over tab favicons whenever the sidebar has keyboard focus or the Ctrl key is held, showing the exact number to jump to.
  • Non-Disruptive Sidebar Cursor Navigation: Moving with j / k or Down / Up moves the cursor highlight across tabs without waking sleeping tabs into memory. Press Enter, Space, or l / Right to activate the highlighted tab.
  • Workspace Badges: The top of the strip displays a compact letter or number badge for the current workspace (such as W1 or P). Clicking the workspace badge opens the Workspace Dashboard (Ctrl + Shift + W).
  • Favicons & Indicators: Each tab renders its website favicon with smart local and remote caching. Sleeping tabs display a subtle moon indicator, while tabs playing audio render a green audio badge.

Dual Split View (1x2 Side by Side and Stacked) ​

For comparing documentation, pull requests, or research sources without tiling window manager complexity, Mise includes a built-in dual split view:

  • Instant Comparison: Press Ctrl + Shift + S (or click the column icon in the sidebar) to split the viewport into two 50% columns side by side.
  • Orientation Toggle: Right-click the split icon button or execute Cycle Split View Orientation in the Command Palette to switch between side by side (vertical columns) and stacked (horizontal rows).
  • Focus Switching: Press Ctrl + O to switch keyboard focus between Pane 1 and Pane 2. The active pane displays an accent focus ring, and its matching sidebar tab is highlighted with a numbered badge (1 or 2).
  • Pane Swapping: Press *Ctrl + * to swap the positions of the two open split panes instantly.
  • Context Menu Link Routing: Right-click any hyperlink on a page and select Open Link in Split View to open or send that link directly into the adjacent comparison pane.
  • Tab Assignment: Clicking any tab in the sidebar while in split mode routes that page into whichever pane currently holds active focus.
  • Hibernation Exemption: Both visible split panes are automatically protected from background tab sleep while displayed on screen.

Native Reader View (F9 / e) ​

Mise includes an in-engine DOM distiller powered by Mozilla Readability to strip ads, sidebars, cookie banners, and visual clutter from articles:

  • Instant Distillation: Press F9 or press e in NORMAL mode to extract the core article, byline, and imagery into a clean reading format.
  • Isolated Shadow DOM: The reader view is rendered inside an isolated Shadow DOM container over the active document. Closing Reader View (via Escape, F9, or the close icon) restores the original web page instantly without reloading or discarding form inputs.
  • Custom Typography and Themes: A floating controls pill at the top-right corner allows adjusting:
    • Themes: Dark (Tokyo Night), Sepia (Warm Paper), and Light.
    • Font Families: Modern Sans-serif, Classic Serif, or Clean Monospace.
    • Font Size: Adjustable scale between 14px and 28px.
    • Reading Width: Narrow (620px), Medium (760px), or Wide (940px).
  • Reading Metrics: Header estimates word count and reading time based on typical reading velocity.

Native Downloads Shelf (Ctrl + Shift + D) ​

Manage ongoing and completed file downloads directly within the application without leaving your active tab:

  • Download Shelf Toggle: Press Ctrl + Shift + D to display or hide the bottom downloads drawer.
  • Live Progress & Speed: Displays active transfers, download velocity, percentage completion, and elapsed time with visual progress indicators.
  • Tracked Path Containment: Opening or revealing downloads via IPC handlers (open-download, reveal-download) is strictly restricted to canonical realpaths of tracked active and recent downloads. Untracked or arbitrary renderer-supplied paths are rejected.
  • Dangerous Extension Safeguards: Downloaded files matching dangerous executable or script extensions (.exe, .msi, .bat, .cmd, .com, .scr, .ps1, .vbs, .js, .jse, .wsf, .lnk, .jar, .sh, .run, .appimage, .desktop, .command, .app, .dmg, .pkg, .deb, .rpm) are identified case-insensitively. Opening a dangerous file automatically diverts from direct execution to revealing the file safely inside the system file manager.
  • Non-Blocking File Manager Integration: File manager discovery and revelation utilise asynchronous, non-blocking execution with timeouts over D-Bus (org.freedesktop.FileManager1) and XDG desktop configurations, ensuring the browser UI never freezes during disk or process operations.

In-Page Search & Match Navigation (Ctrl + Shift + F / F3 / /) ​

Find text across active web content with instant matching and Vim-style navigation:

  • Instant Search Activation: Press Ctrl + Shift + F, F3, or press / in NORMAL mode to display the floating Tokyo Night search bar (#FindBarOverlay).
  • Live Match Counter: Displays real-time match statistics as you type (such as 4 of 21 matches, 1 of 1 match, or 0 matches with high-contrast alert styling when no matches are found). Chromium natively highlights all match positions along the vertical scrollbar track.
  • Automatic Vim SmartCase: Adopts standard Vim search behaviour. Searching with an all-lowercase query performs case-insensitive matching; typing any uppercase character automatically engages case-sensitive matching.
  • Case Sensitivity Toggle (Aa): Click the Aa button or navigate to it via keyboard to manually toggle case matching, with an illuminated accent border reflecting active status.
  • Fluid Keyboard Navigation & Focus Handoff:
    • Type a search query and press Enter to confirm. Keyboard focus immediately returns to the active webview, enabling single-key cycling with n (next match) and N (previous match) in NORMAL mode without touching the mouse.
    • Use Tab to cycle keyboard focus through overlay controls within a circular trap: Search Input -> Case Toggle (Aa) -> Previous Match (Chevron Up) -> Next Match (Chevron Down) -> Close (X) -> back to Search Input.
    • Pressing Enter or Space while focused on any navigation button triggers the action and returns focus directly to the webview.
    • Pressing n or N while focused on overlay buttons drops focus back to the webview and jumps to the next or previous match.
    • Press Escape from the search input, overlay buttons, or the webview to dismiss the search bar and clear highlight markers.

Released under the GNU General Public Licence v3.0. • Follow on Mastodon • Discuss on Reddit