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

Sat May 16, 2015 4:57 pm

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/Magic_UsersGuide.html#AdditionalModuleFolders. 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 10724 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 10724 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 10724 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 10724 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 10724 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 10724 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.
Eric
Site Admin
 
Posts: 2379
Joined: Wed Apr 09, 2014 9:28 pm

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

Wed Sep 16, 2015 6:06 pm

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?
reaperjunkie
 
Posts: 10
Joined: Thu Jun 25, 2015 2:23 am

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

Wed Sep 16, 2015 6:22 pm

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.
Eric
Site Admin
 
Posts: 2379
Joined: Wed Apr 09, 2014 9:28 pm

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

Wed Sep 16, 2015 8:33 pm

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 10373 times
reaperjunkie
 
Posts: 10
Joined: Thu Jun 25, 2015 2:23 am

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

Wed Sep 16, 2015 8:40 pm

Here is the second screen shot.
Attachments
Folder Tree Screen Shot.gif
Folder Tree Screen Shot.gif (101.51 KiB) Viewed 10371 times
reaperjunkie
 
Posts: 10
Joined: Thu Jun 25, 2015 2:23 am

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

Wed Sep 16, 2015 8:51 pm

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?
Eric
Site Admin
 
Posts: 2379
Joined: Wed Apr 09, 2014 9:28 pm

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

Thu Sep 17, 2015 4:35 am

Got it. Thanks!
reaperjunkie
 
Posts: 10
Joined: Thu Jun 25, 2015 2:23 am

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

Fri Mar 16, 2018 7:44 am

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 5356 times
Vegadeth
 
Posts: 9
Joined: Fri Feb 10, 2017 3:13 am

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

Fri Mar 16, 2018 8:25 am

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 5356 times

I found some instructions for the fix here, but there are many others.
https://www.howtohaven.com/system/show-file-extensions-in-windows-explorer.shtml
Terry Payman
 
Posts: 489
Joined: Sun Sep 14, 2014 8:15 am
Location: UK

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

Fri Mar 16, 2018 8:48 am

... 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/windows/extension-change.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.
Terry Payman
 
Posts: 489
Joined: Sun Sep 14, 2014 8:15 am
Location: UK

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

Mon Mar 19, 2018 1:20 pm

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-file-extensions-in-windows-explorer.shtml

Thank you!
Vegadeth
 
Posts: 9
Joined: Fri Feb 10, 2017 3:13 am

Return to Tutorials, etc.

© 2019 Color & Music, LLC • This web site is mobile-friendly