# Configure PoPy

## PoPy Config File

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

    C:\popy\popy_config.pyml

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

## Configuration Options

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

    # 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 Notepad++ or Inkscape to non-standard locations.

## Factory Reset Options

If you edit your ‘popy_config.pyml’ and PoPy no longer functions correctly, please restore to the following default settings:-

    # path to favicon
    favicon_path: ${POPY_PYTHON_PATH}/conf/4p_white_border.ico

    # path to graphviz dot.exe for creating diagrams
    graphviz_dot_path: ${POPY_PYTHON_PATH}/thirdparty/graphviz/bin/dot.exe

    # path to sphinx confuration options - used when generating html or latex
    sphinx_conf_folder: ${POPY_PYTHON_PATH}/conf

    # path to memcached executable
    memcached_path: ${POPY_PYTHON_PATH}/thirdparty/memcached-amd64/memcached.exe

    # path rabbitmq sbin folder
    rabbitmq_sbin_folder: ${POPY_PYTHON_PATH}/thirdparty/RabbitMQ Server/rabbitmq_server-3.5.1/sbin

    # 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"

## Inkscape

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

### Install Inkscape

Download it from:-

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

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

    C:\Program Files\Inkscape

### Configure Inkscape Path

Note that to use Inkscape with popy_imconv you need to make sure PoPy Config File contains this entry:-

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

With this path set correctly you can now Open a PoPy Command Prompt and do:-

    $ popy_imconv *.svg png

To convert .svg images to .png format. See popy_imconv.

## Uninstall PoPy

Note that if you are moving your product key to another machine, it is wise to Deactivate PoPy before uninstalling. If you are upgrading PoPy then it is best to keep the current product key.

### Run the uninstaller

You can click on the shortcut at:-

    Start Menu > PoPy > popy_uninstall

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

    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.