Skip to content
Aris edited this page Jul 10, 2026 · 12 revisions

There are 2 ways to use Mnemosyne:

Using the CLI (Command Line Interface)

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.

Using the GUI CLI Keyword

 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.

Using the GUI (Graphical User Interface)

To use Mnemosyne from the GUI, just double click on the Mnemosyne icon and a Window should open,

Mnemosyne Window

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

File Button

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)

Mnemosyne Ready

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)

Mnemosyne Scanning

And also a seperate window will open with the following:

Mnemosyne Scanning Window

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)

    Mnemosyne Result

    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.

    Mnemosyne Folder Ready

    It will also enable the "Back" button.

    Mnemosyne 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)

    Mnemosyne Result

    Using the Graphical Representation of the Results

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

    Mnemosyne Result

    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!!

    Using The Menu Bar with the GUI

    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.

    Mnemosyne Menu

    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

    The out of memory Window..

    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 Out of Memory Window

    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.