README.md

   1 ### Uweb browser: minimal suckless web browser with unlimited power
   2 <a href="README.zh-Hans.md" onclick="if(notRepo()){location='../../zh/readme/index.html#';return false;}">中文</a>
   3
   4 [Amazon appstore](https://www.amazon.com/TorApp-Info-uweb-browser-for-geeks/dp/B098QPR6N5)
   5 [Galaxy.Store](https://galaxy.store/uweb)
   6 <a href="en/download.md" onclick="if(notRepo()){location='../../en/changelog/index.html#';return false;}">Downloads</a>
   7
   8 [Uweb browser: downloads, plugins and tips](https://torappinfo.github.io/uweb/en/)
   9 (Mirrors: [gitlab](https://jamesfengcao.gitlab.io/uweb/en/) [codeberg](https://jamesfengcao.codeberg.page/en/) [repo](https://repo.or.cz/uweb.git/blob_plain/HEAD:/en/index.html) [4everland](https://uweb.4everland.app/en/) [fleek](https://uweb.on-fleek.app/en/) [cyclic](https://muweb.cyclic.app/en/) [netlify](https://uwebzh.netlify.app/en/) [surge](https://uweb.surge.sh/en/) [kinsta](https://uwebbrowser-t27o4.kinsta.page) [zeabur](https://uweb.zeabur.app/en/) [deno](https://posh-crab-23.deno.dev/en/) [bitbucket](https://torappinfo.bitbucket.io/en/) [pages](https://muweb.pages.dev/en/) [vercel](https://uweb.vercel.app/en/) [render](https://uweb.onrender.com/en/) [glitch](https://uweb.glitch.me/en/) <a href="en/mirrors.md" onclick="if(notRepo()){location='../../en/mirrors/index.html#';return false;}">More...</a>)
  10
  11 - Powerful: any native functionality with html5 enhancement and still secure; any urls to host website; javascript and shell scripting for general processing; piping between console and GUI and more with Termux.
  12 - Customizable: user-defined menus, (new) buttons and gestures for user agents, bookmarklets, url services, shell commands, internal functionality links and text processing etc.
  13 - Convenient: Any AI chatbot/book (pdf/djvu)/dictionary (mdict)/txt/command line/app/webapp (web extensions) can be search engine.
  14 - Tiny: less than 250k.
  15 - Fast: run fast, even with thousands of user provided css/scripts/htmls.
  16 - Efficient: less touches, one click to reach any number of search engines without repeated input; automate online services.
  17 - URL bar command line support ("!" and .js file as command).
  18 - Site-specific JS/CSS/HTML/preprocessing.
  19 - Online play/preview/preprocess for downloadable resources.
  20 - Multiple type profiles: switch any data including website logins, user configurations orthogonally.
  21 - Supports enhanced user "hosts" file. Empty IP address to lift all server-imposed limitations.
  22 - Website test automation scripting. crontab support (alarm clock and more).
  23
  24 #### Main features
  25 Custom paper size PDF export and long vector screenshot, TTS, text reflow, resource sniffer, translation, reader's mode, user-defined url redirection, webdav/http backup & restore, auto next page, sending/receiving msg/file(s), site config (UA, no JS, no image, no 3rd party script/resource,active script, global scripts), http(s)/socks proxy, enabling html5 apps for local files (pdf/djvu/epub viewer, mdict dictionary lookup etc.).
  26
  27 - User-defined global and site-specific CSS and javascript.
  28 - Bookmarklets (works for CSP sites and with option to auto apply to similar sites)
  29 - AD blocking (block whole root domain trees etc.)
  30 - Customization (define extra menus/buttons/gestures with user-defined functionalities)
  31 - Support shell scripts, javascript for general processing, other languages (python etc.) are also supported by installing uweb compatible Termux versions.
  32 - Serverless local sites: PWA-kind web extension (chrome .crx & firefox .xpi) support.
  33 - Piping between console and uweb tabs.
  34 - Resizable floating video support.
  35
  36 #### Screenshots
  37 ![](https://i.postimg.cc/rsL9G5N1/home1.png)
  38 ![](https://i.postimg.cc/9QxJ3Rc2/globalcss.png)
  39 ![](https://i.postimg.cc/VksDHBQ4/globaljs.png)
  40 ![](https://i.postimg.cc/HLV3TYLy/longclick.png)
  41 ![](https://i.postimg.cc/XJ58ysdN/option1.png)
  42 ![](https://i.postimg.cc/0NFnQT6H/option2.png)
  43
  44 #### <a href="misc/ebrowser/README.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux
  45 Ebrowser is a simple version of uweb browser on the desktop.
  46 - Fully open source.
  47 - Capture long screenshot as vector graphics.
  48 - Enabling web tech for vector designing to replace Adobe Illustrator/Inkscape.
  49
  50 #### Help with localization
  51 We encourage everyone to help with localization. The following is how to do.
  52
  53 - Fork this repository
  54 - Copy res/values/strings.xml to path like res/values-%(lang)/, replace %(lang) with [the ISO 639-1 language code](http://www.loc.gov/standards/iso639-2/php/code_list.php).
  55 - Translate res/values-%(lang)/strings.xml
  56 - Translate assets/help_%(lang).html from assets/help_en.html
  57 - Make a Pull Request