.. _configure_popy:

Configure |popy|
################

.. _popy_config_pyml:

|popy| Config File
==================

The local settings of your |popy| installation can be altered by editing this file:-

.. code-block:: console

    C:\popy\popy_config.pyml

We recommend that you do not alter this file unless you know exactly what you are doing.

.. _popy_config_options:

Configuration Options
=====================

You should probably restrict yourself to editing the following two paths:-

.. code-block:: console

    # path to text editor invoked using popy_edit
    text_editor_path: "C:/Program Files/Notepad++/notepad++.exe"

    # path to Inkscape binary invoked using popy_imconv
    inkscape_exe_path: "C:/Program Files/Inkscape/inkscape.exe"

You should change these paths if you have installed :ref:`notepadpp` or :ref:`inkscape` to non-standard locations.

.. _popy_config_factory_reset:

Factory Reset Options
=====================

If you edit your 'popy_config.pyml' and |popy| no longer functions correctly, please restore to the following default settings:-

.. literalinclude:: config_pyml_default.inc
    :language: yaml

    
.. _inkscape:

Inkscape
==========

We recommend Inkscape, an open source graphics tool, for converting between image file formats.

.. _install_inkscape:

Install Inkscape
------------------

Download it from:-

https://inkscape.org/en/release/

If you install the 64bit binary installer the default install directory is:-

.. code-block:: console

    C:\Program Files\Inkscape

.. _configure_inkscape_path:

Configure Inkscape Path
------------------------

Note that to use Inkscape with :ref:`popy_imconv` you need to make sure :ref:`popy_config_pyml` contains this entry:-

.. code-block:: pyml

    inkscape_exe_path: "C:/Program Files/Inkscape/inkscape.exe"

With this path set correctly you can now :ref:`open_a_popy_command_prompt` and do:-

.. code-block:: console

    $ popy_imconv *.svg png
    
To convert .svg images to .png format. See :ref:`popy_imconv`.


.. _uninstall_popy:

Uninstall |popy|
=================

Note that if you are moving your |prod_key| to another machine, it is wise to :ref:`deactivate_popy` before uninstalling. If you are upgrading |popy| then it is best to keep the current product key.

.. _run_the_uninstaller:

Run the uninstaller
----------------------

You can click on the shortcut at:-

.. code-block:: console

    Start Menu > PoPy > popy_uninstall

Or you could, instead, run the .exe at:-

.. code-block:: console

    C:\PoPy\popy_uninstall.exe

The uninstaller will remove the |popy| desktop shortcut and Windows start menu items, but does not change the Windows Registry.
