Repository navigation
Usage
To use Mnemosyne from the CLI, just type on your shell:
Mnemosyne <path>
Where <path> is the path to the directory you want to scan.
Mnemosyne GUI <path>
Where <path> is the path to the directory you want to scan.
Adding the GUI Keyword will open the GUI and start the scanning process.
To use Mnemosyne from the GUI, just double click on the Mnemosyne icon and a Window should open,

click on the file button to select the directory you want to scan.

After you have selected the directory you want to scan, Mnemosyne will say that it is "Ready to Scan!" To start the scanning process, click on th.e "Scan" button. (Note: The Scan button will not be clickable if you have not selected a directory)

After you click the Scan button Mnemosyne will start and indicate that it is scanning the directory including also which directory it is scanning. (Maybe you might see a easter egg sometimes in your scanning adventures :D)

And also a seperate window will open with the following:

This will allow you to stop the scanning process any time you want to. (This helps a lot if you are scanning a large directory and it is taking a long time to scan and you want to stop it)
When the scanning is finished, it will show you the results.
It will show you information such as:
-
The Name of the file or folder. (Shown under the "Name" Column)
-
The Percentage of the directory size that the file or folder is taking up. (Shown under the "Approx %" Column)
-
The Size of the file or folder. (Shown under the "Size" Column)
(Note: The Percentage and Name can be sorted by clicking on them)

You can use the scroll bar or your mouse wheel to scroll through the results.
You can also click on a folder on your results and It will start a new scan on that folder.

It will also enable the "Back" button.

By clicking on the "Back" button you will go back to the previous folder.
(Note: The "Back" button will stay disabled when you are on the root directory)

If you have enabled the graph feature, using the ENABLEGRAPH tooltype or the Menu Bar, you will see a graphical representation of the results.

The graph is a treemap style graph that shows the percentage of the directory size visually.
Each rectangle next to the file or folder in the results represents a rectangle in the graph. The bigger the rectangle, the more percentage of the directory size it takes up. And they are color coded!!
As with most applications in the Amiga, Mnemosyne has a Menu Bar with some options and functions that can be very useful.
You can use the Menu Bar by having Mnemosyne open and holding the Right Mouse Button while hovering over the workbench tab.

The Menu Bar has the following options:
-
Open: Opens window for you to select a directory to scan.
- Keyboard Shortcut: Amiga + O
-
Open in Workbench...: Opens the current directory you are in on a window. (Note: This will stay disabled when you have not scanned a directory)
- Keyboard Shortcut: Amiga + W
-
About: Opens a window with information about Mnemosyne.
- Keyboard Shortcut: Amiga + A
-
Quit: Quits Mnemosyne.
- Keyboard Shortcut: Amiga + Q
Hopefully you will not see this window, but if you do, it means that Mnemosyne has run out of memory and cannot continue the scanning process.

Mnemosyne will stop what it is doing and clear any memory it has used to prevent any memory leaks or crashes on your system.
Each OOM (Out of Memory) window will have a number on it (A error code), which indicates exactly what function or allocation has run out of memory. This is incredibly useful for helping Mnemosyne to be improved and fixed in the future.
So if you see this window, please report it to me on Github or Aminet and include the number on the window (or a screenshot of the window) so I can fix it in the future.
-
Mnemosyne is open-source and licensed under the GPLv3.
You are welcome to contribute at https://github.com/Arisamiga/Mnemosyne!