Skip to content
/ Vieb Public
forked from Jelmerro/Vieb

Vim Inspired Electron Browser - Vim bindings for the web by design

License

Notifications You must be signed in to change notification settings

alandiwix/Vieb

 
 

Repository files navigation

icon

Vim bindings for the web by design

Website Download counter Latest release License Support Donate

Matrix Matrix Matrix Matrix

Reddit Telegram Telegram Telegram

Vieb is the Vim Inspired Electron Browser

Vieb is pronounced like "deep" with a "v" and rhymes with sheep

Features

  • Free, open source, fast and secure
  • Local first adblocking, auto-complete, AMP protection, custom redirects and more, all without web requests
  • Privacy with strict permission system, navigator overrides, firefox mode, custom WebRTC policy and more
  • Accessible with custom themes, full interface & fontsize scaling, page zooming, spellcheck and mouse support
  • Security settings with permissions, cache usage, cookie management, (auto-)download settings and more
  • Window splitting with buffer, split, Vexplore and Ctrl-w bindings, for multi-window browsing
  • Map commands for completely custom keyboard sequences, keystrokes, commands and actions
  • Viebrc config file for all custom/Vim/Vieb commands to configure settings permanently
  • Set command for runtime setting configuration exactly like Vim
  • Vim-compatible options: showcmd, timeout, colorscheme, maxmapdepth, spelllang, splitright, smartcase etc.
  • Container tabs with colored grouping, auto-clearing, individual cookies and tab restore from containers
  • Ad-blocker with cosmetic filtering, optional updater, custom lists and uses easylist/easyprivacy by default
  • Tabs including audio indicator, a toggle for multi-line tabs, pinned tabs, muted tabs and suspended tabs
  • Offline help documentation always available upon pressing F1
  • And much, much more

screenshot

Erwic

With the "erwic" startup option, you can "Easily Run Websites In Containers". The purpose of this option is similar to programs such as Franz, Ferdi or Rambox. It can also replace other Electron-based desktop apps such as Slack or Discord. These instances of Vieb can run separately from your existing Vieb. See Erwic.md for usage and details.

Download

There are many ways to download and install Vieb. Besides running from source or making your own builds, these are the main sources to download Vieb. For startup help, see the frequently asked questions.

The official Vieb website, where you can download the latest stable release for many platforms.

The same releases that are offered on vieb.dev, but with release notes and previous versions listed.

Third-party

These releases are made by users just like you for their favorite system. Third-party releases might be outdated (in red) or customized compared to official builds, but they are probably the simplest way to get started if your system is listed.

Third-party releases table

Cheatsheet

Quickly get an overview of the default mappings and basic usage.

cheatsheet

Contribute

You can help by reporting issues and suggesting new features on the Github issue tracker. Another way to help is by supporting Jelmerro on ko-fi or github. Donating is completely optional because Vieb will always be free and open source. If you know how to write Electron applications, you can also help by writing code. Check the 'help wanted' issues for suggestions on what to work on. Please try to follow these guidelines while working on Vieb:

  • Use Vim to edit :)
  • Follow the included eslint style guide
  • Use editorconfig for indentation

For an example vimrc that is configured to use these tools, you can check out my personal vimrc.

Building

To create your own builds or run Vieb from source, you need to install Node.js. The next step is to clone the repository or download the source code. After downloading, make sure you are in the cloned/extracted Vieb folder and run:

npm ci
npm start

If this runs Vieb as expected, you can generate builds for your platform with npm run build. To see the full list of run and build options, simply execute npm run. The entire configuration for what to build is stored in the electron-builder.yml config file.

License

Vieb is created by Jelmer van Arnhem and contributors. See the source files for individual authors.

You can copy or modify the code/program under the terms of the GPL3.0 or later versions. For more information and legal terms, see the LICENSE file.

About

Vim Inspired Electron Browser - Vim bindings for the web by design

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 63.4%
  • HTML 29.0%
  • Vim Script 3.4%
  • CSS 3.2%
  • Batchfile 0.7%
  • Python 0.3%