-Check for updates
+Check for updates
UI configuration(gitee)
-Advanced customization
+Advanced customization
Ebrowser is designed with the philosophy of Android uweb browser (gitlab).
md in no-focus mode to preview markdown file.Note: Usually electron apps are heavyweight as they use browsers for simple things. Ebrowser uses core chromium effectively and very lightweight. Recommend to install electron separately.
-++Note: Usually electron apps are heavyweight as they use browsers for simple things. Ebrowser uses core chromium effectively and very lightweight.
+
You can find prebuilt binaries here.
-npm install electron
-npm install ebrowser
+Install ebrowser and electron separatedly (Recommended)
+Install ebrowser
+Either download (Click the green Code button above the file list => Select Download ZIP) and unzip from
+https://github.com/torappinfo/ebrowser
-Run ebrowser
+OR download and unzip ebrowser package directly from any of npm mirror sites like npmmirror or with nodejs by
+npm install ebrowser
+
+OR download/git clone files directly from any of mirror repositories and ebrowser is under the folder misc/ebrowser.
+Install electron
+Before you can run ebrowser, you need to install electron either with nodejs by
+npm install electron
+
+OR download and unzip electron binary directly from github or mirrors like npmmirror.
+Run ebrowser
electron ~/node_modules/ebrowser
-Later on, you can run "npm install electron" to update electron/chromium or "npm install ebrowser" to update ebrowser independently.
-Update app quickly without updating chromium
-Pressing "Alt" to show the menu bar and choose "Check for updates" under "Help". OR
-Type ":update" in the address bar and press "enter" key to update.
-Mirror urls could be used like ":update https://uwebzh.netlify.app/misc/ebrowser". All the mirrors listed on uweb browser could be used. The update url needs to be changed accordingly to be the folder "misc/ebrowser" under the mirror site root url.
-Key shortcuts
+OR
+electron [the-path-of-folder-with-downloaded-ebrowser-files]
+
+Update app quickly without updating chromium
+Pressing Alt to show the menu bar and choose Check for updates under Help. OR
+Type :update in the address bar and press enter key to update.
+Key shortcuts
- Alt: show menu
- ALT+<-: go backward
@@ -85,23 +102,23 @@ npm install ebrowser
- CTRL+TAB: switch to next tab
- CTRL+SHIFT+TAB: switch to previous tab
- CTRL+W: close Tab
-- CTRL+SHIFT+R: enable global redirection ("gredirect.json")
+- CTRL+SHIFT+R: enable global redirection (
gredirect.json)
- CTRL+R: disable global redirection
- ESC: remove focus. similar to vi normal mode.
- F1: Help
- F5: page refresh/reload
- F12: devtools
-Address bar commands
-Like any popular browser, the very first word in address bar if defined in "search.json" identifies a search engine. Moreover, the address bar serves as command line interface:
+Address bar commands
+Like any popular browser, the very first word in address bar if defined in search.json identifies a search engine. Moreover, the address bar serves as command line interface:
- "/" for find-in-page
- ":" for address bar commands
-- ac [bookmark/history path w/o ext] : load ".rec" file for autocomplete.
+- ac [bookmark/history path w/o ext] : load
.rec file for autocomplete.
- b [bookmarkfilename w/o ext] : bookmark current page in file.
- bjs : Browser-level JavaScript execution.
-- bml [filename w/o extension]: load/execute the javascript file.
+- bml [filename w/o extension] [arguments...]: load/execute the javascript file.
- cert : allow invalid certificates w/o arguments, otherwise restore to default.
- clear : the arguments could be
@@ -111,6 +128,7 @@ npm install ebrowser
- {options}
+- exit : exit browser
- ext [extension path]: load unpacked Chrome extension.
- gr [gredirect index]: global redirection with corresponding index. Use the first global redirection url if no argument. Disable global redirection with any index out of the range.
- js [js code] : execute JS code at OS level. Note: "javascript:..." is special url and thus works in the current web page, while ":js ..." commands can do any OS operations.
@@ -118,20 +136,26 @@ npm install ebrowser
- nr/ur for No/Use "redirect.json" for domain redirection.
- np : no proxy.
- up [proxyName] : use proxy. privous proxy or the first proxy in proxy.json w/o [proxyName]. ":up" command also disables global and domain redirections, which are not restored by ":np".
+- sys [command line] : execute system commands with url as one of arguments, and replace "%cookie" with corresponding one. Ex. "curl" commands for uploading.
- ua [useragentName] : set user agent for future tabs. default user agent w/o arguments.
- update [filename] : update the app w/o argument, otherwise retrive the [filename] from remote. The filename could be any file on mirror sites (this repository is part of it).
- pdf [filename w/o extension] {options} : print to PDF file. All arguments are optional; empty option "{}" to capture long screenshot as vector graphics.
-- "!" address bar commands
-"!xx ..." evaluates "xx.js" with the whole text as arguments[0].
+- "!" address bar commands
+
+- "!xx ..." evaluates "xx.js" with the whole text as arguments[0] at OS level.
+- "!!xx ..." evaluates "xx.js" with the whole text as arguments[0] at browser level, which could manipulate address bar etc.
+
+
- i: internal urls, which will be consistent with uweb.
- "i:0/js/xxx.js:[url]" loads the "[url]" with bookmarklet "js/xxx.js".
+- "i:8d[url]" fo force downloading
-Commands in no-focus mode (this mode is similar to vi Normal mode)
+Commands in no-focus mode (this mode is similar to vi Normal mode)
Pressing "ESC" to enter no-focus mode if not sure.
- ":" for address bar commands
@@ -139,7 +163,7 @@ npm install ebrowser
- "!" for "!" address bar commands
The other commands are defined in "mapkeys.json", which will map keys to address bar commands.
-Configuration files
+Configuration files
- "config": lines of address bar commands.
- "search.json": search engines as shortcut-queryUrl pairs, where "%s" would be replaced by search query.
@@ -157,24 +181,27 @@ npm install ebrowser
-Javascript at three levels
+Javascript at three levels
- Web page: url like "javascript:" or bookmarklet command ":bml" runs in web page.
- Browser (or renderer process) :
- ":bjs" to execute the following js code at browser level.
-- "!xx" evaluates "xx.js", which could manipulate address bar etc.
-- OS level (or main process) : ":js" to execute the following js code with all OS APIs available.
+- OS level (or main process) : ":js" to execute the following js code with all OS APIs available.
+
+- "!xx" evaluates "xx.js" with arguments.
-examples for ":js"/":bjs" commands
+
+
+examples for ":js"/":bjs" commands
:js bJS=true //allow external Javascript files for web pages
:js bJS=false //disallow external Javascript files for web pages
:bjs bHistory=true //to record url history
:bjs bQueryHistory=true //to record query/command history
-New usages
+New usages
-
Vector designing with web tech to replace Adobe Illustrator/Inkscape.
@@ -196,12 +223,12 @@ npm install ebrowser
-License
+License
You can copy or modify the code/program under the terms of the GPL3.0 or later versions.
-Last Modified: 12 July 2024
-reorg ebrowserreadme.md
+
Last Modified: 22 April 2026
+add back gitcode
@@ -224,7 +251,7 @@ reorg ebrowserreadme.md
diff --git a/en/filecap/index.html b/en/filecap/index.html
index 008a4f35..930db255 100644
--- a/en/filecap/index.html
+++ b/en/filecap/index.html
@@ -3,10 +3,11 @@
+
Custom file handling
-
+
+
+
+ Home Tags
+
+
+ 简体中文
+
+
+
+
+
+
+
+ File manager
+
+
+
+
+ Visiting file urls ending with "/" enters internal file manager.
+When the current tab is internal file manager, visiting file url for a file shows the content of the file, long pressing button "🕔" -> Editor loads line-based editor for the file. If the file does not exist, saving creates a new file.
+Running any command with address bar with the format "d::command line:" to execute "command line" in the current folder of the internal file manager. Ex:
+"d::touch a.txt:" to create a new file a.txt.
+"d::mkdir subdir:" to create a new folder names "subdir".
+"d::mv old new:" to rename the file "old" to be "new".
+
+
+Last Modified: 5 December 2025
+add filemanager.md
+
+
+
+
+
+
+
+
+
+
+
diff --git a/en/filenames/index.html b/en/filenames/index.html
index c75c42be..4a0cac7f 100644
--- a/en/filenames/index.html
+++ b/en/filenames/index.html
@@ -3,10 +3,11 @@
+
Configuration folders/files
-
+
+
+
+ Home Tags
+
+
+ 简体中文
+
+
+
+
+
+
+
+ Phrases and input method
+
+
+
+
+ "default.input"
+Click the following links to install menus popped by long pressing the share button (with arrow-out-of-square as icon) on the bottom toolbar:
+Address Bar
+New line
+CTRL-Z: undo
+CTRL-Y: redo
+Long pressing the share button in uweb browser will popup menus defined in file "default.input", each line of which defines common phrase for user inputs. If the phrase begins with "@xxxx@", then "xxxx" part is the alias for the rest part of the string. Alias could be used for non-printable phrases.
+Long text can be kept as txt file
+Click the following links to install menus displayed by long pressing the bookmark button (with star as icon):
+Select utf8 text file as keyboard input
+Address bar
+Address bar autocompletion as input method when starting with space
+"default.autoc" or other .autoc files when choosen are loaded for address bar autocompletion. If the address bar text starts with space, the selected text is treated as user input for focused element in the visible tab.
+Click the following links to append AI prompts:
+Fetch the data from above URLs
+More AI prompts, you could put them in the file "default.autoc" or other .autoc files:
+
+- word.studio
+
+Address bar as part of query
+When the input in main home screen starts with "space+newline", the effective query is addressbar+input.
+Address bar as IME
+Action mode menu item "⌨️" for address bar selection makes the text user input for focused element in the visible tab.
+Text processing commands or links can be installed as menus to process address bar text, thus makes address bar powerful IME.
+
+
+Last Modified: 13 November 2025
+update search engines
+
+
+
+
+
+
+
+
+
+
+