Vimium C - All by Keyboard

Visit on Chrome Web Store / Firefox Add-ons / MS Edge Add-ons

A Customized Vimium (to click web page content and manipulate browser windows using only keyboard) having Chinese support, global Commands and injection functionality, in C-style code for quicker action and less resource cost.

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

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

This project is mainly developed and maintained by gdh1995, and licensed under the MIT license.

本项目主要由 gdh1995 开发并维护，且以 MIT 许可协议 开源。

It (the version in Web Store) supports Chrome and other Chromium-based browsers whose core versions are >= 43, and supports almost all of the functionality on a recent Firefox (since version 63.0). On MS Edge (Chromium), it works well, and it can even run on MS Edge (EdgeHTML), though there're still some errors. If re-compiled from the source code, Vimium C is able to support Chromium 32~42.

它支持内核版本不低于 43 的 Chrome 和其它以 Chromium 为内核的浏览器，也能运行在最近发布的 Firefox 63 和更高版本上。 同时它完美支持了新版 Microsoft Edge (Chromium 内核) 浏览器，甚至在 Edge (EdgeHTML 内核) 上也能正常执行大部分命令。 如果从源码重新编译，Vimum C 还可以支持 Chromium 32~42。

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

Project Introduction

Vimium C:

• 中文介绍 (description in Chinese)
• a web extension for Chrome and Firefox that provides keyboard-based navigation and control of the web, in the spirit of the Vim editor.
• add some powerful functions and provide more configurable details and convenience.
• here is its license and privacy policy
• the initial code is forked from philc/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 : a modified version of PDF Viewer from PDF.js
  • Visit it on Chrome Web Store
• Shortcut Forwarding Tool
  • Provide 32 configurable shortcuts and forward them to another extension like Vimium C
  • Visit it on Chrome Web Store / Firefox Add-ons
• NewTab Adapter
  • Take over browser's new tab settings and open another configurable URL
  • Visit it on Chrome Web Store / Firefox Add-ons
• Modified Weidu New Tab (微度新标签页修改版) : a modified and lite version of www.weidunewtab.com (or www.newtabplus.com )
  • Visit it on Chrome Web Store

Release Notes

1.83.3

• createTab: in an incognito window, now don't open extension pages by default, unless evenIncognito
• Scroller: make keepHover enabled by default; also use a cheaper way to prevent hover effects
• autoOpen/openUrl: add an option testUrl, which is default to false if the option keyword is not empty
• LinkHints: use [aria-label] and support html[data-vimium-hints=ordinal]
• Vomnibar: fix bugs when preferring a web page as the Vomnibar page; fix no favicons on Firefox
• Vomnibar: add an option engines: enum to filter out any engines
• scroller: continue scrolling when irrelevant keys get released
• fix some other bugs

1.83.2

• LinkHints: no hint links on an iframe if it's wholly covered
• FindMode: fix an edge case Ctrl+J may hang at a place
• Vomnibar: fix a bug the currentWindow option may affect a next activateTabSelection command
• settings: fix a crash during auto-recovering when localStorage got cleared
• copy to clipboard: avoid spaces occur in URLs
• export settings: encode the block list of words using base64
• Firefox on Android: highly experimental support
• fix some other bugs

1.83.1

• i18n: support French when showing tips
• releases on the store: increase the required minimum Chrome version to 43
• Vomnibar: fix some bugs when a query starts with vimium://cd
• options page: if there're errors in custom key mappings, show them directly
• mapkey: support $if={...}, just like map
• text substitution: add a prefix of i for vimium://show image and two suffixes of r and d for URLs
• LinkHints: show indigenized upper-case characters (experimentally)
• autoOpen: add an option of copy (#159)

See more on RELEASE-NOTES.md.

Known Issues

There're some known issues on previous or latest versions of Chrome, and please read https://github.com/gdh1995/vimium-c/wiki/Known-issues-on-various-versions-of-Chrome for more information.

Building

If you want to compile this project manually, please run:

npm install typescript
npm install pngjs # needed for Chromium-based browsers
node scripts/tsc
# ./scripts/make.sh released-file.zip

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

The options including MinCVer and BTypes in gulp.tsconfig.json are used to control supported target browsers and set a minimum browser version.

Donate / 捐赠

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 through PayPal (https://www.paypal.me/gdh1995) or Alipay. Thanks a lot!

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

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

Thanks & Licenses

Vimium C: Copyright (c) Dahan Gong, Phil Crosby, Ilya Sukhar. See the MIT LICENSE for details.

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

Declaration for Applicable Regions

The Vimium C and other extensions published by gdh1995 are available for all people in "all regions" of Chrome Web Store, Microsoft Edge Add-ons 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 an inappropriate status quo in the stores' pages on 2019-11-16.

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