nautilus

This is the project of the Files app, a file browser for GNOME, internally known by its historical name nautilus.

Supported version

Only the latest version of Files as provided upstream is supported. Try out the Flatpak nightly installation before filling issues to ensure the installation is reproducible and doesn't have downstream changes on it. In case you cannot reproduce in the nightly installation, don't hesitate to file an issue in your distribution. This is to ensure the issue is well triaged and reaches the proper people.

Contributing to nautilus

To build the development version of the Files app and hack on the code see the welcome guide.

Commit messages should follow the expected format detailed here.

Update default branch

The default development branch of nautilus has been renamed to main. To update your local checkout, use:

git checkout master
git branch -m master main
git fetch
git branch --unset-upstream
git branch -u origin/main
git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/main

Runtime dependencies

• Bubblewrap installed. Used for security reasons.
• Tracker (including tracker-miners) properly set up and with all features enabled. Used for fast search and metadata extraction, starred files and batch renaming.

Discourse

For more informal discussion we use GNOME Discourse in the Applications category with the nautilus tag. Feel free to open a topic there.

Extensions

Documentation for the libnautilus-extension API is available here. Also, if you are interested in developing a Nautilus extension in Python you should refer to the nautilus-python documentation.

How to report issues

Report issues to the GNOME issue tracking system.