.. _OpenCOR-fileorganiserplugin:

=====================
File organiser plugin
=====================

The **FileOrganiser** plugin allows you to organise your files virtually, i.e. independently of where they are physically located. Your virtual environment is remembered from one session to another and is, by default, empty:

.. image:: /OpenCOR/images/FileOrganiserScreenshot01.png
    :align: center
    :width: 360px
    :height: 270px
    :alt: FileOrganiser plugin: default view

Now, say that you are working on a specific project. You might then want to create a (virtual) folder which contains (a reference to) all the files you need for your project. To go about this, you first need to click on the |folder-new| button in the toolbar (or use the context menu). This will add a folder to your virtual environment:

.. image:: /OpenCOR/images/FileOrganiserScreenshot02.png
    :align: center
    :width: 360px
    :height: 270px
    :alt: FileOrganiser plugin: create a folder

You can rename the folder as you wish and create other (sub-)folders, if needed:

.. image:: /OpenCOR/images/FileOrganiserScreenshot03.png
    :align: center
    :width: 360px
    :height: 270px
    :alt: FileOrganiser plugin: create several (sub-)folders

You can move the (sub-)folders around by dragging and dropping them within your virtual environment, or delete an existing (sub-)folder by clicking on the |edit-delete| button in the toolbar (or by using the context menu):

.. image:: /OpenCOR/images/FileOrganiserScreenshot04.png
    :align: center
    :width: 360px
    :height: 270px
    :alt: FileOrganiser plugin: move/delete (sub-)folders

Next, you might want to open the :ref:`file browser <OpenCOR-filebrowserplugin>` window, so you can start dragging and dropping files into your virtual environment (alternatively, you can use your system's file manager):

.. image:: /OpenCOR/images/FileOrganiserScreenshot05.png
    :align: center
    :width: 360px
    :height: 270px
    :alt: FileOrganiser plugin: add files

As for folders, you can move and delete your (virtual) files:

.. image:: /OpenCOR/images/FileOrganiserScreenshot06.png
    :align: center
    :width: 360px
    :height: 270px
    :alt: FileBrowser plugin: default view

Tool bar
--------

.. |folder-new|
    image:: images/oxygen/actions/folder-new.png
        :width: 24px
        :height: 24px

.. |edit-delete|
    image:: images/oxygen/actions/edit-delete.png
        :width: 24px
        :height: 24px

============= ==================================================================
|folder-new|  Create a new folder
|edit-delete| Delete the current folder(s) and/or link(s) to the current file(s)
============= ==================================================================