README.md

Forked from - Original Script made by L.Xavier

Mobile browser Gestures Extended (MbGE)

Add customizable touch and swipe gestures to mobile browsers. Recommended use with Kiwi browser, Yandex browser and Lemur Browser.

• This is primarily an English translation but also offers slight modifications.
• Translation was 100% created with the use of Google translate + resonable/safe judgements and careful selection to ensure consistent variable/function names.
• Translations may not be fully accurate, but are more than sufficient to navigate through the majority, if not the entire script.

---

VERSIONS

MbGE: English-translated + Custom modifications:	Original but English-translated:	Original script:
\MbGE\MbGE.js	\@Translated_to_English\English_Translated.js	\@Original\Original.js
Custom Modifications include: Changing New page from Limestart.cn to Chrome://newtab Changing Baidu translate to Google translate(Text gesture) Changing Youdao translate to Youtube search(Text gesture) Changing Query search from Bing search to Google search(Text gesture) Changing Baidu image search to Google image search(Image gesture) Changing Video forward/backward 10 seconds to Video forward/backward 5 seconds(Video gesture) Removed Analyze video function that opened videos in jx.jsonplayer site as it didn't work to begin with and I had no use for it.

Download via Greasy Fork:

MbGE: English-translated + Custom modifications

or

Original but English-translated

Install/Setup instructions

1. Install Tampermonkey extension(or other userscript managers like Greasemonkey, Violentmonkey, etc.)

   • If comfortable with it, I recommend turning on "Allow access to file URLs" for best experience as it will allow the script to work on more pages and on built-in chrome video player. On chromium browsers this can be done by going to extensions via 'chrome://extensions' url in address bar, then go to Tampermonkey(or userscript manager of choice) Details and toggle on "Allow access to file URLs".

2. Choose preferred script version based off of descriptions in VERSIONS table
   Install preferred script version via Greasy Fork links

3. If needed refresh old tabs for script to run on it

4. Slide the "↑→↓←" box gesture to open the [Gesture Track Setting] interface, and you can customize the gesture function

MbGE.mp4

How to navigate settings ui:

(Open image in new tab or download image to zoom in)

6. You can click the title of "Gesture track settings" to open the "Function switch settings" interface
7. You can modify the settings however you like but can't delete the following:
   • Open settings
   • Video full screen
   • Gesture penetration

After making changes to settings, if needed refresh old tabs to see applied changes.

If wanted, use my custom settings from '\MbGE\MyCustom_Settings_1.jpg' and '\MbGE\MyCustom_Settings_2.jpg'.

Gesture Icon Legend:

Icon	Gesture
T	Text gesture
I	Image gesture
V	Video gesture
↑	Slide up
↓	Slide down
→	Slide right
←	Slide left
◆	Click, triggers after clicking
●	Long press, triggers during long press
○	Lift corresponding ● gesture, triggers after lifting
▼	Lengthy slide in the same direction, triggers after 400ms of continuous sliding
▽	Lift corresponding ▼ gesture, triggers after lifting

Default mapped gestures in MbGE:

Gesture (36)	Function
↑→↓←	Open settings
◆◆	Video full screen
●	Gesture penetration
→←	Back
←→	Forward
↓↑	Back to top
↑↓	Back to bottom
←↓	Refresh page
←↑	New page
→↓	Close page
→↑	Restore page
↓↑●	Open in new page
↑↓●	Hide element
↓→	Duplicate page
→←→	Half screen mode
T→↑	Google translate
T←↑	YouTube search
T◆◆	Query search
I↓↑●	Open image source
I→↑●	Google image search
V→	Forward 5s
V←	Back 5s
V↑	Increase speed
V↓	Decrease speed
V→●	Fast forward playback
V→○	Release fast forwarding
V←●	Rewind playback
V←○	Release rewinding
V↑●	Volume increase
V↑○	Release volume increase
V↓●	Volume decrease
V↓○	Release volume decrease
V→▼	Progress
V→▽	Release progress
V←▼	Regress
V←▽	Release regress

Default mapped gestures in Original but English-translated:

Gesture (37)	Function
↑→↓←	Open settings
◆◆	Video full screen
●	Gesture penetration
→←	Back
←→	Forward
↓↑	Back to top
↑↓	Back to bottom
←↓	Refresh page
←↑	New page
→↓	Close page
→↑	Restore page
↓↑●	Open in new page
↑↓●	Hide element
↓→	Duplicate page
→←→	Half screen mode
→↓↑←	Analyze video
T→↑	Baidu translate
T←↑	Youdao translate
T◆◆	Query search
I↓↑●	Open image source
I→↑●	Baidu image search
V→	Forward 10s
V←	Back 10s
V↑	Increase speed
V↓	Decrease speed
V→●	Fast forward playback
V→○	Release fast forwarding
V←●	Rewind playback
V←○	Release rewinding
V↑●	Volume increase
V↑○	Release volume increase
V↓●	Volume decrease
V↓○	Release volume decrease
V→▼	Progress
V→▽	Release progress
V←▼	Regress
V←▽	Release regress

How to reset to default settings

Even if you replace the script text with the initial script text, the old settings will probably stick.
This is because the script is still holding onto it's storage content.

The easiest way to remove the old settings is to go to Tampermonkey's dashboard and delete the script with the trash bin icon or File/Remove and then reinstall the initial script.

Gesture Functions/UI (MbGE)

General:

Open settings Video full screen Gesture penetration

Navigation:

Back Forward Back to top Back to bottom Refresh page
New page Close page Restore page Open in new page Hide element Duplicate page Half screen mode

Text/Image:

Google translate YouTube search Query search
Open image source Google image search

Video:

Forward 5s Back 5s
Increase speed Decrease speed
Fast forward playback Release fast forwarding Rewind playback Release rewinding
Volume increase Release volume increase Volume decrease Release volume decrease
Progress Release progress Regress Release regress

Known Issues

Issues:

• If image gestures is on, long press on images won't show regular context menu.
• Even if configured without it, image gestures always start with Gesture penetration(default is long press) and so will require it at first to get image gestures triggered.
• Video fullscreen function will work even if video gestures is disabled.
  • This may be resolvable by turning the function into a video gesture by manually adding the a "V" to the '◆◆': 'Video full screen', line in the script. But this has not been tested and may not work or break certain functionality.
• Breaks tap and slide up/down to zoom functionality when in desktop mode.

Quirks:

• Slide up/down gestures on videos will only trigger if video is fullscreen. Although this is probably for the best.

Other Recommendations

While MbGE is a powerful tool, sometimes having to remember too many gestures can be a hassle or an inconvenience. Or perhaps you wish you could access some shortcuts faster in a tap of a button instead of a more convoluted gesture combination. For this reason I use MbGE in combination with 2 other chromium extensions designed for mobile browsers:

• Mobile Toolbar For Kiwi Browser (Open Source)
• Floatly (Open Source)

Both of these can work well by themselves and have some of the shortcuts that MbGE has (Floaty in particular has a few different shortcuts that are not in MbGE). They both have their strengths and while I won't be fully documenting all their features here, I have made a video showcasing SOME of their features (Floaty in particular has way more features than I showcased). I recommend checking both of them out via the links above. The video below is how I use both extensions together in Kiwi Browser:

Click here to see video:

← This is Mobile Toolbar For Kiwi Browser.

← This is Floaty (I positioned it to lay on top of Mobile Toolbar For Kiwi Browser' refresh button).

← This is both of the extensions together.

Mobile.Toolbar.For.Kiwi.Browser.+.Floaty.mp4