How to Create a Macro to View ONLY Midi Clips in the PT Clips Bin

Glad that helps... Will keep you posted on a clear example for sure. :-)

OK here is a good simple example of how the invalidate() method works;

Run the following script which should logs the file name and extension of the current Pro Tools session;

sf.ui.proTools.appActivateMainWindow();

//Get the current session path
const sessionPath = sf.ui.proTools.mainWindow.sessionPath;
//Get the current session file name
const sessionFileName = sessionPath.split('/').slice(-1)[0];

log(sessionFileName);

This should log the current Pro Tools session name that is collected from the main window of Pro Tools as seen here;

The log will say;

[LOG] My Session Name.ptx

Which is correct and what we expect :-)

Now, to throw a spanner in the works, let's save the session, giving it a new name... for example, save the session as "New and Improved Session".

The Pro Tools main window will now show this new name;

Now run the script again and you will see that the SoundFlow Cache has retained the information from the previous run of the script. So the result is again;

[LOG] My Session Name.ptx

... which is obviously incorrect.

If we change the script by adding an invalidate() method after the mainWindow node. like this;

sf.ui.proTools.appActivateMainWindow();

//Get the current session path
const sessionPath = sf.ui.proTools.mainWindow.invalidate().sessionPath;
//Get the current session file name
const sessionFileName = sessionPath.split('/').slice(-1)[0];

log(sessionFileName);

... and run the script again, the script logs the updated session name from the Pro Tools main window;

[LOG] New and Improved Session.ptx

I hope that clarifies invalidation for you. :-)

Rock on!