.. _OpenCOR-plugin-fileorganiserwindow:

==========================
FileOrganiserWindow Plugin
==========================

.. |folder-new|
    image:: ../resources/images/oxygen/actions/folder-new.png
        :width: 1.3em
        :height: 1.3em

.. |edit-delete|
    image:: ../resources/images/oxygen/actions/edit-delete.png
        :width: 1.3em
        :height: 1.3em



The FileOrganiserWindow plugin allows you to organise your files in a virtual manner, i.e. independently of where they are physically located. Your virtual environment is remembered from one session to another and is originally empty:

.. image:: ../resources/images/plugins/FileOrganiserWindowScreenshot01.png
    :align: center
    :width: 60%
    :alt: FileOrganiserWindow 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 virtual link to) all the files you need for your project. For 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:: ../resources/images/plugins/FileOrganiserWindowScreenshot02.png
    :align: center
    :width: 60%
    :alt: FileOrganiserWindow plugin: create a folder

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

.. image:: ../resources/images/plugins/FileOrganiserWindowScreenshot03.png
    :align: center
    :width: 60%
    :alt: FileOrganiserWindow plugin: create several (sub-)folders

You can also 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:: ../resources/images/plugins/FileOrganiserWindowScreenshot04.png
    :align: center
    :width: 60%
    :alt: FileOrganiserWindow plugin: move/delete (sub-)folders

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

.. image:: ../resources/images/plugins/FileOrganiserWindowScreenshot05.png
    :align: center
    :width: 60%
    :alt: FileOrganiserWindow plugin: add files

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

.. image:: ../resources/images/plugins/FileOrganiserWindowScreenshot06.png
    :align: center
    :width: 60%
    :alt: FileOrganiserWindow plugin: move/delete files

Tool bar
--------

|folder-new|   Create a new folder

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