File Explorer

This application is a simple file explorer made in Ruby. It relies on GTK3 for the graphical interface.

Note

This project has been made to learn the Ruby programming language. The code may not follow the best convention and this software should probably not be used in any serious activity.

Requirements

The project is built with Ruby:

• Ruby 3.3.8
• GTK-3

How to run this project ?

The first step is to install Ruby : see the official website.

Then use the gem command to install GTK 3:

gem install gtk3

Finally, the application can be executed with the following command:

ruby main.rb

Project structure

• main.rb: Entrypoint for the application. Contains the code description of the UI
• explorer.rb: The file explorer class and methods
• Gemfile: The file that contains the project dependencies
• config.yml: Configuration option for the file explorer
• README.md: The current file you are reading, detailing the project
• assets: A folder containing the project resources (i.e. icon, css stylesheet, font...)

Images

Here is the current look of the application:

Features

Here is a list of features that are supported by this application

• Enumerates files and folder
• Navigation between directories
  • Search bar
  • Previous button
  • History
  • Click to explore a file directory
  • Copy current path to clipboard (from search bar)
• Formating file size to be more humanly-readable
• Displaying hidden files
• Selecting information to display via toggle (size, type, creation date...)
• Advanced file option (right-click)
  • Copy file path to clipboard
  • Copy file name to clipboard
• Icon next to filename
• Sort columns by criteria
• Multiple themes available

Credits

Icons:

• Folder is from Freepik

Known issues

Here is a list of currently known unwanted behavior :

• Ticking the Format filesize option refresh the display without conserving the current sorting if it's reversed
• There is currently no visual indicator of the applied sorting criteria
• Sorting by Filename is inaccurate
• The > (next) button currently doesn't work
• The dark theme isn't looking very good
• Folder indexing isn't cached. Implying that the size computation for large folder will consume time at each loading.