.. _pureos_troubleshooting_browser: Web Browser =========== .. _pureos_troubleshooting_browser_firefox_high_cpu: Firefox ESR consumes excessive CPU ---------------------------------- **Problem** Firefox ESR shows high CPU usage. **Solution** Try to enable hardware acceleration: #. Open a new tab in Firefox ESR #. Navigate to about:config #. Accept the warning to continue #. Search for ``vaapi`` (Video Acceleration API) #. Change the flag to ``true`` (from ``false``) #. Fully close and restart Firefox ESR .. note:: Make sure you have the ``gstreamer1.0-vaapi`` package installed. .. _pureos_troubleshooting_browser_purebrowser_to_firefox: PureBrowser to Firefox ESR -------------------------- This guide describes the migration from a PureBrowser Profile (bookmarks, history, addons, etc) into Firefox ESR. Method 1 (Command Line) """"""""""""""""""""""" #. Launch PureBrowser #. Click the menu button on the top right - Help - Troubleshooting Information. The Troubleshooting Information tab will open. Your Profile Directory will be listed under the Application Basics section. Take note of path to the profile directory: ``/home/USER/.purism/purebrowser/USERSTRING.default`` * If you have already migrated to Firefox, run ``cd ~/.purism/purebrowser/`` and ``ls -al``. This will list all files and directories. The directory named ``USERSTRING.default`` is the one you are looking for. * If you have multiple ``USERSTRING.default``, find the one with the date of the last time you used PureBrowser. #. Open a terminal emulator and run ``cd ~/.purism/purebrowser/`` and find the ``USERSTRING.default`` directory. #. Run the update in Software, or apt, to now migrate to Firefox ESR. #. Run ``cp -r USERSTRING.default ~/.mozilla/firefox/`` to move the profile folder. #. Now run ``firefox -P`` #. Select **Create Profile** and then **Next** #. Enter a profile name or leave as it. Then select **Choose Folder**. #. Click on your the ``USERSTRING.default`` directory that you just moved over and press **Open**. #. Click **Finish** and **Start Firefox**. #. Firefox should load with all the tabs you had open before and everything else will have come over from PureBrowser. You are done! .. note:: If wanting to use a search engine other than Google, you'll need to go into the menu button on the top right - Preferences - Search - select your Search Engine of choice from the drop down. .. note:: We have transitioned from uBlock Origin to EFF's Privacy Badger. That should be the only difference in addons you see. .. seealso:: `Mozilla Firefox Knowledge Base `_ Method 2 (GUI) """""""""""""" Another way to relocate your old Purebrowser profile to the new Firefox one is to move certain parts of the Purebrowser profile folder to Firefox: #. Open your Files manager in your ``home`` folder and press ``Ctrl+h``. This will show you the hidden folders. .. tip:: Hidden folders/files always start with a ``.`` before the name. You will see the folders ``.purism`` and ``.mozilla`` .. image:: ../img/firefox-esr/nautilus-dotfiles.png :scale: 50% :alt: .purism and .mozilla folders in nautilus .. caution:: Make a copy of both these folders as a backup before proceeding. #. Close **Firefox** if it is open. If you need to have access to this tutorial during this process then, print this page as a PDF. #. Open the ``.mozilla`` folder, then ``Firefox``, then open the folder that has a name ending in ``default-esr`` #. Delete the content of the folder that has a name ending in ``default-esr`` but do not delete the folder itself. .. image:: ../img/firefox-esr/delete-profile-contents.png :scale: 50% :alt: Deleting folder contents #. Open the folder ``.purism`` and then ``purebrowser`` and you will see a folder that also has a name that ends in ``default``. Copy the contents of that folder to inside the folder ``default-esr`` in ``.mozilla/firefox/somestring.default-esr``. #. Restart Firefox. You should now see: .. image:: ../img/firefox-esr/new-firefox-tab.png :scale: 50% :alt: Firefox-ESR .. note:: Firefox uses Google as its default search engine. We recommand you select DuckDuckGo to replace Google as the default search engine. .. _pureos_troubleshooting_browser_firefox_compat: Firefox compatibility mode -------------------------- Cannot install Firefox add-ons Enable Firefox Compatibility Mode to install add-ons from `Mozilla add-ons website `_. .. note:: You can search for web extensions available from the PureOS repo by running ``apt search webext`` in a terminal emulator. #. Open **PureBrowser** and type ``about:config`` into the location bar, then press ``Enter``. A warning will appear: .. image:: ../img/firefox-esr/ff1.png :scale: 50% :alt: firefox-esr warning #. Click the **I'll be careful, I promise!** button. #. Type **//useragent.compat//** into the search bar. #. Double-click the preference to change its value to ``true``: .. image:: ../img/firefox-esr/ff2.png :scale: 50% :alt: firefox-esr useragent setting .. note:: This is already set to ``true`` in recent versions of PureBrowser, so you don't have to change it. #. Change your `useragent string `_ to install Firefox addons. #. Open ``about:config`` #. Right-click and select **New** -> **String** #. Within ``general.useragent.override``, enter ``Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/68.0.2`` as a string value. #. Click **Okay** and reload the page. .. _pureos_troubleshooting_browser_purebrowser_first_start: Testing PureBrowser first start issues -------------------------------------- **Question** I noticed an issue with PureBrowser the first time I started it and reported it. Since then I have been using PureBrowser and modified my browser profile such that the issue no longer occurs. An update has landed and I want to confirm the fix. How can I do this without losing my new profile settings? **Answer** You can create a fresh profile. Launch PureBrowser, then delete the profile: #. Close any running instances of PureBrowser #. Start with ``purebrowser --ProfileManager`` #. In the profile manager window, create a new profile "temp" #. Click **Start PureBrowser** You can now test for the first-start issue. When you are done... #. Close any running instances #. Start with ``urebrowser --ProfileManager`` #. Delete the profile "temp" (delete profile and files) #. Close the profile manager window