Previous topicNext topic

Using third-party modules (FFGL, ISF, etc.)

Tutorials, FAQs, resources, and examples for using Magic.
Post Reply
Magic
Site Admin
Posts: 3440
Joined: Wed Apr 09, 2014 9:28 pm

Using third-party modules (FFGL, ISF, etc.)

Post by Magic »

There are lots of external modules available that weren't developed by us here at Magic. The two most relevant types are ISF (Interactive Shader Format) and FFGL (FreeFrame 1.5), and you can get more information about them on our resources page: https://magicmusicvisuals.com/resources. They let you add a lot of cool new effects to Magic.

This tutorial isn't about where to find new modules though (since there are too many web sites to keep track of), but rather how to use them in Magic once you've downloaded them.

A good introduction is here in our User's Guide: https://magicmusicvisuals.com/downloads ... uleFolders. But, I'm going to share a bit more information and a few screenshots to clarify.

A few people have discovered that you can get Magic to recognize new modules by copying them into the Magic installation folder. But I don't recommend this solution, because you might have to do it again every time you install a new version of Magic.

The best way to do it is to go into the Help menu and select the "Additional Module Folders" command. You will get a window that looks like this:
AdditionalModuleFolders.png
AdditionalModuleFolders.png (22.56 KiB) Viewed 62064 times
If you click on the "Add folder" button, you will get a system dialog box that lets you select a folder. I strongly suggest you create a new empty folder somewhere on your computer. I've created one called "D:\ThirdPartyMagicModules", and added it:
AdditionalModuleFolders2.png
AdditionalModuleFolders2.png (25.4 KiB) Viewed 62064 times
That's it. Click "Ok", and exit Magic. In your operating system (I'm creating this tutorial on Windows 7), go into the folder you created:
ThirdPartyMagicModules.png
ThirdPartyMagicModules.png (38.31 KiB) Viewed 62064 times
Now you can create as many subfolders as you want, as deep as you want, and they will all show up as submenus in Magic (more on that below). You can name them whatever you'd like.

For the sake of this example, I've created a folder called "FFGL" (for my FFGL files), and a folder called "ISF" (for my ISF files):
ThirdPartyMagicModules2.png
ThirdPartyMagicModules2.png (41.2 KiB) Viewed 62064 times
I then copied the relevant files into these folders. For this example, I copied a couple ISF files into the ISF folder (ISF files end in ".fs"):
ISFmodules.png
ISFmodules.png (37.07 KiB) Viewed 62064 times
When you're all done copying and organizing your files, start Magic again. Now, when you right-click to bring up the "Add" menu, you will see the folders you created:
AddMenu.png
AddMenu.png (11.52 KiB) Viewed 62064 times
And that's it! The submenu names will be exactly the names of the folders you created. And you can use your new modules just as you would any other Magic modules.

Note that you don't have to create separate folders for FFGL and ISF -- you can mix and match them however you want. And again, you can create as many folders as you want, for maximum organization.

Keep in mind that third-party modules are only scanned when Magic starts up, so if you make any changes to your third-party modules, you'll have to restart Magic.

I hope that helps. If you have any questions, please feel free to reply.
reaperjunkie
Posts: 10
Joined: Thu Jun 25, 2015 2:23 am

Re: Using third-party modules (FFGL, ISF, etc.)

Post by reaperjunkie »

Hi Eric,
I am running Windows 7 x64 SP1. I have followed your detailed instructions, to add third party plugins, but Magic is not showing the files in the add modules dialog. I have pointed the additional folder to the correct parent file. I have restarted Magic and my computer several times and changed file directories, but no success. Does the x64 version of Magic require additional steps?
Magic
Site Admin
Posts: 3440
Joined: Wed Apr 09, 2014 9:28 pm

Re: Using third-party modules (FFGL, ISF, etc.)

Post by Magic »

Hmm, no, the 64-bit version doesn't require any additional steps. What kind of modules are you trying to add? Perhaps they are not compatible? Keep in mind that most FFGL plugins are 32-bit, so they won't work in 64-bit Magic. But you can install the 32-bit version of Magic if you want.

Or, if that's not it, would you be able to attach some screenshots? Specifically: 1) your Additional Modules window; and 2) the OS window for the folder you specified. It's probably something simple, but I can't tell without looking at your configuration.
reaperjunkie
Posts: 10
Joined: Thu Jun 25, 2015 2:23 am

Re: Using third-party modules (FFGL, ISF, etc.)

Post by reaperjunkie »

Thanks for the fast response. 32 bit might be the issue although, oddly enough, if I add the default GLSL Shader module, then use the file dialog box on the module to open the .txt file of the plugins in question, they load and seem to work fine. I can use this method as a workaround. I have attached the screenshots you requested.
Attachments
Additional Modules Folders ScreenShot.jpg
Additional Modules Folders ScreenShot.jpg (125.72 KiB) Viewed 61713 times
reaperjunkie
Posts: 10
Joined: Thu Jun 25, 2015 2:23 am

Re: Using third-party modules (FFGL, ISF, etc.)

Post by reaperjunkie »

Here is the second screen shot.
Attachments
Folder Tree Screen Shot.gif
Folder Tree Screen Shot.gif (101.51 KiB) Viewed 61711 times
Magic
Site Admin
Posts: 3440
Joined: Wed Apr 09, 2014 9:28 pm

Re: Using third-party modules (FFGL, ISF, etc.)

Post by Magic »

Thanks, I see what the problem is: there's a difference between the Expansion Pack (.txt files) and ISF shaders (.fs files).

For the Expansion Pack, the correct way to use the .txt files is to load them into the GLSLShader module, as you realized. The Expansion Pack is not considered part of the "third-party modules" and thus isn't relevant to this tutorial :). The Expansion Pack doesn't need to be in any specific folder, and it doesn't need to be added to the Additional Module Folders. You just select one of the .txt files by clicking on the File button in the GLSLShader module.

The only supported third-party module file types are ISF (with extension .fs) and FFGL (with extension .dll on Windows, and .dylib or .bundle on Mac).

Does that help?
reaperjunkie
Posts: 10
Joined: Thu Jun 25, 2015 2:23 am

Re: Using third-party modules (FFGL, ISF, etc.)

Post by reaperjunkie »

Got it. Thanks!
Vegadeth
Posts: 12
Joined: Fri Feb 10, 2017 3:13 am
Location: United States
Contact:

Re: Using third-party modules (FFGL, ISF, etc.)

Post by Vegadeth »

Eric wrote:Thanks, I see what the problem is: there's a difference between the Expansion Pack (.txt files) and ISF shaders (.fs files).

For the Expansion Pack, the correct way to use the .txt files is to load them into the GLSLShader module, as you realized. The Expansion Pack is not considered part of the "third-party modules" and thus isn't relevant to this tutorial :). The Expansion Pack doesn't need to be in any specific folder, and it doesn't need to be added to the Additional Module Folders. You just select one of the .txt files by clicking on the File button in the GLSLShader module.

The only supported third-party module file types are ISF (with extension .fs) and FFGL (with extension .dll on Windows, and .dylib or .bundle on Mac).

Does that help?
I have tried looking for an answer to my issue and the above is the closest I can find. When I convert shader files to ISF, copy and paste the text into a text file then rename file extension as .fs it still shows up as a text file. I feel stupid for asking this as I know it is an easy fix. I just can seem to find the answer. Shown in the pic are the files I tried to convert along with a couple FS files I downloaded from the site.
Thanks,
Steve
text files to ISF files.jpg
text files to ISF files.jpg (75.75 KiB) Viewed 56696 times
Terry Payman
Posts: 710
Joined: Sun Sep 14, 2014 8:15 am
Location: UK
Contact:

Re: Using third-party modules (FFGL, ISF, etc.)

Post by Terry Payman »

From your screenshot I see that Windows File Explorer is obscuring the issue - the files are currently listed without their filetype extension. I think you'll find that eg HotShower.FS is actually HotShower.FS.txt

The default File Explorer view option is "Hide extensions for known file types" :( . You need to uncheck this option.
hide extensions.jpg
hide extensions.jpg (64.88 KiB) Viewed 56696 times
I found some instructions for the fix here, but there are many others.
https://www.howtohaven.com/system/show- ... orer.shtml
Terry Payman
Posts: 710
Joined: Sun Sep 14, 2014 8:15 am
Location: UK
Contact:

Re: Using third-party modules (FFGL, ISF, etc.)

Post by Terry Payman »

... You'll then need to rename the file name/extension, removing the (now visible) ".txt" from the end.

eg HotShower.FS.txt would become HotShower.FS which should now work in an ISF module*
https://www.mediacollege.com/microsoft/ ... hange.html

*Shadertoy buffers are not (yet) supported in Magic, so if you see a shader with a BufA tab it will definitely not work in Magic. There's also a new Common tab - I don't know if that's supported in the conversion script.
Vegadeth
Posts: 12
Joined: Fri Feb 10, 2017 3:13 am
Location: United States
Contact:

Re: Using third-party modules (FFGL, ISF, etc.)

Post by Vegadeth »

Terry Payman wrote:From your screenshot I see that Windows File Explorer is obscuring the issue - the files are currently listed without their filetype extension. I think you'll find that eg HotShower.FS is actually HotShower.FS.txt

The default File Explorer view option is "Hide extensions for known file types" :( . You need to uncheck this option.
hide extensions.jpg
I found some instructions for the fix here, but there are many others.
https://www.howtohaven.com/system/show- ... orer.shtml
Thank you!
olazzzzz
Posts: 15
Joined: Fri Sep 25, 2020 10:40 am

Re: Using third-party modules (FFGL, ISF, etc.)

Post by olazzzzz »

Regarding the ISF files, is there a way to switch between them faster?
What I mean is that if you have (let's say) 200 files you want to try out, selecting a file one by one takes enourmous ammount of time and a lot of clicks for each one.
I think it isn't possible to drag and drop .fs files and there isn't a ISF selector (like there is for GLSLShader).
Is there another way to cycle between them?
Thanks a lot!
Magic
Site Admin
Posts: 3440
Joined: Wed Apr 09, 2014 9:28 pm

Re: Using third-party modules (FFGL, ISF, etc.)

Post by Magic »

This section in the User's Guide describes how to replace modules with the next/previous: https://magicmusicvisuals.com/downloads ... ingModules
olazzzzz
Posts: 15
Joined: Fri Sep 25, 2020 10:40 am

Re: Using third-party modules (FFGL, ISF, etc.)

Post by olazzzzz »

That's absolutely great! Exactly what I needed, thank you!
Post Reply