Repository files navigation

Visit onFirefox Add-ons /Microsoft Edge Add-ons /Chrome Web Store

ACustomizedVimium(to click web page content and manipulate browser windows using only keyboard)havingcontextual mapping,global shortcuts,command sequences,Chinese supportandinjection functionality,inC-style code for quicker action and less resourcecost.

Vimium 的一款修改版（可以用键盘点击网页内容、操作浏览器窗口），添加了完整的中文支持、分场景映射、全局快捷键和命令序列功能，还能运行在某些接受 Vimium C的扩展程序的私有页面里，并且对CPU和内存资源的消耗很低。

阅读中文介绍 (description in Chinese) 。

This project is mainly developed and maintained bygdh1995 (Gong Dahan),and open-sourced under theApache-2.0 license.

本项目主要由gdh1995（宫大汉）开发并维护，且以Apache-2.0 许可协议 开源。

It (the released version) supports the new Microsoft Edge, Google Chrome and other Chromium-based browserswhose core versions are >= 102, and has a perfect support for a recent Firefox (since version 101.0, desktop).It can even run on Microsoft Edge (EdgeHTML), though there're still some errors.If re-compiled from the source code, Vimium C is able to support Chromium 32108 and Firefox 63100.

它支持内核版本不低于 102 的新版 Microsoft Edge、Google Chrome 和其它以 Chromium 为内核的浏览器，同时也能完美运行在近些年发布的 Firefox 101（桌面版）和更高版本上，甚至在 Edge (EdgeHTML 内核) 上也能正常执行大部分命令。如果从源码重新编译，Vimum C 还可以支持 Chromium 32108 和 Firefox 63100。

This project is hosted onhttps://github.com/gdh1995/vimium-c andhttps://gitee.com/gdh1995/vimium-c .

Some old code of Vimium C was under the MIT license,and you may get it inhttps://github.com/gdh1995/vimium-c/tree/MIT-licensed-v1 .

Vimium C 的部分旧代码以 MIT 许可协议开源，可以前往https://github.com/gdh1995/vimium-c/tree/MIT-licensed-v1 获得源码。

An old name of this project is "Vimium++", which has been given up on 2018-08-21.

This section is modified fromphilc/vimium 's.

Modifier keys are specified as<c-x>,<m-x>, and<a-x> for Ctrl+x, Meta+x, and Alt+x respectively.For Shift+X and Ctrl+Shift+X, just typeX and<c-s-x>.See the next section for how to customize these bindings.

Once you have Vimium C installed, you can see this list of key bindings at any time by typing?.

Navigating the current page:

?       show the help dialog for a list of all available keysh       scroll leftj       scroll downk       scroll upl       scroll rightgg      scroll to top of the pageG       scroll to bottom of the paged       scroll down half a pageu       scroll up half a pagef       show hints for links and buttons to open in the current tabF       show link hints and open a link in a new tabr       reloadgs      view sourcei       enter insert mode -- all commands will be ignored until you hit Esc to exityy      copy the current url to the clipboardyf      copy a link url to the clipboardgf      cycle forward to the next framegF      focus the main/top frame

Navigating to new pages:

o       open URL, bookmark, or history entry, on an English letter "o"O       open URL, bookmark, history entry in a new tab, on an English letter "O"b       open bookmarkB       open bookmark in a new tab

Using find:

/       enter find mode          -- type your search query and hit enter to search, or Esc to canceln       cycle forward to the next find matchN       cycle backward to the previous find match

For advanced usage, seeregular expressions on the wiki.

Navigating your history:

H       go back in historyL       go forward in history

Manipulating tabs:

J, gT   go one tab leftK, gt   go one tab rightg0      go to the first tab. Use `ng0` to go to n-th tab, on `g` and a number character of `0`g$      go to the last tab^       visit the previously-visited tabt       create tabyt      duplicate current tabx       close current tabX       restore closed tab (i.e. unwind the `x` command)T       search through your open tabsW       move current tab to new window<a-p>   pin/unpin current tab

Using marks:

ma, mA  set local mark "a" (global mark "A")`a, `A  jump to local mark "a" (global mark "A")``      jump back to the position before the previous jump          -- that is, before the previous gg, G, n, N, / or `a

Additional advanced browsing commands:

]], [[  follow the link labeled "next or ">" ("previous" or "<">)          - helpful for browsing paginated sites<a-f>   open multiple links in a new tabgi      focus the first (or n-th) text input box on the page. Use <tab> to cycle through options.gu      go up one level in the URL hierarchygU      go up to root of the URL hierarchyge      edit the current URLgE      edit the current URL and open in a new tabzH      scroll all the way leftzL      scroll all the way rightv       enter visual mode; use p/P to paste-and-go, use y to yank, use v/c/V to toggle visual/line/caret modesV       enter visual line modeyc      select a first word of a sentence and enter visual mode

Vimium C supports command repetition so, for example, hitting5t will open 5 tabs in rapid succession.<esc>(or<c-[>) will clear any partial commands in the queue and will also exit insert and find modes.

There are some advanced commands which aren't documented here; refer to the help dialog (type?) for a full list.

This section is modified fromphilc/vimium 's.

When you have just installed Vimium C, it will open a new tab to show its default key mappings,and you may also open Vimium C's options page and press? (usually it'sShift+/) to show those mappings again.

You may remap or unmap any of the default key bindings in the "Custom key mappings" on the options page.

Enter one of the following key mapping commands per line:

• map <key> command: Maps akey to a Vimium C command. Overrides web pages' default behavior (if any).
• mapKey <key> <another_key>: Let Vimium C treatkey asanother key. Can not affect your browser or web pages.
• unmap <key>: Unmaps a key and restores the default behavior (if any).
• unmapAll: Unmaps all bindings. This is useful if you want to completely wipe Vimium C's default commands and startfrom scratch with your own setup.

Examples:

• map r reload maps the r key to reloading the page.
• map <c-d> scrollPageDown maps Ctrl+D to scrolling the page down.
• unmap r removes any mapping for the r key.
• unmap <c-d> removes any mapping for Ctrl+D and restores web page or browser's default behavior.
• unmap g0 removes any mapping for ag key and a next0 key.

Available Vimium C commands can be found via the "Show available commands" link or? key on the options page.The command name appears to the right of the description in parenthesis.

You can add comments to key mappings by starting a line with" or#, or a space character and a next# in a line.

The following special keys are available for mapping:

• <c-*>,<a-*>,<s-*>,<m-*> for Ctrl, Alt, Shift, and Meta (Command on macOS) respectively with any key.Replace* with the key name of choice.
• <left>,<right>,<up>,<down> for the arrow keys.
• <f1> through<f12> for the function keys.
• <space> for the space key.
• <tab>,<enter>,<delete>,<backspace>,<insert>,<home> and<end> for non-printable keys

Here're some advanced usages which are different with philc/vimium:

• Shift are automatically detected, so,& corresponds toShift+7 on an English QWERTY keyboard.
  • However, if a single key is longer than 1 character, please wrap it with<+> and insert as-
  • If you want to trigger a key when multiple modifier keys are pressed, sorta/c/m/s- prefixes by letter order
  • For example, these keys are valid names:<s-left>,<c-j>,<a-s-k>,<a-#> and<a-?>
• mapKey <key:o> <another_key> makeskey work as another key only in a special mode named Vomnibar
  • mapKey rules always take effect before matching a key withmap rules
  • some other modes are list inhttps://github.com/gdh1995/vimium-c/wiki/Use-in-another-keyboard-layout#per-mode-mapkey
• map <key:i> command makeskey trigger the command in insert mode only, but not the default normal mode
• since v1.99.98,map! <single_key> mapskey in both normal mode and insert mode, if only it's not a long sequence
  • For example,map! jj is invalid, butmap! <home> andmap! <c-j> are suitable
• unmap can only unmap a manually-mapped key or a default key, so a secondunmap <key> may result in an error
  • You may useunmap! when you're not sure whether a key has been mapped before
• number keys (0-9 and-) are mapped to "count prefix" of commands by default, so won't be passed to web pages.
  • And then, even afterunmapAll, they will be automatically added back on a nextmap
  • you may writeunmap 0 to unmap it explicitly

VimiumC:

• 中文介绍 (description in Chinese)
• a web extension for Firefox, Microsoft Edge and Google Chrome that provides keyboard-based navigation and controlof the web, in the spirit of the Vim editor.
• add some powerful functions and provide more configurable details and convenience.
• here is itsApache-2.0 license andprivacy policy
• the initial code is forked fromphilc/vimium:master on 2014.
• customized after translating it from CoffeeScript into JavaScript and then TypeScript.

Other extensions supporting Vimium C:

• PDF Viewer for Vimium C
  • built from (modified)PDF.js,and is a replacement for the extension namedPDF Viewer
  • visit it onChrome Web Store
  • Project home:vimium-c-helpers/pdf-viewer
• NewTab Adapter
  • take over browser's new tab settings and open another configurable URL
  • visit it onFirefox Add-ons /Chrome Web Store
  • project home:vimium-c-helpers/newtab
• Shortcut Forwarding Tool
  • provide 32 configurable shortcuts and forward them to another extension like Vimium C
  • visit it onFirefox Add-ons /Chrome Web Store
  • project home:vimium-c-helpers/shortcuts
• Modified Weidu New Tab (微度新标签页修改版)
  • a modified and lite version ofwww.weidunewtab.com (orwww.newtabplus.com ), with Chinese translation only
  • it does not take over browser's new tab settings; if needed thenNewTab Adapter is recommended
  • visit it onChrome Web Store

Refer toRELEASE-NOTES.md.

There're some known issues on previous or latest versions of Chromium-based browsers,and please readhttps://github.com/gdh1995/vimium-c/wiki/Known-issues-on-various-versions-of-Chromefor more information.

If you want to compile this project manually, then you need a Node.js 13+ and npm. Please run:

npm install typescriptnpm install pngjs# only needed for Chromium-based browsersnode scripts/tsc# ./scripts/make.sh vimium_c-debug.zip

gulp local can also compile files in place (using configurable build options),whilegulp dist compiles and minimizes files intodist/.

The options includingMinCVer andBTypes ingulp.tsconfig.jsonare used to control supported target browsers and set a minimum browser version.

Vimium C is an open-source browser extension, and everyone can install and use it free of charge.If you indeed want to give its author (gdh1995@qq.com) financial support,you may donate any small amount of money to him throughOpen Collective,PayPal,Alipay orWeChat. Thanks a lot!

Vimium C 是一款开源的浏览器扩展程序，任何人都可以安装使用它而无需支付任何费用。如果您确实想要资助它的开发者（gdh1995@qq.com），可以通过支付宝、微信、Open Collective或PayPal 无偿赠与他一小笔钱。谢谢您的支持！

A partial donation list is in / 部分捐赠列表详见:https://github.com/gdh1995/vimium-c/wiki/Donation-List .

Vimium C: Copyright (c) Gong Dahan. See theApache-2.0 license for details.

The translation files in_locales/ belong toCC-BY-SA-4.0,except some of those English sentences which are the same asphilc/vimium'sare under Vimium's MIT license.

• Vimium:Copyright (c) 2010 Phil Crosby, Ilya Sukhar.Licensed under theMIT license.
• TypeScript:and modifiedes.d.ts,es/*,dom.d.ts andchrome.d.ts intypes/:Copyright (c) Microsoft Corporation (All rights reserved).Licensed under theApache License 2.0.See more onwww.typescriptlang.org.
• Viewer.js(Modified):Copyright (c) 2015-present Chen Fengyuan.Licensed under theMIT license.
• JavaScript Expression Evaluator(Modified):Copyright (c) 2015 Matthew Crumley.Licensed under theMIT license.
• The orange picture in the icon is fromhttps://pixabay.com/vectors/orange-fruit-mandarin-citrus-fruit-158258/
• 微度新标签页:Copyright (c) 2012 杭州佐拉网络有限公司 保留所有权利.
• PDF.js:Copyright (c) Mozilla and individual contributors.Licensed under theApache License 2.0.

TheVimium Cand other extensions published bygdh1995are available for all people in"all regions"of Microsoft Edge Add-ons, Chrome Web Store and some other markets.This behavior is only to make these extensions easier to use, but
DOES NOT EXPRESS OR IMPLIED the author (gdh1995) "agrees or has no objection to"that "Taiwan" can be parallel to "China",which was aninappropriate status quo in the stores' (developer) pages on 2021-06-03.

According toThe Constitution of the People's Republic of Chinaand international consensus,Taiwan is an inalienable part of the sacred territory of the People's Republic of China.