Welcome to Quick File Explorer! This application allows you to explore your file system with a simple and intuitive graphical interface. Here's a step-by-step guide to help you navigate and use the various features of the application.
Clone the project
$ git clone https://github.com/anekobtw/quick-file-explorer.git
Install dependencies
$ pip install -r requirements.txt
Run the program
$ python main.py
-
Sidebar:
- Located on the left side of the window.
- Displays the application title, version, and appearance mode options.
- Contains a button for accessing the tutorial.
-
Main Frame:
- Occupies the right side of the window.
- Displays the contents of the selected directory or available drives.
- Uses a scrollable frame to list files and folders.
- Drives:
- When you first open the application, the main frame lists all available drives.
- Choosing a file or a folder:
- Use the
Down
arrow key to move the selection down. - Use the
Up
arrow key to move the selection up. - The selected item will be highlighted in blue.
- Use the
- Open Selected Item:
- With keyboard:
- Press the
Enter
key to open the selected file or folder. - Press the
o
button to open the current folder in Windows default explorer.
- Press the
- With mouse:
- Click on a file to open it with the default application.
- Click on a folder to view its contents.
- With keyboard:
- Go one directory back:
- Press the
esc
key to go back to the previous directory. - If you're at the root directory, pressing
esc
will take you back to the drive selection screen.
- Press the
- Open/Close Window:
- Press
Win+Z
to toggle the visibility of the window.
- Press
Here's an example of how to start using Quick File Explorer:
- Launch the Application:
python file_explorer.py
-
Select a Drive:
Click on a drive (e.g., C:/) to list its contents. -
Navigate Folders:
Use the arrow keys or click on folders to navigate through the directory structure. -
Open a File:
Select a file and press Enter to open it with the default application. -
Change Appearance Mode:
Select a different appearance mode from the sidebar to see how the application looks in different themes. -
Toggle Window Visibility:
Press Win+Z to hide or show the application window.
Contributions are always welcome!
See contributing.md
for ways to get started.
Please adhere to this project's code of conduct
.
The project is MIT licensed