Installation:

Make sure any GRP-files associated with the start menu are located at a path where Motosu will look for them.
 Motosu uses Thing groupfiles (*.GRP) to generate the start menu, and searches for INDEX.GRP in the following 
 locations (in the order as listed below):
/$HOME/motosu/
/$HOME/
/$THINGDIR/
If not found in any of these, the workdir of Motosu will be searched as a last resort.


These environmental variables are required:
$AVSERVER, $ACCPATH

Where applicable, make sure the following environmental variables are set:
$THINGDIR, $FONTSELECT, $FINDER, $SDMASTER, $TASKBAR.

	Some notes on specific aspects of the environment variables used:

	* $THINGDIR (as documented in THING.HYP up until v1.29) is used to specify the path to the
	  config and RSC files of Thing desktop. Motosu uses this for its feature to echo the
	  desktop background image, thus requiring knowledge of the image file used.

	  If Thing desktop for some reason does not honor $THINGDIR correctly, Motosu will not find the
	  config file of Thing. To work around the problem you could add a symlink with the same as the
	  config file at $THINGDIR, pointing to the location where Thing has currently placed its
	  configuration files.

	* $TASKBAR is a rather new addition to the environment variables, used by a small tool by
	  Jo Even Skarstein called "Keyboard Tweaks". Setting this to "MOTOSU  " will enable you to
	  configure a keyboard shortcut to open up the start menu of Motosu regardless of which window
	  is currently owning focus. Check it out, it is pretty cool.

 
A new environmental variable, $TAPIRSERVER (Tray and taskbar API Register) is established to point 
applications to Motosu if they wish to either change their appearance on the taskbar or create a tray object. 
To enable this functionality make sure to add the following to your setup:
$TAPIRSERVER="MOTOSU  "
 
If XaAES is targetted you get a nice and slender appearance with the following app_options:
app_options = motosu, thinwork = true, xa_nomove = false, winframe_size = -1 (if not using textured 
background, you might like winframe_size = 0 better
 
Unzip the archive and run MOTOSU.PRG. When first launched, the program will try to write cache files for icons 
and (where applicable) background textures.
NOTE: Motosu will look for PNG icons in subdir /png located in its workdir. If you add further icons to the
/png dir, it is adviced to add incremented numbering to the initial characters of the filenames. The reason for
this is that the png files will be sorted before processed and their sorted order will be used as an index in
the resulting png cache. Failing to do this will likely result in icon settings getting messed up after adding
more png icons.

The cache files are written to subdirectories of 

/$HOME/motosu/cache/

Motosu will save its configuration file to
/$HOME/motosu/ (if $HOME is not set, workdir of Motosu will be used instead)



GokMasE  2020-2024

http://motosu.gokmase.com