.. _appearance:

*********************************************
Web Interface Language
*********************************************

By default, only English and Russian languages are available in the web interface. Other languages are provided by request (support@ntechlab.com) and added to the system via the ``/etc/findface-security/config.py`` configuration file. 

.. rubric:: In this section:

.. contents::
   :local:

Switch Language in Web Interface
=========================================

You can change the system language on the :menuselection:`Preferences -> Appearance` tab.  

|appearance_en|

.. |appearance_en| image:: /_static/appearance_en.png
        :scale: 50%

.. |appearance_ru| image:: /_static/appearance_ru.png
        :scale: 50%


Add Custom Language
=========================
 
To add a custom language to the system, do the following:

#. Download the localization file provided by our experts into the ``/usr/share/ffsecurity-ui/ui-static/`` directory on the FindFace Multi principal server.

#. Open the  ``/etc/findface-security/config.py`` configuration file. 

   .. code::

      sudo vi /etc/findface-security/config.py

#. Into the ``FFSECURITY_UI_CONFIG`` section, insert the ``languages`` section and fill it by analogy with the example below. 

   .. code::

      FFSECURITY_UI_CONFIG = {
      ...
        "languages": {
          "items": [
            {
              "name": "es",
              "label": "Español",
              "url": "/ui-static/es_i18n_ffsec.po"
            },
          ]
        },

#. Restart the ``findface-security`` service.
   
   .. code::

      sudo systemctl restart findface-security.service

The new language will be automatically applied to the system and from now on be available on the :menuselection:`Preferences -> Appearance` tab. You can at any time switch between it and other available languages.