.. _software_pureos_tips_nautilus_extension:

File manager extensions
=======================

.. _software_pureos_tips_nautilus_extension_overview:

Overview
--------

This document illustrates how to add functionality to ``nautilus``, the GNOME desktop's default file manager.

.. _software_pureos_tips_nautilus_extension_support:

Supported extensions
--------------------

**Files** is the genericized name for the ``nautilus`` file manager application.
Several extensions are available for this file manager, which can be used to expand its functionality.
For example, with an extension, you may right-click a file and choose an option within a context menu to send it to a recipient via email.

The following extensions have been tested in **Files** in PureOS:

+---------------------------------------+-------------------------------------------------------------------------------------------+
| Name                                  | Purpose                                                                                   |
+=======================================+===========================================================================================+
| ``nautilus-gtkhash``                  | Generate and view file checksums                                                          |
+---------------------------------------+-------------------------------------------------------------------------------------------+
| ``nautilus-sendto``                   | Send a file via email from the file manager                                               |
+---------------------------------------+-------------------------------------------------------------------------------------------+
| ``nautilus-image-converter``          | Reduces image file size with a right-click context menu                                   |
+---------------------------------------+-------------------------------------------------------------------------------------------+
| ``nautilus-extension-gnome-terminal`` | Provides a right-click menu item to open a terminal window in the current folder location |
+---------------------------------------+-------------------------------------------------------------------------------------------+
| ``nautilus-nextcloud``                | Integration with Nextcloud desktop app                                                    |
+---------------------------------------+-------------------------------------------------------------------------------------------+

The following list of of other nautilus extensions have not yet been thoroughly tested in PureOS; use them at your own risk:

- ``nautilus-admin``
- ``nautilus-compare``
- ``nautilus-data``
- ``nautilus-emblems``
- ``nautilus-extension-brasero``
- ``nautilus-extension-burner``
- ``nautilus-filename-repairer``
- ``nautilus-hide``
- ``nautilus-image-manipulator``
- ``nautilus-scripts-manager``
- ``nautilus-share``
- ``nautilus-wipe``

.. _software_pureos_tips_nautilus_extension_sendto:

Send files as email attachments
-------------------------------

#. Install and configure an email client, such as Thunderbird.
#. Install the plugin ``nautilus-sendto``.
   Open the terminal emulator and type the command:

   .. code-block:: bash

      sudo apt install nautilus-sendto

#. Press the **Enter** key, type your password and press the **Enter** key again.
   If you are asked for confirmation, press the **y** key or the key representing "yes" in your system language.
#. Log out and in again
#. Right click on a file you want to send via email
#. Select the and option **send to...**

   .. image:: ../img/nautilus/nautilus-sendto-contextmenu.png
      :scale: 50%
      :alt: Send the file

   Thunderbird will now open a new email with the file already included as an attachment.

   .. image:: ../img/thunderbird/new-email.png
      :scale: 50%
      :alt: New email in Thunderbird


.. _software_pureos_tips_nautilus_extension_gtkhash:

Generate and view file checksums
--------------------------------

#. Install the extension ``nautilus-gtkhash``.
   Open the terminal emulator and type the command:

   .. code-block:: bash

      sudo apt install nautilus-gtkhash

#. Press the **Enter** key, type your password and press the **Enter** key again.
   If you are asked for confirmation, press the **y** key or the key representing "yes" in your system language.
#. Right click on the file in question
#. Select **Properties**

   .. image:: ../img/nautilus/file-contextmenu-properties.png
      :scale: 50%
      :alt: File context menu: Properties

#. Select **Digest**
#. Select from the right side of the window the hash you want
#. Press **Hash**

   You will now see the checksum for that file:

   .. image:: ../img/nautilus/nautilus-gtkhash.png
      :scale: 50%
      :alt: Checksum list within properties

   Here is the same result as doing it from a terminal:

   .. code-block::

      joao@librem:~/Pictures/r$ sha256sum change-pass-00.png
      ec29c17a3208247e33c61ede9649a84866338d551139bb54f55782d76ec98566  change-pass-00.png


.. _software_pureos_tips_nautilus_extension_gnome-terminal:

Open a terminal window within the current folder location
---------------------------------------------------------

#. Install the extension ``nautilus-extension-gnome-terminal``.
   Open the terminal emulator and type the command:

   .. code-block:: bash

      sudo apt install nautilus-extension-gnome-terminal

#. Press the **Enter** key, type your password and press the **Enter** key again.
   If you are asked for confirmation, press the **y** key or the key representing "yes" in your system language.
#. Once that is done, log out and back in to your user session.
#. Open a folder within the **Files** application.
   Once a folder is open, right-click it and select the option: **Open in terminal**

   .. image:: ../img/nautilus/nautilus-extension-gnome-terminal-contextmenu.png
      :scale: 50%
      :alt: nautilus-extension-gnome-terminal context menu

   And done:

   .. image:: ../img/nautilus/nautilus-extension-gnome-terminal-popup.png
      :scale: 50%
      :alt: nautilus-extension-gnome-terminal terminal popup window


.. _software_pureos_tips_nautilus_extension_nextcloud:

Nextcloud integration
---------------------

Learn how to integrate Nextcloud desktop app with the Files app :ref:`here <sw_pureos_tips_nextcloud_nautilus>`.