Difference between revisions of "Chromium/Tips and tricks"

From ArchWiki
Jump to: navigation, search
(about: links are all converted to chrome:// links in the browser.)
(Cache in tmpfs: psd does not sync cache)
 
(116 intermediate revisions by 35 users not shown)
Line 1: Line 1:
[[Category:Web Browser]]
+
[[Category:Web browser]]
[[zh-CN:Chromium Tips and Tweaks]]
+
[[ja:Chromium 設定]]
{{Article summary start}}
+
[[zh-hans:Chromium/Tips and tricks]]
{{Article summary text|Tips and Tweaks for Chromium are captured in this article.}}
+
{{Related articles start}}
{{Article summary heading|Related}}
+
{{Related|Chromium}}
{{Article summary wiki|Chromium}}
+
{{Related|Firefox tweaks}}
{{Article summary wiki|Firefox Tweaks}}
+
{{Related articles end}}
{{Article summary end}}
 
  
 
== Browsing experience ==
 
== Browsing experience ==
Line 13: Line 12:
  
 
* '''chrome://flags''' - access experimental features such as WebGL and rendering webpages with GPU, etc.
 
* '''chrome://flags''' - access experimental features such as WebGL and rendering webpages with GPU, etc.
* '''chrome://plugins''' - view, enable and disable the currently used Chromium plugins.
+
* '''chrome://extensions''' - view, enable and disable the currently used Chromium extensions.
* '''chrome://gpu-internals''' - status of different GPU options.
+
* '''chrome://gpu''' - status of different GPU options.
 
* '''chrome://sandbox''' - indicate sandbox status.
 
* '''chrome://sandbox''' - indicate sandbox status.
 
* '''chrome://version''' - display version and switches used to invoke the active {{ic|/usr/bin/chromium}}.
 
* '''chrome://version''' - display version and switches used to invoke the active {{ic|/usr/bin/chromium}}.
Line 20: Line 19:
 
An automatically updated, complete listing of Chromium switches is available [http://peter.sh/experiments/chromium-command-line-switches/ here].
 
An automatically updated, complete listing of Chromium switches is available [http://peter.sh/experiments/chromium-command-line-switches/ here].
  
=== Broken icons in Download Tab ===
+
=== Chromium task manager ===
If Chromium shows icon placeholders (icons representing broken documents) instead of appropriate icons in its download tab, the likely cause is that the {{Pkg|gnome-icon-theme}} package is not installed.
+
Shift+ESC can be used to bring up the browser task manager wherein memory, CPU, and network usage can be viewed.
 +
 
 +
=== Broken icons in Download tab ===
 +
If Chromium shows icon placeholders (icons representing broken documents) instead of appropriate icons in its Download tab, the likely cause is that the {{Pkg|adwaita-icon-theme}} package is not installed.
  
 
=== Chromium overrides/overwrites Preferences file ===
 
=== Chromium overrides/overwrites Preferences file ===
Line 28: Line 30:
 
  $ chromium --disable-sync-preferences
 
  $ chromium --disable-sync-preferences
  
If Chromium is started in the background when you login in to your desktop environment, make sure the command your desktop environment uses is
+
If Chromium is started in the background when you login in to your desktop environment, make sure the command your desktop environment uses is:
 
  $ chromium --disable-sync-preferences --no-startup-window
 
  $ chromium --disable-sync-preferences --no-startup-window
  
=== Scroll speed of mouse wheel ===
+
=== Search engines ===
{{Note|1=As of 22-Feb-2013, upstream removed the ability of Chromium to use the --scroll-pixels flag. See [https://code.google.com/p/chromium/issues/detail?id=154776 this] for a discussion.}}
+
Make sites like [https://wiki.archlinux.org wiki.archlinux.org] and [https://en.wikipedia.org wikipedia.org] easily searchable by first executing a search on those pages, then going to ''Settings > Search'' and click the ''Manage search engines..'' button. From there, "Edit" the Wikipedia entry and change its keyword to '''w''' (or some other shortcut you prefer). Now searching Wikipedia for "Arch Linux" from the address bar is done simply by entering "'''w arch linux'''".
 
 
Arch users have the option to build the {{AUR|chromium-scroll-pixels}} package from the AUR which is identical to extra/chromium except that it contains a patch to enable the --scroll-pixels flag.  It is worth mentioning that chromium can take quite a while to compile.  [https://wiki.archlinux.org/index.php/User:Graysky Graysky] provides pre-compiled packages for both x86_64 and i686 in his unofficial repo, [[Repo-ck]].
 
 
 
The following switch can be used to set the scroll speed of the wheel mouse: {{ic|--scroll-pixels=X}}
 
 
 
$ chromium --scroll-pixels=320
 
 
 
=== Search Engines ===
 
Make sites like wiki.archlinux.org and wikipedia.org easily searchable by first executing a search on those pages, then going to ''Settings > Search'' and click the ''Manage search engines..'' button. From there, "Edit" the Wikipedia entry and change its keyword to "w" (or some other shortcut you prefer). Now searching Wikipedia for "Arch Linux" from the address bar is done simply by entering "w arch linux".
 
  
 
{{Note| Google search is used automatically when typing something into the URL bar. A hard-coded keyword trigger is also available using the '''?''' prefix.}}
 
{{Note| Google search is used automatically when typing something into the URL bar. A hard-coded keyword trigger is also available using the '''?''' prefix.}}
Line 52: Line 45:
 
  $ chromium --disk-cache-dir=/tmp/cache
 
  $ chromium --disk-cache-dir=/tmp/cache
  
Cache should be considered temporary and will '''not''' be saved after a reboot or hard lock.
+
Cache should be considered temporary and will '''not''' be saved after a reboot or hard lock. Alternatively, use:
  
Alternative way, in {{ic|/etc/fstab}}:
+
{{hc|/etc/fstab|2=
tmpfs /home/<USER>/.cache tmpfs noatime,nodev,nosuid,size=400M 0 0
+
tmpfs /home/''username''/.cache tmpfs noatime,nodev,nosuid,size=400M 0 0
 
+
}}
{{Note|Adjust the size as needed.}}
 
  
 
==== Profile in tmpfs ====
 
==== Profile in tmpfs ====
Line 66: Line 58:
 
{{AUR|profile-sync-daemon}} is such a script and is directly available from the [[AUR]]. It symlinks and syncs the browser profile directories to RAM. Refer to the [[Profile-sync-daemon]] wiki article for additional information on it.
 
{{AUR|profile-sync-daemon}} is such a script and is directly available from the [[AUR]]. It symlinks and syncs the browser profile directories to RAM. Refer to the [[Profile-sync-daemon]] wiki article for additional information on it.
  
==Profile Maintenance ==
+
===Launch a new browser instance===
Chromium uses [[Sqlite]] databases to manage history and the like. Sqlite databases become fragmented over time and empty spaces appear all around. But, since there are no managing processes checking and optimizing the database, these factors eventually result in a performance hit. A good way to improve startup and some other bookmarks and history related tasks is to defragment and trim unused space from these databases.
+
When you launch the browser, it first checks if another instance using the same profile is already running. If there is one, the new window is associated with the old instance. To prevent this, you can specifically ask the browser to run with a different profile.
  
{{AUR|profile-cleaner}} and {{AUR|browser-vacuum}} in the [[AUR]] do just this.
+
$ chromium --user-data-dir=<PATH TO A PROFILE>
 +
 
 +
{{Note|It will not work if you specify a link or even a symlink to your regular Chromium profile (typically {{ic|~/.config/chromium/Default}}). If you want to use the same profile as your current one for this new instance, first copy the folder {{ic|~/.config/chromium/Default}} to a directory of your choice, keeping the same {{ic|Default}} name, and launch the browser using the following command by specifying the parent folder of the {{ic|Default}} folder you have just copied.
 +
For example, if you copied the Default folder to {{ic|~/Downloads}}:
 +
 
 +
{{bc|1=$ chromium --user-data-dir=~/Downloads}}
 +
}}
 +
 
 +
===Directly open *.torrent files and magnet links with a torrent client===
 +
 
 +
By default, Chromium downloads {{ic|*.torrent}} files directly and you need to click the notification from the bottom-left corner of the screen in order for the file to be opened with your default torrent client. This can be avoided with the following method:
 +
 
 +
* Download a {{ic|*.torrent}} file.
 +
* Right-click the notification displayed at the bottom-left corner of the screen.
 +
* Check the "''Always Open Files of This Type''" checkbox.
 +
 
 +
See [[xdg-open]] to change the default assocation.
 +
 
 +
=== Touch Scrolling on touchscreen devices ===
 +
You may need to specify which touch device to use. Find your touchscreen device with {{ic| xinput list}} then launch Chromium with the {{ic|1=--touch-devices='''x'''}} parameter, where "'''x'''" is the id of your device. {{Note|If the device is designated as a slave pointer, using this may not work, use the master pointer's ID instead.}}
 +
 
 +
=== Reduce memory usage ===
 +
 
 +
By default, Chromium uses a separate OS process for each ''instance'' of a visited web site. [https://www.chromium.org/developers/design-documents/process-models#Supported_Models] However, you can specify command-line switches when starting Chromium to modify this behaviour.
 +
 
 +
For example, to share one process for all instances of a website:
 +
 
 +
$ chromium --process-per-site
 +
 
 +
To use a single process model:
 +
 
 +
$ chromium --single-process
 +
 
 +
{{Warning|The single-process model is discouraged because it is unsafe and may contain bugs not present in other models.[https://www.chromium.org/developers/design-documents/process-models#TOC-Single-process]}}
  
== Security ==
+
In addition, you can suspend or store inactive Tabs with extensions such as [https://chrome.google.com/webstore/detail/tab-suspender/fiabciakcmgepblmdkmemdbbkilneeeh?hl=en Tab Suspender] and [https://chrome.google.com/webstore/detail/onetab/chphlpgkkbolifaimnlloiipkdnihall?hl=en OneTab].
=== Run in a Sandbox ===
 
Run chromium in a sandbox for added security:
 
$ chromium --enable-seccomp-sandbox
 
  
 
=== User Agent===
 
=== User Agent===
By default Chromium already sends an excessively detailed User Agent, as is viewable via the EFF's [https://panopticlick.eff.org/ Panopticlick] test. That alone makes each browser readily identifiable with high accuracy — and is further exacerbated by the use of non-stable versions, ones not recently provided by Google's release channels, ones customized e.g. by a distribution (such as the AUR's {{AUR|chromium-browser-ppa}}), etc.
 
  
However, this User Agent can be arbitrarily modified at the start of Chromium's base instance via its {{Ic|<nowiki>--user-agent="[string]"</nowiki>}} parameter.
+
The User Agent can be arbitrarily modified at the start of Chromium's base instance via its {{Ic|<nowiki>--user-agent="[string]"</nowiki>}} parameter.
 +
 
 +
=== DOM Distiller ===
 +
Chromium has a similar reader mode to Firefox. In this case it's called DOM Distiller, which is an [https://github.com/chromium/dom-distiller open source project].
 +
All you need to do is run Chromium with the {{Ic|--enable-dom-distiller}} flag to unlock the "Distill page" menu option or you can even make it [[#Making flags persistent|persistent]].
 +
Not only does DOM Distiller provide a better reading experience by distilling the content of the page, it also simplifies pages for print. Even though the latter checkbox option has been removed from the print dialog, you can still print the distilled page, which basically has the same effect.
 +
 
 +
Running the upper flag, you will find a new "Distill Page" menu item.
 +
 
 +
You can reach the internal debug page by visiting {{Ic|chrome://dom-distiller}}
 +
 
 +
=== Forcing specific GPU ===
 +
 
 +
In multi-GPU systems, Chromium automatically detects which GPU should be used for rendering (discrete or integrated). This works 99% of the time, except when it doesn't - if a unavailable GPU is picked (for example, discrete graphics on VFIO GPU passthrough-enabled systems), {{ic|chrome://gpu}} will complain about not being able to initialize the GPU process. On the same page below '''Driver Information''' there'll be multiple GPUs shown (GPU0, GPU1, ...). There's no way to switch between them in a user-friendly way, but you can read the device/vendor IDs present there and configure Chromium to use a specific GPU with flags:
 +
 
 +
$ chromium --gpu-testing-vendor-id=0x8086 --gpu-testing-device-id=0x1912
 +
 
 +
...where {{ic|0x8086}} and {{ic|0x1912}} is replaced by the IDs of the GPU you want to use (as shown on the {{ic|chrome://gpu}} page).
 +
 
 +
=== Import bookmarks from Firefox ===
 +
 
 +
To ease the transition, you can import bookmarks from [[Firefox]] into Chromium.
 +
 
 +
Navigate Chromium to {{ic|chrome://settings/importData}}
 +
 
 +
If Firefox is already installed on your computer, you can directly import bookmarks as well as many other things from Firefox.
 +
 
 +
Make sure '''Mozilla Firefox''' is selected. Optionally, you can uncheck some unwanted items here. Click the '''Import''' and then '''Done'''. You're done with it.
 +
 
 +
{{note|If you haven't created any bookmarks in Chromium yet, the bookmarks will show up in your bookmarks bar. If you already have bookmarks, the bookmarks will be in a new folder labeled "Imported From Firefox"}}
 +
 
 +
If you import bookmarks from another PC, you have to export bookmarks from Firefox first.
  
For the same User Agent as the stable Chrome release for Linux i686 (at the time of writing the most popular Linux edition of Chrome) one would use:
+
{{ic|''Ctrl + Shift + O > Import and Backup > Export Bookmarks To HTML}} in Firefox''
--user-agent="Mozilla/5.0 (X11; Linux i686) AppleWebKit/535.2 (KHTML, like Gecko) Chrome/20.0.1132.47 Safari/536.11"
 
  
An official, automatically updated listing of Chromium releases which also shows the included WebKit version is available as the [https://omahaproxy.appspot.com/ OmahaProxy Viewer].
+
The procedure is pretty much the same. You need to go to {{ic|chrome://settings/importData}}. However, this time, in the '''From''' drop-down menu, select '''Bookmarks HTML File''' and click the '''Choose File''' button and upload the desired bookmark file.
  
=== Making it all persistent ===
+
== Profile maintenance ==
You can export your flags from {{ic|~/.profile}}:
+
Chromium uses [[SQLite]] databases to manage history and the like.  Sqlite databases become fragmented over time and empty spaces appear all around. But, since there are no managing processes checking and optimizing the database, these factors eventually result in a performance hit. A good way to improve startup and some other bookmarks- and history-related tasks is to defragment and trim unused space from these databases.
export CHROMIUM_USER_FLAGS="--disk-cache-dir=/tmp --disk-cache-size=50000000"
+
 
 +
{{AUR|profile-cleaner}} and {{AUR|browser-vacuum}} in the [[AUR]] do just this.
 +
 
 +
== Security ==
 +
=== WebRTC ===
 +
WebRTC is a communication protocol that relies on JavaScript that can leak one's actual IP address and hardware hash from behind a VPN. While some software may prevent the leaking scripts from running, it's probably a good idea to block this protocol directly as well, just to be safe. As of October 2016, there is no way to disable WebRTC on Chromium on desktop, there are extensions available to disable local IP address leak, one is this [https://chrome.google.com/webstore/detail/webrtc-network-limiter/npeicpdbkakmehahjeeohfdhnlpdklia extension].
  
Or add them to {{ic|/etc/chromium/default}}:
+
One can test WebRTC via [https://www.privacytools.io/webrtc.html this page].
{{bc|<nowiki>
 
# Default settings for chromium. This file is sourced by /usr/bin/chromium
 
#
 
# Options to pass to chromium
 
CHROMIUM_FLAGS="--scroll-pixels=200"</nowiki>
 
}}
 
  
Chromium will prefer the user defined flags in {{ic|CHROMIUM_USER_FLAGS}} to those defined in {{ic|/etc/chromium/default}}.
+
{{Warning|Even though IP leak can be prevented, Chromium still sends your unique hash, and there is no way to prevent this. Read more on https://www.browserleaks.com/webrtc#webrtc-disable }}
  
If you want to use {{ic|CHROMIUM_USER_FLAGS}} and Pepperflash, you should add Chromium Pepperflash arguments to your {{ic|~/.profile}} file.  
+
=== SSL certificates ===
  export CHROMIUM_USER_FLAGS="--ppapi-flash-path=/usr/lib/PepperFlash/libpepflashplayer.so --ppapi-flash-version=11.7.700.141"
+
Chromium does not have an SSL certificate manager.  It relies on the NSS Shared DB {{ic|~/.pki.nssdb}}.  In order to add SSL certificates to the database, users will have to use the shell.  
  
=== SSL Certificates ===
+
==== Adding CAcert certificates for self-signed certificates ====
Unfortunately, Chromium doesn't have a SSL certificate manager.  It relies on the NSS Shared DB {{ic|~/.pki.nssdb}}.  In order to add SSL certificates to the database, users will have to use the shell.
+
Grab the CAcerts and create an {{ic|nssdb}}, if one does not already existTo do this, first install the {{Pkg|nss}} package, then complete these steps:
  
==== Adding CAcert Certificates for Self-Signed Certificates ====
+
  $ mkdir -p $HOME/.pki/nssdb
Grab the CAcerts and create a nssdb if one does not already exist. To do this, first install the {{Pkg|nss}} package, then complete these steps:
+
$ cd $HOME/.pki/nssdb
{{bc|<nowiki>[[ ! -e $HOME/.pki/nssdb ]] && mkdir -p $HOME/.pki/nssdb && cd $HOME/.pki/nssdb && certutil -N -d sql:.</nowiki>}}
+
$ certutil -N -d sql:.
{{Note|Users will need to create a password for the database should it not exist.}}
 
  
{{bc|<nowiki>curl -k -o "cacert-root.crt" "http://www.cacert.org/certs/root.crt"
+
$ curl -k -o "cacert-root.crt" "http://www.cacert.org/certs/root.crt"
curl -k -o "cacert-class3.crt" "http://www.cacert.org/certs/class3.crt"
+
$ curl -k -o "cacert-class3.crt" "http://www.cacert.org/certs/class3.crt"
certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "CAcert.org" -i cacert-root.crt  
+
$ certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "CAcert.org" -i cacert-root.crt  
certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "CAcert.org Class 3" -i cacert-class3.crt
+
$ certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "CAcert.org Class 3" -i cacert-class3.crt
</nowiki>}}
 
  
{{Note|Users will need to create a password for the database should it not exist.}}
+
{{Note|Users will need to create a password for the database, if it does not exist.}}
  
 
Now users may manually import a self-signed certificate.
 
Now users may manually import a self-signed certificate.
  
==== Example 1: Using a Shell Script Isolate the Certificate from TomatoUSB ====
+
==== Example 1: Using a shell script to isolate the certificate from TomatoUSB ====
Below is a simple script that will extract and add a certificate to the user's nssdb:
+
Below is a simple script that will extract and add a certificate to the user's {{ic|nssdb}}:
  
 
  #!/bin/sh
 
  #!/bin/sh
Line 133: Line 181:
 
  exec > $REMHOST
 
  exec > $REMHOST
 
  echo | openssl s_client -connect ${REMHOST}:${REMPORT} 2>&1 |sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p'
 
  echo | openssl s_client -connect ${REMHOST}:${REMPORT} 2>&1 |sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p'
  certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "$REMHOST" -i $REMHOST  
+
  certutil -d sql:$HOME/.pki/nssdb -A -t "P,," -n "$REMHOST" -i $REMHOST  
 
  exec 1>&6 6>&-
 
  exec 1>&6 6>&-
  
 
Syntax is advertised in the commented lines.
 
Syntax is advertised in the commented lines.
  
Reference:
+
References:
 
*http://blog.avirtualhome.com/adding-ssl-certificates-to-google-chrome-linux-ubuntu
 
*http://blog.avirtualhome.com/adding-ssl-certificates-to-google-chrome-linux-ubuntu
 +
*https://chromium.googlesource.com/chromium/src/+/master/docs/linux_cert_management.md
  
==== Example 2: Using Firefox to Isolate the Certificate from TomatoUSB ====
+
==== Example 2: Using Firefox to isolate the certificate from TomatoUSB ====
The {{Pkg|firefox}} browser can used to save the certificate to a file for manunal import into the DB.
+
The {{Pkg|firefox}} browser can be used to save the certificate to a file for manual import into the database.
  
 
Using firefox:
 
Using firefox:
 
#Browse to the target URL.
 
#Browse to the target URL.
#Upon seeing the "This Connection is Untrusted" warning screen, click I understand the Risks>Add Exception...
+
#Upon seeing the "This Connection is Untrusted" warning screen, click: ''I understand the Risks > Add Exception...''
#Click View>Details>Export and save the certificate to a temporary location ({{ic|/tmp/easy.pem}} in this example).
+
#Click: ''View > Details > Export'' and save the certificate to a temporary location ({{ic|/tmp/easy.pem}} in this example).
  
 
Now import the certificate for use in Chromium:
 
Now import the certificate for use in Chromium:
  certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "easy" -i /tmp/easy.pem
+
  $ certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "easy" -i /tmp/easy.pem
  
{{Note|Adjust the name to match that of the certificate. In the example above, "easy" is the name on the certificate.}}
+
{{Note|Adjust the name to match that of the certificate. In the example above, "easy" is the name of the certificate.}}
  
 
Reference:
 
Reference:
 
*http://sahissam.blogspot.com/2012/06/new-ssl-certificates-for-tomatousb-and.html
 
*http://sahissam.blogspot.com/2012/06/new-ssl-certificates-for-tomatousb-and.html
  
 +
=== Canvas Fingerprinting ===
 +
Canvas fingerprinting is a technique that allows websites to identify users by detecting differences when rendering to an HTML5 canvas. This information can be made inaccessible by using the {{ic|--disable-reading-from-canvas}} flag.
 +
 +
To confirm this is working run [https://panopticlick.eff.org this test] and make sure "hash of canvas fingerprint" is reported as undetermined in the full results.
 +
 +
{{Note|Some extensions require reading from canvas and may be broken by setting {{ic|--disable-reading-from-canvas}}.}}
 +
 +
=== Privacy extensions ===
 +
 +
Popular privacy extensions for the [[Firefox]] browser are typically also available for Chromium. See [[Firefox/Privacy#Extensions]] for details.
 +
 +
{{tip|Installing too many extensions might take up much space in the toolbar. Those extensions which you wouldn't interact with anyway (e.g. [https://chrome.google.com/webstore/detail/gcbommkclmclpchllfjekcdonpmejbdp HTTPS Everywhere]) can be hide by right clicking on the extension and choosing '''Hide in Chromium menu'''.}}
 +
 +
* [https://chrome.google.com/webstore/detail/gcbommkclmclpchllfjekcdonpmejbdp HTTPS Everywhere]
 +
* [https://chrome.google.com/webstore/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm?hl=en uBlock Origin]
 +
* [https://chrome.google.com/webstore/detail/adblock-plus/cfhdojbkjhnklbpkdaibdccddilifddb?hl=en Adblock Plus]
 +
* [https://chrome.google.com/webstore/detail/privacy-badger/pkehgijcmpdhfbdbbnkijodmdjhbjlgp?hl=en Privacy Badger]
 +
* [https://chrome.google.com/webstore/detail/disconnect/jeoacafpbcihiomhlakheieifhpjdfeo?hl=en Disconnect]
 +
* [https://chrome.google.com/webstore/detail/decentraleyes/ldpochfccmkkmhdbclfhpagapcfdljkj?hl=en Decentraleyes]
 +
 +
==== ScriptBlock ====
 +
ScriptBlock is similar to NoScript, which is a Firefox add-on. Both extensions stop a website from executing any kind of JavaScript. However, ScriptBlock is a much simpler design thus it's easier to use. It blocks JavaScript by default. You can allow and temporary allow JavaScripts. Once you allow them to run, it lets all the JavaScripts run on that page so you might want ScriptBlock to work in conjunction with [https://chrome.google.com/webstore/detail/privacy-badger/pkehgijcmpdhfbdbbnkijodmdjhbjlgp?hl=en Privacy Badger].
 +
 +
It's also worth checking it's default whitelist, which might be permissive to you.
 +
 +
Extension is available in the Chrome Web Store: [https://chrome.google.com/webstore/detail/scriptblock/hcdjknjpbnhdoabbngpmfekaecnpajba?hl=en-US ScriptBlock]
 +
 +
{{Style|Copy paste from github}}
 +
 +
==== ScriptSafe ====
 +
 +
ScriptSafe is a browser extension that gives users control of the web and more secure browsing while emphasizing simplicity and intuitiveness.
 +
 +
{{Note|Due to the nature of this extension, this will break most sites! It is designed to learn over time with sites that you allow.}}
 +
 +
Check it on [https://github.com/andryou/scriptsafe GitHub]
 +
 +
Extension is available in the Chrome Web Store: [https://chrome.google.com/webstore/detail/scriptsafe/oiigbmnaadbkfbmpbfijlflahbdbdgdf?hl=en ScriptSafe]
 +
 +
==== Vanilla Cookie Manager ====
 +
 +
A Cookie Whitelist Manager for Chrome that helps protect your privacy. Automatically removes unwanted cookies. Cookies can be used for authentication, storing your site preferences or anything else that can be saved as text data. Unfortunately they can also be used to track you.
 +
 +
You could turn off cookies completely or just shut off third-party cookies. But that would also keep out useful cookies that many web apps rely upon to work (like Google Mail or Calendar).
 +
 +
With Vanilla you can select which cookies you want to keep on a whitelist. All unwanted cookies are deleted automatically (or manually if you prefer).
 +
 +
Vanilla Cookie Manager on [https://github.com/laktak/vanilla-chrome GitHub]
 +
 +
Extension is available in the Chrome Web Store: [https://chrome.google.com/webstore/detail/vanilla-cookie-manager/gieohaicffldbmiilohhggbidhephnjj Vanilla Cookie Manager]
 +
 +
=== Do Not Track ===
 +
 +
Chromium's 'Do Not Track' option is turned off by default.
 +
To enable it, visit {{ic|chrome://settings}}, scroll down to '''Show advanced settings...''' and under '''Privacy''', check '''Send a "Do Not Track" request with your browsing traffic'''.
 +
{{note|DNT isn't going to stop all web tracking. So even if you turn this feature on, your data may be still collected and analyzed.}}
 +
 +
== Making flags persistent ==
 +
{{Note|The {{ic|chromium-flags.conf}} file and the accompanying custom launcher script are specific to the Arch Linux {{Pkg|chromium}} package.}}
 +
 +
You can put your flags in a {{ic|chromium-flags.conf}} file under {{ic|$HOME/.config/}} (or under {{ic|$XDG_CONFIG_HOME}} if you have configured that environment variable).
 +
 +
No special syntax is used; flags are defined as if they were written in a terminal.
 +
 +
* The arguments are split on whitespace and shell quoting rules apply, but no further parsing is performed.
 +
* In case of improper quoting anywhere in the file, a fatal error is raised.
 +
* Flags can be placed in separate lines for readability, but this is not required.
 +
* Lines starting with a hash symbol (#) are skipped.
 +
 +
Below is an example {{ic|chromium-flags.conf}} file that defines the flags {{ic|--start-maximized --incognito}}:
 +
 +
# This line will be ignored.
 +
--start-maximized
 +
--incognito
  
 
== See also ==
 
== See also ==
 +
 
* [[Profile-sync-daemon]] - Systemd service that saves Chromium profile in tmpfs and syncs to disk
 
* [[Profile-sync-daemon]] - Systemd service that saves Chromium profile in tmpfs and syncs to disk
* [[Tmpfs#tmpfs|Tmpfs]] - Tmpfs Filesystem in {{ic|/etc/fstab}}
+
* [[Tmpfs]] - Tmpfs Filesystem in {{ic|/etc/fstab}}
 
* [https://www.kernel.org/doc/Documentation/filesystems/tmpfs.txt Official tmpfs kernel Documentation]
 
* [https://www.kernel.org/doc/Documentation/filesystems/tmpfs.txt Official tmpfs kernel Documentation]

Latest revision as of 20:51, 25 May 2017

Related articles

Browsing experience

chrome://xxx

A number of tweaks can be accessed via typing chrome://xxx in the URL field. A complete list is available by typing chrome://chrome-urls into the URL field. Some of note are listed below:

  • chrome://flags - access experimental features such as WebGL and rendering webpages with GPU, etc.
  • chrome://extensions - view, enable and disable the currently used Chromium extensions.
  • chrome://gpu - status of different GPU options.
  • chrome://sandbox - indicate sandbox status.
  • chrome://version - display version and switches used to invoke the active /usr/bin/chromium.

An automatically updated, complete listing of Chromium switches is available here.

Chromium task manager

Shift+ESC can be used to bring up the browser task manager wherein memory, CPU, and network usage can be viewed.

Broken icons in Download tab

If Chromium shows icon placeholders (icons representing broken documents) instead of appropriate icons in its Download tab, the likely cause is that the adwaita-icon-theme package is not installed.

Chromium overrides/overwrites Preferences file

If you enabled syncing with a Google Account, then Chromium will override any direct edits to the Preferences file found under $HOME/.config/chromium/Default/Preferences. To work around this, start Chromium with the --disable-sync-preferences switch:

$ chromium --disable-sync-preferences

If Chromium is started in the background when you login in to your desktop environment, make sure the command your desktop environment uses is:

$ chromium --disable-sync-preferences --no-startup-window

Search engines

Make sites like wiki.archlinux.org and wikipedia.org easily searchable by first executing a search on those pages, then going to Settings > Search and click the Manage search engines.. button. From there, "Edit" the Wikipedia entry and change its keyword to w (or some other shortcut you prefer). Now searching Wikipedia for "Arch Linux" from the address bar is done simply by entering "w arch linux".

Note: Google search is used automatically when typing something into the URL bar. A hard-coded keyword trigger is also available using the ? prefix.

Tmpfs

Cache in tmpfs

Note: Chromium actually keeps its cache directory separate from its browser profile directory.

To limit Chromium from writing its cache to a physical disk, one can define an alternative location via the --disk-cache-dir=/foo/bar flag:

$ chromium --disk-cache-dir=/tmp/cache

Cache should be considered temporary and will not be saved after a reboot or hard lock. Alternatively, use:

/etc/fstab
tmpfs	/home/username/.cache	tmpfs	noatime,nodev,nosuid,size=400M	0	0

Profile in tmpfs

Relocate the browser profile to a tmpfs filesystem, including /tmp, or /dev/shm for improvements in application response as the entire profile is now stored in RAM.

Use an active profile management script for maximal reliability and ease of use.

profile-sync-daemonAUR is such a script and is directly available from the AUR. It symlinks and syncs the browser profile directories to RAM. Refer to the Profile-sync-daemon wiki article for additional information on it.

Launch a new browser instance

When you launch the browser, it first checks if another instance using the same profile is already running. If there is one, the new window is associated with the old instance. To prevent this, you can specifically ask the browser to run with a different profile.

$ chromium --user-data-dir=<PATH TO A PROFILE>
Note: It will not work if you specify a link or even a symlink to your regular Chromium profile (typically ~/.config/chromium/Default). If you want to use the same profile as your current one for this new instance, first copy the folder ~/.config/chromium/Default to a directory of your choice, keeping the same Default name, and launch the browser using the following command by specifying the parent folder of the Default folder you have just copied.

For example, if you copied the Default folder to ~/Downloads:

$ chromium --user-data-dir=~/Downloads

Directly open *.torrent files and magnet links with a torrent client

By default, Chromium downloads *.torrent files directly and you need to click the notification from the bottom-left corner of the screen in order for the file to be opened with your default torrent client. This can be avoided with the following method:

  • Download a *.torrent file.
  • Right-click the notification displayed at the bottom-left corner of the screen.
  • Check the "Always Open Files of This Type" checkbox.

See xdg-open to change the default assocation.

Touch Scrolling on touchscreen devices

You may need to specify which touch device to use. Find your touchscreen device with xinput list then launch Chromium with the --touch-devices=x parameter, where "x" is the id of your device.
Note: If the device is designated as a slave pointer, using this may not work, use the master pointer's ID instead.

Reduce memory usage

By default, Chromium uses a separate OS process for each instance of a visited web site. [1] However, you can specify command-line switches when starting Chromium to modify this behaviour.

For example, to share one process for all instances of a website:

$ chromium --process-per-site

To use a single process model:

$ chromium --single-process
Warning: The single-process model is discouraged because it is unsafe and may contain bugs not present in other models.[2]

In addition, you can suspend or store inactive Tabs with extensions such as Tab Suspender and OneTab.

User Agent

The User Agent can be arbitrarily modified at the start of Chromium's base instance via its --user-agent="[string]" parameter.

DOM Distiller

Chromium has a similar reader mode to Firefox. In this case it's called DOM Distiller, which is an open source project. All you need to do is run Chromium with the --enable-dom-distiller flag to unlock the "Distill page" menu option or you can even make it persistent. Not only does DOM Distiller provide a better reading experience by distilling the content of the page, it also simplifies pages for print. Even though the latter checkbox option has been removed from the print dialog, you can still print the distilled page, which basically has the same effect.

Running the upper flag, you will find a new "Distill Page" menu item.

You can reach the internal debug page by visiting chrome://dom-distiller

Forcing specific GPU

In multi-GPU systems, Chromium automatically detects which GPU should be used for rendering (discrete or integrated). This works 99% of the time, except when it doesn't - if a unavailable GPU is picked (for example, discrete graphics on VFIO GPU passthrough-enabled systems), chrome://gpu will complain about not being able to initialize the GPU process. On the same page below Driver Information there'll be multiple GPUs shown (GPU0, GPU1, ...). There's no way to switch between them in a user-friendly way, but you can read the device/vendor IDs present there and configure Chromium to use a specific GPU with flags:

$ chromium --gpu-testing-vendor-id=0x8086 --gpu-testing-device-id=0x1912

...where 0x8086 and 0x1912 is replaced by the IDs of the GPU you want to use (as shown on the chrome://gpu page).

Import bookmarks from Firefox

To ease the transition, you can import bookmarks from Firefox into Chromium.

Navigate Chromium to chrome://settings/importData

If Firefox is already installed on your computer, you can directly import bookmarks as well as many other things from Firefox.

Make sure Mozilla Firefox is selected. Optionally, you can uncheck some unwanted items here. Click the Import and then Done. You're done with it.

Note: If you haven't created any bookmarks in Chromium yet, the bookmarks will show up in your bookmarks bar. If you already have bookmarks, the bookmarks will be in a new folder labeled "Imported From Firefox"

If you import bookmarks from another PC, you have to export bookmarks from Firefox first.

Ctrl + Shift + O > Import and Backup > Export Bookmarks To HTML in Firefox

The procedure is pretty much the same. You need to go to chrome://settings/importData. However, this time, in the From drop-down menu, select Bookmarks HTML File and click the Choose File button and upload the desired bookmark file.

Profile maintenance

Chromium uses SQLite databases to manage history and the like. Sqlite databases become fragmented over time and empty spaces appear all around. But, since there are no managing processes checking and optimizing the database, these factors eventually result in a performance hit. A good way to improve startup and some other bookmarks- and history-related tasks is to defragment and trim unused space from these databases.

profile-cleanerAUR and browser-vacuumAUR in the AUR do just this.

Security

WebRTC

WebRTC is a communication protocol that relies on JavaScript that can leak one's actual IP address and hardware hash from behind a VPN. While some software may prevent the leaking scripts from running, it's probably a good idea to block this protocol directly as well, just to be safe. As of October 2016, there is no way to disable WebRTC on Chromium on desktop, there are extensions available to disable local IP address leak, one is this extension.

One can test WebRTC via this page.

Warning: Even though IP leak can be prevented, Chromium still sends your unique hash, and there is no way to prevent this. Read more on https://www.browserleaks.com/webrtc#webrtc-disable

SSL certificates

Chromium does not have an SSL certificate manager. It relies on the NSS Shared DB ~/.pki.nssdb. In order to add SSL certificates to the database, users will have to use the shell.

Adding CAcert certificates for self-signed certificates

Grab the CAcerts and create an nssdb, if one does not already exist. To do this, first install the nss package, then complete these steps:

$ mkdir -p $HOME/.pki/nssdb
$ cd $HOME/.pki/nssdb
$ certutil -N -d sql:.
$ curl -k -o "cacert-root.crt" "http://www.cacert.org/certs/root.crt"
$ curl -k -o "cacert-class3.crt" "http://www.cacert.org/certs/class3.crt"
$ certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "CAcert.org" -i cacert-root.crt 
$ certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "CAcert.org Class 3" -i cacert-class3.crt
Note: Users will need to create a password for the database, if it does not exist.

Now users may manually import a self-signed certificate.

Example 1: Using a shell script to isolate the certificate from TomatoUSB

Below is a simple script that will extract and add a certificate to the user's nssdb:

#!/bin/sh
#
# usage:  import-cert.sh remote.host.name [port]
#
REMHOST=$1
REMPORT=${2:-443}
exec 6>&1
exec > $REMHOST
echo | openssl s_client -connect ${REMHOST}:${REMPORT} 2>&1 |sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p'
certutil -d sql:$HOME/.pki/nssdb -A -t "P,," -n "$REMHOST" -i $REMHOST 
exec 1>&6 6>&-

Syntax is advertised in the commented lines.

References:

Example 2: Using Firefox to isolate the certificate from TomatoUSB

The firefox browser can be used to save the certificate to a file for manual import into the database.

Using firefox:

  1. Browse to the target URL.
  2. Upon seeing the "This Connection is Untrusted" warning screen, click: I understand the Risks > Add Exception...
  3. Click: View > Details > Export and save the certificate to a temporary location (/tmp/easy.pem in this example).

Now import the certificate for use in Chromium:

$ certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "easy" -i /tmp/easy.pem
Note: Adjust the name to match that of the certificate. In the example above, "easy" is the name of the certificate.

Reference:

Canvas Fingerprinting

Canvas fingerprinting is a technique that allows websites to identify users by detecting differences when rendering to an HTML5 canvas. This information can be made inaccessible by using the --disable-reading-from-canvas flag.

To confirm this is working run this test and make sure "hash of canvas fingerprint" is reported as undetermined in the full results.

Note: Some extensions require reading from canvas and may be broken by setting --disable-reading-from-canvas.

Privacy extensions

Popular privacy extensions for the Firefox browser are typically also available for Chromium. See Firefox/Privacy#Extensions for details.

Tip: Installing too many extensions might take up much space in the toolbar. Those extensions which you wouldn't interact with anyway (e.g. HTTPS Everywhere) can be hide by right clicking on the extension and choosing Hide in Chromium menu.

ScriptBlock

ScriptBlock is similar to NoScript, which is a Firefox add-on. Both extensions stop a website from executing any kind of JavaScript. However, ScriptBlock is a much simpler design thus it's easier to use. It blocks JavaScript by default. You can allow and temporary allow JavaScripts. Once you allow them to run, it lets all the JavaScripts run on that page so you might want ScriptBlock to work in conjunction with Privacy Badger.

It's also worth checking it's default whitelist, which might be permissive to you.

Extension is available in the Chrome Web Store: ScriptBlock

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements.Tango-edit-clear.png

Reason: Copy paste from github (Discuss in Talk:Chromium/Tips and tricks#)

ScriptSafe

ScriptSafe is a browser extension that gives users control of the web and more secure browsing while emphasizing simplicity and intuitiveness.

Note: Due to the nature of this extension, this will break most sites! It is designed to learn over time with sites that you allow.

Check it on GitHub

Extension is available in the Chrome Web Store: ScriptSafe

Vanilla Cookie Manager

A Cookie Whitelist Manager for Chrome that helps protect your privacy. Automatically removes unwanted cookies. Cookies can be used for authentication, storing your site preferences or anything else that can be saved as text data. Unfortunately they can also be used to track you.

You could turn off cookies completely or just shut off third-party cookies. But that would also keep out useful cookies that many web apps rely upon to work (like Google Mail or Calendar).

With Vanilla you can select which cookies you want to keep on a whitelist. All unwanted cookies are deleted automatically (or manually if you prefer).

Vanilla Cookie Manager on GitHub

Extension is available in the Chrome Web Store: Vanilla Cookie Manager

Do Not Track

Chromium's 'Do Not Track' option is turned off by default. To enable it, visit chrome://settings, scroll down to Show advanced settings... and under Privacy, check Send a "Do Not Track" request with your browsing traffic.

Note: DNT isn't going to stop all web tracking. So even if you turn this feature on, your data may be still collected and analyzed.

Making flags persistent

Note: The chromium-flags.conf file and the accompanying custom launcher script are specific to the Arch Linux chromium package.

You can put your flags in a chromium-flags.conf file under $HOME/.config/ (or under $XDG_CONFIG_HOME if you have configured that environment variable).

No special syntax is used; flags are defined as if they were written in a terminal.

  • The arguments are split on whitespace and shell quoting rules apply, but no further parsing is performed.
  • In case of improper quoting anywhere in the file, a fatal error is raised.
  • Flags can be placed in separate lines for readability, but this is not required.
  • Lines starting with a hash symbol (#) are skipped.

Below is an example chromium-flags.conf file that defines the flags --start-maximized --incognito:

# This line will be ignored.
--start-maximized
--incognito

See also