Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file removed doc/images/files/files-associations-open.gif
Binary file not shown.
Binary file added doc/images/files/files-associations-open.webm
Binary file not shown.
Binary file removed doc/images/files/files-associations.gif
Binary file not shown.
Binary file added doc/images/files/files-associations.webm
Comment thread
conradolandia marked this conversation as resolved.
Binary file not shown.
Binary file removed doc/images/files/files-browse.gif
Binary file not shown.
Binary file added doc/images/files/files-browse.webm
Binary file not shown.
Binary file removed doc/images/files/files-columns-display.png
Binary file not shown.
Binary file added doc/images/files/files-columns-display.webp
Comment thread
conradolandia marked this conversation as resolved.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed doc/images/files/files-commit.gif
Binary file not shown.
Binary file added doc/images/files/files-commit.webm
Comment thread
CAM-Gerlach marked this conversation as resolved.
Binary file not shown.
Binary file removed doc/images/files/files-context-menu.png
Binary file not shown.
Binary file added doc/images/files/files-context-menu.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed doc/images/files/files-copy-path.gif
Binary file not shown.
Binary file added doc/images/files/files-copy-path.webm
Binary file not shown.
Binary file removed doc/images/files/files-filters.gif
Binary file not shown.
Binary file added doc/images/files/files-filters.webm
Comment thread
conradolandia marked this conversation as resolved.
Binary file not shown.
Binary file removed doc/images/files/files-standard.png
Binary file not shown.
Binary file added doc/images/files/files-standard.webp
Comment thread
conradolandia marked this conversation as resolved.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 15 additions & 9 deletions doc/panes/fileexplorer.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Files
The **Files** pane is a filesystem and directory browser built right into Spyder.
You can view and filter files according to their type and extension, open them with the :ref:`panes-editor` or an external tool, and perform many common operations.

.. image:: /images/files/files-standard.png
.. image:: /images/files/files-standard.webp
:alt: Spyder Files pane, showing a tree view of files and metadata


Expand All @@ -23,19 +23,21 @@ To browse the files on your system, use the arrows at the top of the pane.
You can expand/collapse the folders in the pane to display the files and subdirectories hierarchically.
Double-clicking a folder will open it, showing the files inside and making it your working directory.

.. image:: /images/files/files-browse.gif
.. video:: /images/files/files-browse.webm
:loop:
:alt: Spyder Files pane showing browsing directories

To open a file in the :guilabel:`Editor` from the :guilabel:`Files` pane, double-click its name.
If you right-click over it, you will see a context menu that allows you to access a number of functions, including running scripts; creating, renaming, moving, deleting files; and opening them in your computer's file manager.

.. image:: /images/files/files-context-menu.png
.. image:: /images/files/files-context-menu.webp
:alt: Spyder Files pane showing context menu

You can copy and paste one or several files to and from the pane, and copy their absolute or relative paths to the clipboard as text.
If copying the paths for multiple files, they will be automatically formatted so you can paste them directly into a Python list.

.. image:: /images/files/files-copy-path.gif
.. video:: /images/files/files-copy-path.webm
:loop:
:alt: Spyder Files pane showing copying absolute path to Editor


Expand All @@ -52,7 +54,8 @@ This is :ref:`particularly useful <panes-projects-vcs>` when you're working in S

.. _Git: https://git-scm.com/

.. image:: /images/files/files-commit.gif
.. video:: /images/files/files-commit.webm
:loop:
:alt: Spyder Files pane showing committing change of file


Expand All @@ -68,14 +71,15 @@ The options menu in the top right of the :guilabel:`Files` pane offers several w
By default, the pane displays the contents of your working directory without filtering.
However, it can filter the list to show only files matching the patterns set under :guilabel:`Show filenames with these extensions...`, if you toggle the :guilabel:`Filter filenames` button in the pane toolbar.

.. image:: /images/files/files-filters.gif
.. video:: /images/files/files-filters.webm
:loop:
:alt: Spyder Files pane showing filtering files

You can also activate the :guilabel:`Show hidden files` option, which will display files that are invisible by default in your operating system.

Additionally, you can change which file attributes you want to see by hiding or displaying the :guilabel:`Type`, :guilabel:`Size` and :guilabel:`Date Modified` columns using the corresponding menu options.

.. image:: /images/files/files-columns-display.png
.. image:: /images/files/files-columns-display.webp
:alt: Spyder Files pane showing columns checked and shown

The menu also gives you the option to open files and directories with a single instead of a double click, to suit your preferences.
Expand All @@ -91,13 +95,15 @@ File associations
:guilabel:`Files` allows you to associate different external applications with specific file extensions they can open.
Under the :guilabel:`File associations` tab of the :guilabel:`Files` preferences pane, you can add file types and set the external program used to open each of them by default.

.. image:: /images/files/files-associations.gif
.. video:: /images/files/files-associations.webm
:loop:
:alt: Spyder Files pane showing files associations

Once you've set this up, files will automatically launch in the associated application when opened from Spyder's :guilabel:`Files` pane.
Additionally, when you right-click a file, you will find an :guilabel:`Open with...` option that will allow you to select from the applications associated with this extension.

.. image:: /images/files/files-associations-open.gif
.. video:: /images/files/files-associations-open.webm
:loop:
:alt: Spyder Files pane showing opening file with associated program


Expand Down