Skip to content

Latest commit

 

History

History
71 lines (63 loc) · 3.13 KB

README.md

File metadata and controls

71 lines (63 loc) · 3.13 KB
Raw

TRASH VISUALISER v1.0

This is GUI-based Python Desktop Application, that will show all your deleted items inside the Recycle-bin in a better visual representation. You'll be able to open those folders/ files in the GUI, as well as delete and restore them from the GUI, in an effective manner.

⚠️This Application will run only on Windows⚠️

PREQUISITIES

winshell library should be installed in your system, before using this program. if not Run this command

pip install winshell

The GUI requires PyQt5 as well

pip install PyQt5

HOW TO USE

start by cloning this repository

$ git clone https://github.com/shahzaibk23/Trash-Visualiser

After cloning is successful

cd Trash-Visualiser
Trash-Visualiser> python launcher.py

[CAUTION]⚠️

It may happen that the windows will ask you to create some folders that doesn't exist, these will be the folders that you'd have deleted once.
Simply Click YES, this way the folders you once had deleted will be created again temporarily, so no need to Panic on that, let it happen.
2

After a few seconds of processing, Trash-Visualiser Main Window will be opened 1 This Window will show all the deleted files/folders in your recycle bin. Files and Folders are visualised seperately.

FEAUTURES

  • Upon Single CLick on any File/Folder the details(properties) of it will be shown in the down right box.
  • Upon Double Click on any File:
    • If the Clicked File is .txt OR .py OR any other kind of sorce file that contains any kind of text in it, will be opened directly in the Window, so as you can view it.
    • Any other file other than text files( Source Code Files included ), won;t be able to be opened, the program will show a message box saying that it can't be opened.
  • Upon Double CLick on a Folder, the Folder will be opened
    • You'll be able to open further files and folders inside that folder, and so on.
  • GO Back Button is found once you're inside any File or Folder, through which you can get back to the main window.
  • In Order to Restore or Delete a File/Folder Single click on it from the main window, you'll see its properties being shown, then CLick on RESTORE or DELETE button
    • RESTORE: The selected file/folder will be restores to its original location.
    • DELETE: The selected file/folder will be permanently deleted from the recycle-bin as well.

3

Using CLI-version

After cloning is successful, cd into the repository folder.

cd Trash-Visualiser

After that

Trash-Visualiser> cd src/CLI/
Trash-Visualiser> python main.py

The exact same operations will be performed but in Command Line Interface.
4