-:[ About  ]:-

This is a tool that can generate MIME files definitions that are required by Ambient to identify files 
in order to attribute various menu and default actions to the files when the user interacts with them
from the Ambient window manager on MorphOS.

-:[ Files ]:-

The "c/" sub-directory should include the compiled Magic2Morph utility. The "Install" icon will install
Magic2Morph in C: and a database Magic2Morph.template in ENVARC:

-:[ Usage  ]:-

Existing filetypes typically reside in SYS:Prefs/Ambient/filetypes and can be accessed using Ambient
itself by accessing the MIME configuration panel at Desktop -> (Right Click) -> Ambient Settings -> Mime

Magic2Morph can then be invoked with, say:

Magic2Morph Games:CaptainBlood/CaptainBlood.Slave NAME "WHDLoad slave"

which will outut a MIME filetype definition. Note that a name is required and the name represents an
anchor for files that will be matched using this filetype. In this example, the filetype definition will
match all WHDLoad slave files such that the name is intuitively "WHDLoad slave".

If everything looks okay, issue the command again with an output file path, for example:

Magic2Morph Games:CaptainBlood/CaptainBlood.Slave NAME "WHDLoad slave" OUTPUT RAM:x-whdload-slave

and now the file at RAM:x-whdload-slave will contain the filetype definition.

Next, copy RAM:x-whdload-slave to SYS:Prefs/Ambient/filetypes/ under some directory:
  * text - for files containing readable characters,
  * image - for picture formats,
  * audio - for sound files,
  * video - for video files,
  * application - for executable and binary files

Finally, open Desktop -> (Right Click) -> Ambient Settings -> Mime and search for your filetype, in this
case, that would be x-whdload-slave. The filetype definition can then be modified in order to attribute
actions to the file type.

-:[ Advanced Usage  ]:-

Note that using the file extension is fairly sane enough for a filesystem where the data exists locally 
and that the MIME specification was meant for Internet resources when the file type is not previous 
known. With that said MIME is a superset, or, a means to all ends, and is very powerful in terms of 
matcaing such that it is possible to accidentally generate false match positivies if the BINARY string 
is too common between the various files. 

For example, assume that Magic2Morph is invoked with:

Magic2Morph MODE=BINARY README NAME "THIS README FILE!"

the command will extract the first four bytes from this document and then match every file that contains
these bytes at offset zero which is very cool but definitely not too useful, as immediately apparent. :-)

It is a good idea to stick to the default MODE=EXTENSION and iff. the file type to detect is a very
particular file type, like, say, a database file, only then use MODE=BINARY for a stronger match.

-:[ License ]:-

(C) MIT 2026 Wizardry and Steamworks <wizardry.steamworks@outlook.com> @ https://grimore.org

We have a lot of other Amiga/OS code and projects so definitely check us out at 
https://grimore.org/fuss/amiga or go to https://grimore.org -> SHOW INDEX -> Amiga for various other Amiga 
stuff created along the years. We have switched to MorphOS out of convenience and to reduce wear & tear to
the miggy. 

All the best to everyone still developing for the Amiga! c(^_^)-/~

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                38559   38823  99.3% -lh5- a4a2 May 16 23:54 Magic2Morph.info
[generic]                21114   47552  44.4% -lh5- b818 May 16 23:51 Magic2Morph/c/Magic2Morph
[generic]                  217     387  56.1% -lh5- 5f8d May 16 23:28 Magic2Morph/Install
[generic]                35568   37353  95.2% -lh5- 07e2 May 16 23:31 Magic2Morph/Install.info
[generic]                  659    1113  59.2% -lh5- 0e18 May 16 22:40 Magic2Morph/LICENSE
[generic]                 4563   16727  27.3% -lh5- 544d May 16 22:40 Magic2Morph/Magic2Morph.c
[generic]                  166     266  62.4% -lh5- f2ce May 16 23:05 Magic2Morph/Magic2Morph.installgen
[generic]                 5065   10848  46.7% -lh5- f279 May 16 23:51 Magic2Morph/Magic2Morph.o
[generic]                 1706    3688  46.3% -lh5- 1b0e May 16 23:42 Magic2Morph/Magic2Morph.readme
[generic]                   40      40 100.0% -lh0- 8d26 May 16 23:35 Magic2Morph/Magic2Morph.readme.info
[generic]                   69      84  82.1% -lh5- cc7e May 16 22:40 Magic2Morph/Magic2Morph.template
[generic]                  510     929  54.9% -lh5- 40bb May 16 22:43 Magic2Morph/Makefile
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        12 files  108236  157810  68.6%            May 16 23:52