LSStarter Documentation

 

Installation:

Quite simple: copy the .dll into your litestep directory (i.e. c:\litestep) and add one line to your step.rc:

LoadModule c:\Litestep\LsStarter.dll

Summary:

With this module you can create batch-like groups. You can "link" these groups to certain events which are for example fired when LiteStep is started or Connection or Disconnection to the Internet is detected...
You can execute any group by using the BangCommand !ExecGroup.

step.rc

StarterNoShow - if set the InfoBox wil not be shown
StarterBackPic PicName - sets the background image of the InfoBox. All typical LiteStep specifications are allowed (i.e. 'c:\lite\back.bmp' or .extract=c:\lite\litestep.exe,3)
StarterFontFace - the FontName of the InfoText
StarterFontSize - the FontSize of then InfoText
StarterFontColor - the Fontīs color of the InfoText
StarterStaticWidth - prevents the InfoBox from beeing resized (to fit the InfoText)

You add groups through adding lines starting with '*Starter' to you step.rc

*Starter GroupName Delay PicName GroupType

GroupName - the name of the group, this is shown in the InfoBox and you can execute the group with !ExecGroup GroupName
Delay - the delay in seconds before the group is started
Picname - either the Filename of the .bmp or .extract or .extract=c:\sample.dll,5
GroupType - Autostart, Batch, Connected or Disconnected

Autostart - executed when LiteStep starts
Batch - only executed by !ExecGroup
Connected - executed when connection via dial-up networking is detected
Disconnected - executed when disconnection is detected

You add GroupEntries to these Groups through simply letting follow some lines where GroupType specifies a command (e.g. NOT Autostart, Batch, ..)

*Starter EntryName Delay PicName Command Arguments

if Command is a folder (last character is a '\') then all executable files (specified by ExeFilter in modules.ini) in there are executed. if it is a folder and the last char is not a '\' then the folder is shown.

One Group is finished if either another group definition follows (e.g. Batch as Command) or no more entries (lines starting with *Starter) are found

Sample Step.rc:

*Starter "Autostart Group" 0 .none Autostart
*Starter "First Item to execute" 3 .extract notepad
*Starter "AutostartFolder" 3 .none "C:\Win\Start Menu\Start\
;all items in Start are executed with a delay of 3

*Starter "Online" 2 .none Connected
*Starter "Netscape" 3 .extract C:\Progs\Netscape\program\Netscape.exe

modules.ini

[LsStarter]
ExeFilter=.bat, .exe, .com, .lnk
Top=ScreenHeight - 70
Left=30
Width=121
Height=58

ExeFilter - specifies the FileExtensions of the files which should be executed in case a folder is the command of a GroupEntry
Top and Left - specifie the position of the InfoBox (the window which shows up), as you see you can use screenwidth and screenheight, but only in the manner you see it: screenheight and screenwidth must be at then first position followed by +/- and an integer
Width and Height - simple integers which control the Width and Height of the InfoBox

Bang Commands

!ExecGroup <GroupName>: Executes a Group with GroupName (all GroupTypes)
!DisableOnlineWatch: Disables the internet dectection mechanism
!EnableOnlineWachtch: Enables the internet dectection mechanism if previously disabled
!CloseOpenedWindows <GroupName>: Closes all windows which were shown during the last execution of the group specified by GroupName

License:

This software is delivered on an 'as is' base. The author can in no way be held responsable for any damage caused by this software. So use it at your own risk. This is Freeware so enjoy...

Author:

You can reach the author through sending him an E-Mail to pla.ton@usa.net