Jump to content

Chromium: Difference between revisions

From postmarketOS Wiki
Alpabrz (talk | contribs)
m Wayland support: Add disclaimer, related issue + minor wording change.
change to issue template
 
(7 intermediate revisions by 6 users not shown)
Line 1: Line 1:
This page explains how to make chromium usable in mobile UIs like plasma-mobile.
This page explains how to make chromium usable in mobile UIs like Plasma Mobile.
[[File:Wikipedia.jpg|thumb|right|frame|none|alt=Alt text|Chromium running on plasma-mobile]]
[[File:Wikipedia.jpg|thumb|right|frame|none|alt=Alt text|Chromium running on Plasma Mobile]]
=== Installation ===
=== Installation ===
Install chromium package from alpine.  
Install chromium package from alpine. The armv7 package is not available anymore (another solution for this architecture is to compile Chromium or use an alternate web browser: https://wiki.postmarketos.org/wiki/Web_browsers).


=== Configure startup (scale + useragent) ===
=== Configure startup (scale + useragent) ===
Edit  '''/usr/share/applications/chromium.desktop''' and set the following line:
Edit  '''/usr/share/applications/chromium.desktop''' and set the following line:


<source lang="C">Exec= chromium-browser %U --start-maximized  --user-agent="Mozilla/5.0 (Linux; Android 4.4.2; Nexus 5 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/32.0.1700.99 Mobile Safari/537.36"</source>
<syntaxhighlight lang="C">Exec= chromium-browser %U --start-maximized  --user-agent="Mozilla/5.0 (Linux; Android 4.4.2; Nexus 5 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/32.0.1700.99 Mobile Safari/537.36"</syntaxhighlight>


You may adapt scale and useragent to your needs.
You may adapt scale and useragent to your needs.
Line 24: Line 24:


=== On-screen keyboard ===
=== On-screen keyboard ===
Currently on-screen keyboard does not work with plasma-mobile (see [https://gitlab.com/postmarketOS/pmaports/issues/108]).
Currently, the on-screen keyboard does not work with Plasma Mobile (see {{issue|108|pmaports}}).
You may install this extension to get a virtual keyboard nevertheless (though it does not work with every website):
You may install this extension to get a virtual keyboard nevertheless (though it does not work with every website):


Line 31: Line 31:


=== Scroll-bar ===
=== Scroll-bar ===
Access "chrome://flags". To do that type it in the plasma-mobile search bar (on home screen), and then copy and paste it in the chromium url bar.
Access "chrome://flags". To do that type it in the Plasma Mobile search bar (on home screen), and then copy and paste it in the chromium url bar.


Enable the following flags:
Enable the following flags:

Latest revision as of 09:19, 3 November 2024

This page explains how to make chromium usable in mobile UIs like Plasma Mobile.

Alt text
Chromium running on Plasma Mobile

Installation

Install chromium package from alpine. The armv7 package is not available anymore (another solution for this architecture is to compile Chromium or use an alternate web browser: https://wiki.postmarketos.org/wiki/Web_browsers).

Configure startup (scale + useragent)

Edit /usr/share/applications/chromium.desktop and set the following line:

Exec= chromium-browser %U --start-maximized  --user-agent="Mozilla/5.0 (Linux; Android 4.4.2; Nexus 5 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/32.0.1700.99 Mobile Safari/537.36"

You may adapt scale and useragent to your needs.

Wayland

Note Expect issues since Ozone (which enables Wayland support) is still in development!

There have been problems reported using Chromium under XWayland, getting cannot open display: :0 errors.

As described in the ArchWiki, since version 87 you should be able to use Chromium's native wayland support through the following flags:

$ chromium-browser --enable-features=UseOzonePlatform --ozone-platform=wayland

You might want to make these arguments persistent through adding them to the desktop file, located under /usr/share/applications/chromium.desktop.

Related issue: pmaports#998

On-screen keyboard

Currently, the on-screen keyboard does not work with Plasma Mobile (see pmaports#108). You may install this extension to get a virtual keyboard nevertheless (though it does not work with every website):

Scroll-bar

Access "chrome://flags". To do that type it in the Plasma Mobile search bar (on home screen), and then copy and paste it in the chromium url bar.

Enable the following flags:

  • Smooth Scrolling
  • Overlay Scrollbars
  • Scroll prediction

This will allow to have a good scrolling experience, and hide scrollbar, so that it does not take screen-space.