¤ Introduction
¤ Installing
¤ Uninstalling
¤ Basic Usage
¤ Step.rc
¤ E-Variables
¤ Theme.rc
¤ Modules.ini
¤ LSTime
¤ X-Mouse
¤ Tips
¤ Misc. Info
¤ Support Info
¤ About the Team
Basic Usage | Step.rc |
Modules.ini | Themes |
LiteStep is a shell replacement for Windows 9x/NT that is fast, functional,stable, and very configurable. The interface resembles the famous NeXTStep operating system and also Window Maker, a X Window Manager. LiteStep consists of an executable (litestep.exe) and several modules, grouped into two basic types: core modules, which handle all the functions of LiteStep; and app modules, which are usually miniature applications that run as part of the wharf. Some examples of core modules would be wharf.dll, popup.dll, and desktop.dll, each responsible for handling their respective functions. Some application modules are lstime.dll, lsvwm.dll, lscpu.dll etc.
Installing LiteStep is very easy. But before you proceed, make sure you have the following:
Once you are ready with the approriate operating system, simply run the LiteStep installation program and follow the instructions on the screen.
IF YOU HAVE DOWNLOADED THE UPGRADE (ZIP) VERSION: Once you have unzipped the package you will find that there will be no configuration files included (i.e. step.rc, modules.ini, etc.). This distribution is solely meant for experienced LiteStep users to upgrade their existing core components, and is not intended to be a complete package.
NT Users: during the installation process, the installer will ask youwhether the install should make the appropriate changes for you so that LiteStep will be the default shell. However, there will be two ways this can be made possible. You will be asked whether to make LiteStep as a default shell for all the users (All Users) on your computer/server or to just make it as only your own default shell (Current User). If you choose to install as a default shell for all users, you may get stuck with an unbootable system if the LiteStep shell won't start. Creating a Emergency Recovery Disk (ERD) may be a good idea for fast recovery if something goes wrong.
Note: If you are upgrading from an earlier version of LiteStep, please make sure it is not running while you install this release! If you are running NT, in most cases it will let you install over your previous version of LiteStep without requiring you not to have LiteStep running.
Removing LiteStep
There is really no reason why you should un install LiteStep (because it rocks!), but here is how you do it anyway:
If you are using:
Important Note
Just in case something goes wrong, you should have a reliable boot disk on hand. This is a very easy way to fix any LiteStep related problems you might have with LiteStep loading as your shell (if you are using Windows 95/98). Simply use the boot disk to boot to DOS, cd C:\windows and edit your system.ini there. If you don't know how to do any of this, then you might wish to reconsider using LiteStep. It is up to you, the user, to anticipate and intercept any problems you might have.
If you installed LiteStep that affected:
The LSVWM (LiteStep Virtual Window Manager) manages your desktop and windows, allowing you to move and organize your open windows. The LSVWM is represented by an icon in the Wharf, consisting of four evenly divided squares.
The highlighted/colored area represents the active virtual desktop you are in.
Little rectangles or squares are shown within the whole VWM icon itself; these boxes represent the windows that exist in the desk tops.
Usage of LSVWM is as follows: This is how you use the LSVWM via key combinations, using the default configuration:
Win is the key that has the Windows Logo on it.
Changing desk tops is also possible with the mouse, which is also configurable by its resistance, that is the delay between positioning your cursor at the edge of the screen and switching desk tops. More about configuring resistance and the LSVWM key combinations are in the "Editingyour Step.rc" section.
The Task Manager allows you to manage your active tasks. It allows you to switch and kill tasks. You really have no use for it unless you have the Task Bar disabled. The Task Manager looks like any other Wharf Folder icon in your Wharf, except clicking on it will give you a list of active tasks. The tasks in the Task Manager are labeled for easy identification.
Usage of the Task Manager is as follows:
LSTime is a clock that sits in your Wharf. It will also display thecurrent date.
To adjust your time and date:
Standard Windows Conventions
These are some Windows functions you might find useful:
The Popup Menu is a user-defined list, allowing easy access to programs, files, or commands you might not use often enough to place in the wharf.
Usage is as follows:
The Wharf is a string of tiles and modules on your screen which allows you quick access to your frequently used software.
To move the Wharf, drag the Wharf to its desired location by its title bar. This will not work if NoWharfTilebar is enabled.
The Wharf Title bar is split into two parts, left and right. The sizeof
each side can be adjusted with the command WharfShadeButton n where n can be 1-63, moving the division of the title bar from1(far left) to 63(far right).
When you perform a single click on the right hand side, it collapses/expands the wharf, but does not move it anywhere.
When you double click on the right hand side, and the wharf is expanded and not in its docked position, it stays expanded and is docked to the right hand side of the screen (unless WharfDblClickDockOnLeft is set). If the Wharf is docked, and expanded, and you double click on the right hand side, it just registers two normal clicks, collapses, then expands again.
Then the left hand side... If you click and hold down the mouse on the left hand side, you can drag the Wharf around, whether it is expanded or collapsed. If you double click on the left hand side when the wharf is NOT docked to the side of the screen, and the Wharf is either expanded or collapsed, it will dock to the right hand side of the screen (unless WharfDblClickDockOnLeft is set), and expand if it was previously collapsed.
If you double click on the left hand side while the Wharf is docked and expanded, it will move it to its un-docked position (WharfDblClickXPosition n (n = number of pixels from the left hand side of the screen)) and collapses it. If the Wharf was docked to the side ofthe screen and collapsed, it simply expands the wharf, and stays docked to the side of the screen (unless it was on the opposite side from where its default docking is, then it moves it to the side of the screen it docks to).
To put the Wharf into window shade mode (minimized), double click on its title bar, or activate it by running the !ToggleWharf command from the Wharf, Shortcut, Hotkey, or Popup.
The step.rc file is the LiteStep configuration file. Everything
changed in that file affects how LiteStep looks and acts. Therefore, you may need to edit the file
the first time you install LiteStep or when upgrading to a new version. You can edit it with any text editor, such
as Notepad, Edit, TextPad, etc. We have discovered that most people decide
skip reading this section and then expect their LiteStep is expected to
work. We have also discovered that people tend to skip the mumbo jumbo
part. And since you've just gotten to the mumbo jumbo part, we'll suggest youdo the following to make
your life easier (and yes, you have to at least skim over this section):
Open the step.rc file now, and keep both that file and this manual open.
We're not asking you to read this section word for word, rather we want
you to consider this section reference material. Go ahead and go
through your step.rc file now, and where you get to something you don't
know, switch back to this window and find out what it is! Does that sound
more enjoyable? We hope so.
Afraid to touch the step.rc?
For you configure-phobic people, there are at least a couple of graphical user
interface configuration utilities available that you may be interested in. However,
at the time of this writting, none of these configuration utilties are completely
compatible with this new version of LiteStep. However, you can still download any
of these utilities from a variety of LiteStep related sites, or directly from
http://www.litestep.com/utils2.html.
These utilities (at the time of this writting), should be compatible with this new version of LiteStep
in the most part, do note it will not cover the latest features. To make use of the latest features, you
will have to edit your Step.rc manually.
Commands Index
*Wharf titlename tile [%systemname] action [parameters]
Sets a tile in the Wharf, either a folder or application tile.
If a * is placed as the first letter before tile, then anything specified in DefaultBackPix or FolderPix will not be used for this tile andwill be substituted with transparency. This tells LiteStep where to look for images. path isthe directory in which to look for images. Default: images
DefaultBackPix file.bmp
This specifies what background bitmap you want for your Wharf tiles. File must be in Bitmap (.bmp) format and be 64x64 pixels. Default: default.bmp
FolderPix file.bmp
This tells LiteStep what image to use when displaying Wharf folders.
File must be in Bitmap (.bmp) format and be 64x64 pixels. It is generally recommended
that you leave this at its default state.
WharfTileSize n
Optional setting to specify the wharf tile size. Please note that this setting only sets the height of the Wharf tile; the width isfixed at 64 pixels. Default: 64x64
WharfTitleFontSize n
Sets the font size of the Wharf tiles titles. This is only
used by the Task Manager unless you have WharfAllTitles
enabled. n is the font size (in points). Default: disabled
WharfTitleFont file
Tells LiteStep what font to use in the Wharf tiles titles. This is
only used by the Task Manager unless you have WharfAllTitles
enabled. file is the font's filename (.fon, .ttf). Default: disabled
WharfTitleFore BBGGRR
Sets the Wharf tiles title foreground color. BBGGRR is
the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white),
000000 (black), 808080 (gray). Default: FFFFFF
WharfTitleBack BBGGRR
Sets the Wharf tiles title background color. BBGGRR is
the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white),
000000 (black), 808080 (gray). Default: 802020
WharfAllTitles
Forces LiteStep to put titles on all the Wharf tiles. Default: disabled
NTStyleTaskMgr
Forces the Task Manager to behave like NT's Explorer shell; when a window
is the active window, clicking on its icon will minimize it. When this
is not enabled, Task Manager will simply switch back to the active window
when the icon is clicked on (as if nothing happened). This is generally
not recommended since it may be quite confusing (to novices). Default:disabled
WharfBevelWidth n
Sets the width of the Wharf bevel (edge thickness of the tiles.) n
is the width in pixels. Use 0 if you don't want any bevel.
Default: 1
WharfPressOffset n
Sets the offset number to shift from the original image location for
a button press effect. n is the offset number in pixels.
Default: 1
WharfNoHints
Forces LiteStep not to display any hints (ToolTips) with the Wharf tile
names when the mouse cursor is over a tile. Default: disabled
WharfNoAnim
Forces LiteStep not to animate the opening of Wharf folders. Default: disabled
Icon file.bmp [.] regexp
Defines an icon for a specified window. The . is optional, and
sets the icon's regexp as a class name instead of a window name. regexp
is the regular expression to define a window name or a class name. Wildcards
are allowed, ie: *Netscape will match any window with a title ending in "Netscape" in the title.
AutoHideWharf
Makes the Wharf auto hide when not in use. Default: disabled
AutoHideDelay
Sets the time delay between inactivity and auto hiding of Wharf and/or
TaskBar. Useless if you do not have AutoHideWharf
or AutoHideTaskbar enabled. Default: disabled, value 500
WharfNoTitlebar
Forces the Wharf not to display a title bar; the old style of displaying the Wharf. Default: disabled
Note: with this enabled, you will be unable to move the Wharf to another location. You will also be unable to toggle the window shade mode with the mouse, instead you must use the !ToggleWharf command.
WharfTitlebarPix file.bmp
Sets the image into the Wharf's title bar area. Useless if you have WharfNoTitlebar enabled.
File must be in Bitmap (.bmp) format and be 64x16 pixels.
WharfCapHeight size
Sets the size of the Wharf title bar. Default: 16
WharfAutoUnpress
Causes an opened Wharf Folder to automatically retract back into its closed state when you move the mouse off it. Default: disabled.
WharfCloseOnSwitch
Closes an opening Wharf Folder when the window focus changes. WharfFolders closes immediately if WharfNoAnim is enabled. Default: disabled.
WharfPressOffset pixels
Defines the number of pixels for a depressed Wharf Tile to move to the right and down. Default: 2
WharfAnimStep pixels
Sets the number of pixels per draw during Wharf Folder opening. Useless if you have WharfNoAnim enabled. Default: 16
WharfAnimDelay time
Sets the delay between draws during Wharf Folder opening. Useless if you have WharfNoAnim enabled. Default: 10
WharfOpenSound file.wav
Sets a sound into all Wharf Folders; when it is opening, the defined sound will be played. File must be in Wave (.wav) format.
WharfCloseSound file.wav
Sets a sound into all Wharf Folders; when it is closing, the defined sound will be played. File must be in Wave (.wav) format.
WharfMinSound file.wav
Sets a sound into the Wharf title bar; when it is going into windowshade mode (minimized), the defined sound will be played. File must be in Wave (.wav) format.
WharfMaxSound file.wav
Sets a sound into the Wharf title bar; when it is going out of window shade mode, the defined sound will be played. File must be in Wave (.wav) format.
SystrayDockToWharf
Makes all System Tray icons to go into a Wharf Tile.
*Wharf "Systray" tile.bmp %LSSystray !none
More information maybe found by reading about the *Wharf command.
WharfDblClickDockOnLeft
Makes the Wharf dock to the left side of the screen when Double Clicked on the Wharf title bar. Default: disabled; docks to the right side of thescreen.
WharfDblClickXPosition
When this is enabled, Double clicking on the left side of the Wharftitle bar will put it into Window Shade mode and will also move the Window Shaded Wharf to the specified X (horizontal) position. Default: disabled.
WharfShadeButton n
Used to adjust the division of the WharfTitleBar in relation to itsdual functions. n can be 1-63, moving the division of the title bar from 1(far left) to 63(far right).
SnapToSensitivity n
Sets the distance (in pixels) before the Wharf snaps to the edge ofthe screen. n is the distance number of pixels. Default: 16
*Popup action [parameters]
Sets an entry or folder into the Popup menu.
PopupTitlePix file.bmp
Sets the image to be used for the Popup Menu's title bars. File must be in Bitmap (.bmp) format and at an approximate width of 400.
PopupBottomPix file.bmp
Sets the image to be used for the Popup Menu's bottom. File must bein Bitmap (.bmp) format and at an approximate width of 400.
PopupEntryPix file.bmp
Sets the image to be used for the Popup Menu's normal, unselected entries. File must be in Bitmap (.bmp) format and at an approximate width of 400.
PopupSelEntryPix file.bmp
Sets the image to be used for the Popup Menu's highlighted, selected entries. File must be in Bitmap (.bmp) format and at an approximate width of400.
PopupTitleColor BBGGRR
Sets the font color for the Popup Menu's title entries. BBGGRR is the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white),
000000 (black), 808080 (gray). Default: FFFFFF
PopupEntryColor BBGGRR
Sets the font color for the Popup Menu's unselected entries. BBGGRR is the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white),
000000 (black), 808080 (gray). Default: 000000
PopupSelEntryColor BBGGRR
Sets the font color for the Popup Menu's selected entries. BBGGRR is the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white),
000000 (black), 808080 (gray). Default: 000000
PopupTitleBack BBGGRR
Sets the background color for the Popup Menu's title entries. BBGGRR is the RGB color code to be used. hexadecimal numbers such as:FFFFFF (white),
000000 (black), 808080 (gray). Default: FFFFFF
PopupNormalBack BBGGRR
Sets the background color for the Popup Menu's unselected entries. BBGGRR is the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white),
000000 (black), 808080 (gray). Default: FFFFFF
PopupSelBack BBGGRR
Sets the background color for the Popup Menu's selected entries. BBGGRR is the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white),
000000 (black), 808080 (gray). Default: FFFFFF
HotListName "name"
Sets the name of the Popup Menu title. ie: HotListName "The List" Default: HotList
MinPopupWidth n
Sets the minimum Popup width. n is the width in pixels. Default: 100
PopupFixedWidth n
Sets a fixed width for the Popup menu. Default: disabled
NoPopupBevel
Disables the bevel in the Popup Menu entries. Default: disabled
PopupFontFace fontname
Specifies the font to use in the Popup Menu. ie: PopupFontFace "Times New Roman (Western)" Default: Comic Sans MS
PopupFontHeight n
Specifies the font size to be used in the Popup Menu. n is the pixel size number. ie: PopupFontHeight 10. Default: 14
ShrinkPopupBar
Shrinks the bitmap (.bmp) used in the Popup to fit the Popup Menu size. Default: disabled
NoPopupTransparent
Disables Popup Menu transparency; may increase performance. Default: disabled.
PopupTextOffset n
Sets the number of pixels from the left of the Popup menu before displaying text and also cutting off any overflowing text from the number of pixels from the right. n is the number of pixels.
NoPopupFolderIcon
Disables the display of the Popup folder arrow. Default: disabled
ShowPopupIcons
Enables the display of standard Windows icons in the Popup Menu. Default: disabled
PopupDefaultIcon file.ico
Sets the default icon to be displayed in the Popup Menu when no icons are found in particular Popup entries. file.ico must be an Icon file (.ico). Useless if ShowPopupIcons is disabled.
PopupIconSize n
Sets the size of the Popup Menu icons. n is the size of the icons in pixels. Default: 20
PopupTaskDefaultIcon file.ico
Sets the default icon for the Popup Task Manager. file.ico must be an Icon file (.ico). Useless if ShowPopupIcons is disabled and if !PopupTasks is not used.
PopupEmptyDefaultIcon file.ico
Sets the default icon for all "empty" Popup entries. file.ico must be an Icon file (.ico). Useless if ShowPopupIcons is disabled.
PopupUseDesktopIni
Makes the Popup Menu use the Desktop.ini file in your Windows directory so that the Popup Menu will use the Font and Display settings you have set in the Display Properties. Default: disabled
*Shortcut "titlename" x y image1.bmp image2.bmp image3.bmp [group] [MouseOverSound.wav] [ClickSound.wav] action [parameters]
Sets a Application Shortcut on the Desktop.
ShortcutMouseOverSound file.wav
Sets a sound into the Shortcuts when the mouse cursor over a Shortcut, the defined sound will be played. File must be in Wave (.wav) format.
ShortcutClickSound file.wav
Sets a sound into the Shortcuts when the mouse is clicked on a Shortcut, the defined sound will be played. File must be in Wave (.wav) format.
Hotkey
*Hotkey modkey hotkey action
Binds a combination of keys so that when pressed it will execute a command or action.
Taskbar
Makes the Taskbar move off screen when it is not in use. You may also set the AutoHideDelay. Default: disabled
HideApplication
Forces LiteStep not to display its icon in the Alt-Tab window. Default: enabled
TrayIconSize n
Sets the size of the icons in the Tray area. n is thesize of the icons in pixels. Default: 16
MSTaskBar
Forces your taskbar to be displayed in Microsoft's style. Default: disabled
NoTaskBar
Prevents the taskbar from being displayed. System Tray icons will still be displayed on the desktop. Use the Task Manager to switch and manage your tasks. Default: disabled
StripTaskBar
Makes it so that the Wharf (when docked to the side of the screen) and Taskbar do not overlap each other. Default: disabled
LSTaskBarFore BBGGRR
Sets the foreground color for the Taskbar, usually used to create abevel effect.
BBGGRR is the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray). Default: FFFFFF
LSTaskBarFore2 BBGGRR
Sets the second foreground color for the Taskbar, usually used to create a depth effect.
BBGGRR is the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray). Use 202020 for a depth effect. Default: FFFFFF
LSTaskBarBack BBGGRR
Sets the background color for the Taskbar. BBGGRR is the RGB color code to be used.
hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray). Default: 808040
LSTaskBarText BBGGRR
Sets the color used for the text for the Taskbar. BBGGRR is the RGB color code to be used.
hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray). Default: FFFFFF
TaskbarStartButton
Enables the Start Button in the Taskbar. Default: disabled.
StartButtonSkin file.bmp
Sets the image to be used for Start Button (center image). File must be in Bitmap (.bmp) format. Transparency is supported. Useless if TaskbarStartButton is disabled.
StartButtonLeft file.bmp
Sets the image to be used for Start Button (left image). File must be in Bitmap (.bmp) format. Transparency is supported. Useless if TaskbarStartButton is disabled.
StartButtonRight file.bmp
Sets the image to be used for Start Button (right image). File mustbe in Bitmap (.bmp) format. Transparency is supported. Useless if TaskbarStartButton is disabled.
StartButtonSize pixels
Sets the width of the Start Button. Useless if TaskbarStartButton is disabled.
StartButtonText "text string"
Sets the text to be used in the Start Button. Useless if TaskbarStartButton is disabled.
TaskbarSkin file.bmp
Sets the image to be used for the Taskbar. File must be in Bitmap (.bmp) format.
LSTaskButtonSkin file.bmp
Sets the image to be used for the Taskbar's Inactive Task button (center image). File must be in Bitmap (.bmp) format. Transparency is also supported.
LSTaskButtonLeft file.bmp
Sets the image to be used for the Taskbar's Inactive Task button (left image). File must be in Bitmap (.bmp) format. Transparency is also supported.
LSTaskButtonRight file.bmp
Sets the image to be used for the Taskbar's Inactive Task button (right image). File must be in Bitmap (.bmp) format. Transparency is also supported.
LSTaskButtonSkinActive file.bmp
Sets the image to be used for the Taskbar's Active/Current Task button (center image). File must be in Bitmap (.bmp) format. Transparency is alsosupported.
LSTaskButtonLeftActive file.bmp
Sets the image to be used for the Taskbar's Active/Current Task button (left image). File must be in Bitmap (.bmp) format. Transparency is also supported.
LSTaskButtonRightActive file.bmp
Sets the image to be used for the Taskbar's Active/Current Task button (right image). File must be in Bitmap (.bmp) format. Transparency is also supported.
TaskbarNoSkinShift
Forces the Taskbar skin not to move.
TaskbarNoTextShift
Forces the Taskbar text not to move.
SetDesktopArea
Enables the manual configuration of the Desktop workspace area; allows you to define how you want your maximized windows to be positioned and occupy your desktop workspace area. Default: disabled
SDALeft n
Sets the number of pixels from the left side of the screen before beginning the Desktop workspace area. Setting this will affect how far left a window will maximize to. n is the number of pixels. Default: disabled
SDARight n
Sets the number of pixels to occupy from the right side of the screen; how far right the Desktop workspace area occupies. Setting this will affect how far right a window will maximize to. n is the number of pixels. You may also specify a negative number, which will be counting the number of pixels from the right side of the screen towards the left. Default: disabled
SDATop n
Sets the number of pixels from the top side of the screen before beginning the Desktop workspace area. Setting this will affect how far up a window will maximize to. n is the number of pixels. Default: disabled
SDABottom n
Sets the number of pixels to occupy from the bottom side of the screen; how far down the Desktop workspace area occupies. Setting this will affect how far down a window will maximize to. n is the number of pixels. You may also specify a negative number, which will be counting the numberof pixels from the bottom side of the screen towards the top. Default: disabled
VWMVelocity n
Sets the virtual window switching resistance. n is the number of milliseconds that the mouse cursor has to be at the edge of the screen before switching virtual windows. Default: 300
VWMNoAuto
Forces the VWM to load with Auto-Switching of virtual windows disabled.
VWMNoGathering
Prevents LiteStep from gathering all windows to the first desktop during Recycling or startup. Default: enabled
VWMSecurityDistance n
Sets the distance from the edge of the screen the mouse cursor has to be before performing a virtual desktop switch. Default: 5
VWMBackColor BBGGRR
Sets the color of the background. BBGGRR is the RGB color code to be used.
Hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray). Default: 808040
VWMSelBackColor BBGGRR
Sets the color for the current virtual desktop status indicator. BBGGRR is the RGB color code to be used.
Hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray). Default: 404040
VWMForeColor BBGGRR
Sets the color of the foreground; the color for the indicators of the windows on the desktop. BBGGRR is the RGB color code to be used.
Hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray). Default: FFFFFF
VWMBorderColor BBGGRR
Sets the border color of the VWM. BBGGRR is the RGB color code to be used.
Hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray). Default: 404040
VWMNoBackBmp
Disables the use of Wharf Tiles and transparency in the VWM; will use the old, pre-0.24.x VWM "look". Default: disabled.
VWMDesksX x
Defines the number of virtual desk tops columns to have. Multiply this value with the VWMDesksY one to get the total number of virtual desk tops. x is the number of columns. Default: 2
VWMDesksY y
Defines the number of virtual desk tops rows to have. Multiply thisvalue with the VWMDesksX one to get the total numberof virtual desk tops. y is the number of rows. Default: 2
VWMNoSwitchOnFocus
Prevents unwanted virtual desktop switches when LiteStep is in focus (foreground/active task). Default: disabled
VWMFocusCenter
Makes it so that any window in the center of the screen will come into focus (become foreground/active task) after a virtual desktop switch. Default: disabled
LoadModule file.dll
Loads non-Wharf LiteStep component, such as popup.dll, wharf.dll, etc. file.dll is the
file to load, you may also specify a path.
USClock
Forces the clock to display in 12 hour time (AM/PM). LSTime support this, and some other third-party clock replacements do too. Default: disabled (24 hour time)
LSTimeThemeFile file.thm
Loads a LSTime theme file that allows you to customize its looks. file.thm is the theme file
to load, you may also specify a path.
ThemeFile file
Loads a LiteStep theme.rc file that allows you to load a pre-made theme. file is the theme file
to load, you may also specify a path.
SystrayOrientation orientation
Changes the orientation of the System Tray. For orientation, you may use a combination of top or bottom, left or right, and vertical to define the orientation of the System Tray. Top and vertical are only used when NoTaskBar is enabled.
SystrayWrapCount n
This sets the number of System Tray icons to be displayed before wrapping over
to the next row or column. Setting this to a large number will keep itfrom
wrapping. n is the number of System Tray icons to be displayed before wrapping
over. This is only used when NoTaskBar is enabled.
!Bang Commands (Actions)
These are actions, built into lsapi.dll or the modules included with the official distribution, that can be used from anywhere in LiteStep - Wharf, Popup, Hotkey, or Shortcut. They are placed where a command would be placed: i.e.*Wharf "Recycle" recycle.bmp !Recycle would give you a wharf button that recycles LiteStep. You may also stack multiple actions to a command: i.e. *Wharf"Recycle" recycle.bmp !Gather !Recycle
!Recycle
Reload LiteStep and its configuration (step.rc & modules.ini) files.
!None
Used to avoid an error message when the Operating System would normally expect some sort of action to perform.
!About [Detailed]
Brings up the LiteStep About box which will show the version of LiteStep that is currently running and displays a list of loaded LoadModules and their version numbers.
!Shutdown
Brings up the Shutdown dialog box.
!Logoff
Closes all active programs and logs you off from your user account.
!Run
Brings up the run dialog box.
!Gather
Gathers (moves) all windows to the current desktop
!ToggleWharf
Toggles the Wharf WindowShade mode on or off.
!WharfTasks
Opens the LiteStep Task Manager. This may only be used in the Wharf, and is a function of the wharf.dll module calling the task.dll module (not theLSAPI itself).
!CascadeWindows
Cascades all windows.
!TileWindowsH
Tiles all windows horizontally.
!TileWindowsV
Tiles all windows vertically.
!MinimizeWindows
Minimizes all windows.
!RestoreWindows
Restores all minimized windows to their opened, "Restore" window state.
!Quit
Exits LiteStep
!Popup
Brings up the Popup menu.
"!PopupFolder:path"
Specifies a directory path to be displayed as a Popup folder/directory tree list. Any changes to any files or directories in the specified tree will not take effect in the Popup Menu until LiteStep has been Recycled. This
command is specific to Popups and cannot be accessed from any other
component of LiteStep such as Wharf, Hotkeys or Shortcuts.
"!PopupDynamicFolder:path"
Specifies a directory path to be displayed as a Popup folder/directory tree list. The list is refreshed every time the Popup folder list is re displayed, thus it may take a while to refresh the directory. This
command is specific to Popups and cannot be accessed from any other
component of LiteStep such as Wharf, Hotkeys or Shortcuts.
!PopupTasks
Allows task switching via a Popup folder-like list. This
command is specific to Popups and cannot be accessed from any other
component of LiteStep such as Wharf, Hotkeys or Shortcuts.
!VWMDeskn
Jumps to a specified virtual desktop number. n can befrom 0 to the number of virtual desk tops you have.
!VWMLeft
Switches to the virtual desktop to the left of the current one.
!VWMRight
Switches to the virtual desktop to the right of the current one.
!VWMUp
Switches to the virtual desktop to the top of the current one.
!VWMDown
Switches to the virtual desktop to the bottom of the current one.
!ShowShortcutGroup group
Displays all shortcuts belonging to the specified group. group can be any shortcut group name that exists.
!HideShortcutGroup group
Hides all shortcuts belonging to the specified group. group can be any shortcut group name that exists.
!ToggleShortcutGroup group
Displays/Hides all shortcuts belonging to the specified group. Executing this action will change the state of the shortcut group to the opposite state. group can be any shortcut group name that exists.
!SwitchToShortcutGroup group
Displays all shortcuts belonging ot the specified group, and hides all other shortcuts. group can be any shortcut group name that exists.
E-Variables:
E-Vars are concise pointers, to longer strings of text, that can be inserted and
used anywhere in your step.rc. These pointers, inserts, are expanded by litestep into their full definition internally, to be executed as defined.
While system envirionmental variable substitution works fine with LS e-variables
most of the time, we have had reports of some people having problems with
this and so, if you have problems, try predifining them in your Step.Rc
instead of counting on system env variable expansion.
The following is a sample setup of custom E-vars:
; Setup custom E-Vars
In brief: $E-Vars$ are recursive, definable variables that can point to any string/program/directory/command that you would normally type out in the Step.rc. Then this E-Var can be used anywhere in your step.rc as long as you put dollar signs around it (i.e. $E-Var$).
NOTE:
Theme.rc
Litestep 0.24.0 included a new, though
lightly documented feature: internal theme support. This new feature will
finally enable average Litestep users to download a theme, and have it installed
& functioning with a minimum of effort or modification to their existing
system.
Windows 95/98
Method 1:
[boot]
(a bunch of stuff you shouldn't care about)
shell=C:\LiteStep\LiteStep.exe
Method 2:
Windows NT
Current User Only
All Users
Current User Only
HKCU\Software\Microsoft\Windows NT\CurrentVersion\Winlogon
Shell
All Users
Note: You will need Administrator access privileges.
HKLM\Software\Microsoft\Windows NT\CurrentVersion\WinLogon
Shell,
Original Value:
C:\LiteStep\LiteStep.exe
New Value:
Explorer.exe
Basic usage
¤ Using The Popup
¤ Wharf
¤ Transparency
¤ Loading Themes
LSVWM - Virtual Desktop Manager
As you can see in this sample graphic, the little white boxes are the windows that exist on each of your virtual desk tops.
The LSVWM is also accessible through key combinations to switch desk tops. Those key combinations are already pre configured for you in the Step.rc file for your convenience.
Left Click & Drag
(on the window representations)=
Drags windows between or within desk tops
Right Click
=
Switches to the desktop you clicked on
Win + Right Arrow
Win + Left Arrow
Win + Up Arrow
Win + Down Arrow
Task Manager
Left Click
=
Switches to the selected task
Right Click
=
Opens the System Menu
Shift-Right Click
=
Sets the selected icon to a Window Class (useful to set a 64x64 icon)
LSTime
You may also customize LSTime if you wish.
Left Double-Click
=
Opens the standard
Windows Time & Date Properties
Alt-Tab
=
Switches between tasks, hold down Alt for a menu of active tasks
Alt-Shift-Tab
=
Same as Alt-Tab, except it goes in reverse.
Alt-Space
=
Brings up the System Menu
Alt- -
(that's minus)=
Brings up the Group Menu (that is, if you have a window within a window, you bring up the menu of the sub window)
Alt-Esc
=
Cycles through all open windows
Alt-F4
=
Closes the active task
Ctrl-F4
=
Closes the active Group window
F10
=
Same function as Alt, brings up the menu (Usually File)
Ctrl-Shift-Esc
=
Loads NT's built-in Task Manager (WinNT only.)
Popup Menu
Right-Click
=
Brings up the Popup Menu (click on the Wharf or Desktop). You can also bring up the Popup Menu by pressing the WIN Key once(if there is no available space on the desk top on which to right-click).
Up/Down Arrow
=
Navigates through the menus and highlights a listing
Left Arrow
=
Navigates to the menu one level up from the current sub menu
Right Arrow
=
Opens the highlighted Sub menu
Enter
=
Runs the highlighted task, or if it is a Sub menu it opens it.
Page Up/Page Down
=
Navigates through the menus quickly
Wharf
Editing your step.rc
Wharf
PixmapPath path
titlename
the title name of the tile as it would appear in the Tile Hints
tile
the tile (icon) to use for the Wharf tile.
The tile can be in one of 3 formats:
Bitmap (.bmp) - tile.bmp
Icon within a DLL library (.dll) - ".extract=file.dll,n"
Icon within a Executable file (.exe) - ".extract=file.exe,n"
,n is the icon number, starting from 0. If no ,n is used, it assumes it to be icon 0.
%systemname
this is optional. This defines the tile with a Wharf SystemName. Some modules such as LSAmp use it for example.
action
this tells the tile what to perform.
Can be one of:
Program Path (ie: C:\Windows\notepad.exe)
Folder, which tells the tile to act as a folder andbegin a folder subsection (anything after this will be inside the folder until ended by a ~Folder).
~Folder will end the folder subsection; anything after it will not be in the above folder.
A static !action command built into LiteStep.
Note: you must load Wharf.dll before Desktop.dll is loaded!
To define a Wharf Tile for all the System Tray icons, add the following line:
Popup
entryname
the title name of the entry as it would appear in the Popup menu
action
this tells the Popup entry what to perform.
Can be one of:
Program Path (ie: C:\Windows\notepad.exe)
Folder, which tells the entry to act as a folder and begin a folder subsection (anything after this will be inside the folder until ended by a ~Folder).
~Folder will end the folder subsection; anything after it will not be in the above folder.
A static !action command built into LiteStep such as
!PopupFolder and !PopupDynamicFolder.
Warning: negative side effects may occur when using a font size that does not fit in the Popup Menu (>17 pixels).
Note: All Bitmaps should be the same size when using this setting,otherwise the Popup Menu may not display correctly as the bitmap(s) may become distorted.
Shortcut
titlename
the title name of the Shortcut as it would appear in the Shortcut Hints
x
The horizontal position to be used for the Shortcut. x starts from the left side of the screen. All Shortcuts' extreme left line up with the defined x position. Must be used with y.
Specifying a negative number is the same as screenwidth - number.
y
The vertical position to be used for the Shortcut. y starts from the top of the screen. All Shortcuts' extreme top line upwith the defined y position. Must be used with x.
Specifying a negative number is the same as screenwidth - number.
image1.bmp
the icon to use for the shortcut when it is inactive. Filemust be in Bitmap (.bmp) format.
image2.bmp
the icon to use for the shortcut when the mouse is over it. File must be in Bitmap (.bmp) format.Use .none for no animation; old style Shortcuts.
image3.bmp
the icon to use for the shortcut when the mouse clicks on it. File must be in Bitmap (.bmp) format.Use .none for no animation; old styleShortcuts.
group
specifies what group the shortcut belongs to. (Optional)
MouseOverSound.wav
See ShortcutMouseOverSound.
ClickSound.wav
See ShortcutClickSound.
action
this tells the shortcut what to perform.
Can be one of:
Program Path (ie: C:\Windows\notepad.exe)
A static !action command that is built into LiteStep.
modkey
Keystroke modifier, can be one of: Ctrl, Alt,or Win
hotkey
This sets the key you want to use. It can be either: A-Z, 0-9, F1-F12, Left (Arrow), Right (Arrow), Up (Arrow), Down (Arrow), Home, End, PageUp, PageDown, Insert, Delete, Escape, Spacebar, Backspace, Apps (Application key, the one next to Right Win Key).
action
this tells the Popup entry what to perform when the hotkeyis pressed.
Can be one of:
Program Path (ie: C:\Windows\notepad.exe)
A static !action command built into LiteStep.
Desktop
VWM
Misc
The [Detailed] parameter will give detailed information about your LiteStep components, such as the date it was built.
Warning: once LiteStep has exited, you will be left with no shell.Do not use this unless you know what you are doing!
LiteStepDir c:\litestep\
; Sample uses of above E-Vars
ProgramDir c:\windows\start menu\programs\
StepRC $LiteStepDir$step.rc
TextEditor $WinDir$notepad.exe
EditStepRC $TextEditor$ $StepRC$
EmailClient c:\program files\email\email.exe
Browser c:\program files\opera\opera.exe
*Hotkey Win Q $EditStepRC$
Notice the quotation marks around the $EmailClient$ and $Browser$, this is because the contents of those two are long file names, and need to have quotationmarks. That is a very key notation that you will need to include. However, there is another option, and that is to put single quotes around theE-Var originally like this:
*Popup Programs !PopupFolder:$ProgramDir$
*Wharf Email Client email.bmp $EmailClient$
*Wharf Internet Browser browser.bmp $Browser$
Browser "'c:\program files\opera\opera.exe'"
Then you would not need to put full quotes around the $Browser$ in the *wharf definition.
System environmental variables can be directly expanded as LiteStep e-variables in the e-variables section. For example, if you want to point to the Windows directory, you simply have to say $WINDIR$.
FAQ by tin_omen
* It uses a theme.rc file to
do 2 things,
- segregate theme-specific appearance settings
into a separate file that can be swapped out to change themes
-
provides a step.rc item command-line matching system to allow a theme author
to match a graphic with a users use of a specific app (i.e.
ns.bmp can be mapped to be used with lines executing netscape.exe)
*It (recommends but doesn't
require) a new directory structure to organize themes into separate
directories:
c:\Litestep | \Themes |
\ThemeX \ThemeY |
\images \sounds \utils \Liteinfo ...etc... ...etc. |
In the above each theme is segregated into it's own dir structure. Each dir contains the following items (at least the way that I am currently using them):
c:\Litestep | Contains the core LS DLL's, .exe's .apps modules etc. as well as the modules.ini & step.rc file (all graphics oriented around the default theme located in .\litestep\themes\default\images for fall-back support for graphics unsupported in specific themes). |
c:\litestep\Themes | I've started keeping LiteInfo v1.05's theme.ini files designed around specific themes here, renamed to theme specific names (ie. the LiteInfo .ini file for my brom2 theme is named 'Linfo_brom2.ini' |
c:\litestep\Themes\ThemeX | Theme readme's, lstime thm files, and the theme.rc |
c:\litestep\Themes\ThemeX\images | all theme related bmp's as well as any lstime .bmp font files, wallpaper files etc |
c:\litestep\Themes\ThemeX\sounds | any theme-specific sound files |
c:\litestep\Themes\ThemeX\utils | any non-Litestep related executables etc. I've started using a 'plus' dir below here for all MS Plus! related material I've used with the theme. |
c:\litestep\Themes\ThemeX\LiteInfo | because a LiteInfo theme is made up of a collection of related component bmp's I've started segregating Liteinfo material related to a specific LS theme in a subdir below the theme, with the related LiteInfo skin .ini file in the c:\litestep\themes dir. |
...etc... | Because this is not a 'formal' standard, you can really
include any item you'd like in other subdirectories. The whole idea is to
make it easy for folks to use.
|
*The General Section I usually put desktop-wide configuration parameters here, things like : |
; systray location (use only one)
;systrayorientation topleftvertical
;systrayorientation bottomright
;systrayorientation bottomleftvertical
systrayorientation bottomleft
;
systray wrap setting
SystrayWrapCount 21
;WharfAllTitles
*The Images
section I put the theme-related path variable definitions here,
ls24-compliant app theme file designators, and the default graphics used
on the wharf etc. -You'll note that this section also starts to use the variables that it's defining. $ThemePath$ and $ThemeDir$ for example are both defined here and make it possible to only need to edit the variable definition to change the path used throughout the entire file. The $LitestepDir$ variable is setup in step.rc (see below under 'Ok so how do I use the system?'). |
; this sets up the $ThemePath$ variable pointing at the current
;
themes images dir, for use in the rest of the theme.rc file.
; Note:
it makes use of the $LitestepDir$ variable that needs to
; be
setup at the top of step.rc file. (LitestepDir just points
; at
the root LS dir (c:\litestep in most cases)
ThemePath $LitestepDir$themes\Default\images\
; this
sets up the $ThemeDir$ variable to the root of the theme.
ThemeDir $LitestepDir$themes\Default\
; this
specifies an lsTime theme file to be used with this file
LSTimeThemeFile $ThemeDir$tinclock.thm
; these
are the regular wharf bg, folder bg, and folder marker
;
graphics lines lifted right out of a step.rc
WharfTitlebarPix $ThemePath$b24_wcap.bmp
DefaultBackPix .none
FolderPix $ThemePath$b24_foldermark.bmp
FolderBackPix $ThemePath$b24_folderpic.bmp
*The Wharf section This section includes parameters related to the wharf appearance and behavior |
; Border width on wharf items
WharfBevelWidth 0
; these
heavily effect wharf animation speed when using
;
transparency (defaults were 16 & 10) change to suit
; your
box. By placing them here, it allows you to
; use
different settings depending on the amount of
;
transparency lag seen with a particular theme
WharfAnimStep 64
WharfAnimDelay 50
*The Virtual Window Manager
section This section contains settings related to the
appearance of the vwm.dll module. |
VWMForeColor
BABCBA
VWMBackColor
707770
VWMSelBackColor
A3A5A3
VWMBorderColor 707770
*The Popups section Appearance, color, size etc. of Popupmenu items. |
PopupTitleColor
FFFFFF
PopupEntryColor
D3D3D3
PopupSelEntryColor
D3D3D3
PopupSubMenuHeight
20
PopupTitlePix
$ThemePath$b24_bartitles.bmp
PopupEntryPix
$ThemePath$b24_barnorms.bmp
PopupSelEntryPix
$ThemePath$b24_barsels.bmp
;
Specifies Font Face for the Popup bar to
use.
PopupFontFace
"Verdana"
;
Specifies Font face
Height
PopupFontHeight
14
;the
minimum width of a popup
bar
minpopupwidth
208
;
disable bevel on
popups
NoPopupBevel
*The Taskbar section Blah blah blah, taskbar settings... (you get the idea<g>) |
LSTaskBarFore FFFFFF
LSTaskBarFore2 808080
LSTaskBarBack 800000
LSTaskBarText FFFFFF
*The Shortcuts section Shortcut graphic themeing isn't currently supported, so I put the associated sound associations here |
; shortcut sounds
; mouse
over sound
ShortcutMouseOverSound c:\litestep\themes\Default\sounds\ding.wav
; click
sound
ShortcutClickSound
c:\litestep\themes\Default\sounds\comp_up.wav
*Theme Pictures mappings section
This
is the meat of the theme.rc file. This section allows you to set up comparison
criteria to define graphics substitution assignments for *Wharf items in the step.rc
file. At the current time, the items that are searched are the command line
portion of *Wharf
entries, and the Description portion of
*Wharf Folder items.
(note: on 11/5/98, I got a note from Bryan
Kilian, that plans are in place to add support to allow matching against the
descriptions of both folder and regular wharf items. And the devteam are
definitely planning to add shortcut graphic substitution as well. Very good
news!)
*A *ThemePic entry in the
theme.rc has the following syntax:
*ThemePic <search string>
$ThemePath$graphic.bmp
where
<search sring> can use wildcards (*
& ?) and extension brackets ([ ]) for
optional items.
For example in the line:
*ThemePic *App* $ThemePath$b24_apps.bmp
'*App*' is the criteria used for searching the
step.rc, it says something like the following,
"Search all wharf item command lines or wharf folder descriptions for the following
string: anything with the letters A-p-p in the beginning middle or end of a string."
A wharf item is normally has the following step.rc
syntax:
*Wharf "description string" graphic.bmp "command line
string"
the
"command line string" portion is what
you can try to match for assigning a graphic
+And wharf folders use:
*Wharf "description string" graphic.bmp
Folder
the "description string" portion is what's matchable here.
Note, this is an exception to normal behavior! Wharf folder commands are the only items that can be matched against the description, the rest all have to match to the command line string!
+Here's some examples demonstrating the
concept:
-If the step.rc contains the following items:
*Wharf "System" b24_sys.bmp Folder
*Wharf "Edit Step.rc" b24_folder.bmp notepad c:\litestep\step.rc
*Wharf "Recycle" b24_recycle.bmp !Recycle
*Wharf ~Folder
-You can do comparison matches against the following for
each:
> in the system folder item, the string "System" is available
because it's the description
portion
>in the 'edit step.rc'
item, the string "notepad c:\litestep\step.rc" is searchable
>because it's the command line
>in the 'recycle'
item, the string "!Recycle" is searchable
because it also is a
>command line.
-So, using each of the above in a *ThemePic item to substitute a
new graphic for each:
*ThemePic *System* $ThemePath$b24_sys.bmp
*System* will match the system wharf folder item above, because the letters 's-y-s-t-e-m' appear in a row somewhere in a word in the Description portion of item. So the b24_sys.bmp file in the currently defined $ThemePath$ directory will be used for that wharf folder item. |
*ThemePic *step.rc* $ThemePath$b24_folder.bmp
*step.rc* will match the edit step.rc item because the command line "notepad c:\litestep\step.rc" string contains the letters "s-t-e-p-.-r-c" in a row. so the b24_folder.bmp graphic will be substituted for this item. |
*ThemePic *Recycle $ThemePath$b24_recycle.bmp
*Recycle >will match the command line of the Recycle item '!Recycle", because theletters "R-e-c-y-c-l-e-space" appear in a row in the command line. Note that *Recycle only specifies that a string has to end with the sting, instead of have it in the beginning. If 'Recycle' had been the criteria, it would require that the string " Recycle " had to appear with the spaces before & after it. |
+Finally here's a functional ThemePic section of a
theme.rc:
; I generally rem out anything generic out that I don't want to explicitly
spec a
graphic
; for, so that it defaults to the app icon images defined in the
step.rc
:
Primary Wharf
folders/items
*ThemePic *System*
$ThemePath$brm2_sys2.bmp
*ThemePic *App[ls]*
$ThemePath$brm2_apps2.bm
*ThemePic Net
$ThemePath$brm2_net2.bmp
*ThemePic *WharfTasks
$ThemePath$brm2_tasks2.bmp
;Applications
*ThemePic notepad.exe $ThemePath$b24_notepad.bmp
*ThemePic wordpad.exe $ThemePath$b24_wordpad.bmp
*ThemePic *winword.exe $ThemePath$b24_word.bmp
*ThemePic *excel*
$ThemePath$b24_excel.bmp
*ThemePic *Photoshp.exe
$ThemePath$b24_photoshp.bmp
*ThemePic *psp.exe* $ThemePath$b24_psp5.bmp
*ThemePic *bryce3d*
$ThemePath$
*ThemePic *winamp.exe*
$ThemePath$speaker2.bmp
;Internet
Applications
*ThemePic *iexplor*
$ThemePath$brm2_ie4.bmp
*ThemePic *net Expl*
$ThemePath$brm2_ie4.bmp
*ThemePic *netscape* $ThemePath$b24_web.bmp
*ThemePic *irc* $ThemePath$b24_irc.bmp
*ThemePic *dun*
$ThemePath$b24_dun.bmp
*ThemePic dialup
$ThemePath$b24_dun.bmp
*ThemePic winternet*
$ThemePath$b24_dun.bmp
*ThemePic *eudora* $ThemePath$b24_mail.bmp
*ThemePic *outlook* $ThemePath$b24_mail.bmp
*ThemePic *pegasus* $ThemePath$b24_mail.bmp
*ThemePic *ftp*
$ThemePath$b24_ftp.bmp
*ThemePic news*
$ThemePath$b24_news.bmp
*ThemePic *agent*
$ThemePath$b24_news.bmp
*ThemePic *Altavista* $ThemePath$b24_websearch.bmp
*ThemePic *\DejaNews $ThemePath$b24_newssearch.bmp
;Drives
*ThemePic a:\\
$ThemePath$
*ThemePic c:\\
$ThemePath$
*ThemePic d:\\
$ThemePath$
*ThemePic e:\\
$ThemePath$
*ThemePic *drives*
$ThemePath$
;Modules
*ThemePic *lslm*
.none
*ThemePic *cpu.dll*
.none
*ThemePic *lsmix* .none
Note 'dummy'/nonfunctional decorative wharf items (like my vwm framing graphics) which are officially supposed to use the LS standard !None command won't map properly in the theme.rc because '!none' is the only command line returned for all of them. You can set up a '*None' Themepic spec, but all !None items will match to it and use the same graphic. I've worked around this by pointing each of them in the step.rc at a uniquely named .txt file that gives me something distinctive to compare against. |
*ThemePic *vwmframe1* $ThemePath$brm2_vwmtop2.bmp
In my step.rc the line item being matched to uses
the following syntax: *Wharf Vwmtop b24_vwmtop2.bmp vwmframe1.txt 'vwmframe1.txt' doesn't exist, and will throw a 'file not found' error if someone clicks on the graphic, but it does enable you to 'theme' the graphic properly. You could also actually make them functional maybe WharfToggle commands etc. |
*ThemePic *vwm.dll* $ThemePath$brm2_vwmbg.bmp
*ThemePic *vwmframe2* $ThemePath$brm2_vwmbot.bmp
Same story here, the step.rc line being matched to
above is: *Wharf Vwmbot b24_vwmbot.bmp vwmframe2.txt |
*ThemePic *lstime.dll* $ThemePath$brm2_lstime.bmp
*ThemePic *RemoteIT.app*
.none
;System
Tools
*ThemePic *command*
$ThemePath$b24_dos.bmp
*ThemePic *XTerm.pif
$ThemePath$b24_dos.bmp
*ThemePic *4dos*
$ThemePath$b24_dos.bmp
*ThemePic MSDos $ThemePath$b24_dos.bmp
*ThemePic *dos* $ThemePath$b24_dos.bmp
*ThemePic *bash* $ThemePath$b24_bash.bmp
*ThemePic *lce.exe*
$ThemePath$
*ThemePic *step.rc* $ThemePath$b24_folder.bmp
*ThemePic *\explorer.exe $ThemePath$b24_explorer.bmp
*ThemePic *Logoff
$ThemePath$b24_logout3.bmp
*ThemePic *Run $ThemePath$brm2_run.bmp
*ThemePic *Shutdown
$ThemePath$b24_shutdown.bmp
*ThemePic *Recycle $ThemePath$b24_recycle.bmp
*ThemePic *Display* $ThemePath$control2.bmp
You'll note that these items are matching to the distinctive number sequences used in the explorer /root keys in the step.rc |
;Control
Panel
*ThemePic
*/root,,::{20D04FE0-3AEA-1069-A2D8-08002B30309D}\\
::{21EC2020-3AEA-1069-A2DD-08002B30309D}*
$ThemePath$b24_cntrlpanel.bmp
;Network
Neighborhood
*ThemePic *208D2C60-3AEA-1069-A2D7-08002B30309D*
$ThemePath$b24_netneigh2.bmp
Ok so how do I use the system? | |
*The user has to have the following new
items at the top of his step.rc (instruct him to add them in your theme
docs) - LitestepDir c:\litestep\ this is used throughout Litestep now for graphics pathing. It creates a variable $LitestepDir$ that is in turn used in the theme.rc to define other path variables. - ThemeFile c:\litestep\themes\Default\theme.rc this specifies exactly which theme.rc file is to be used with Litestep. To change theme, you simply change this setting to point at the new themes theme.rc.
| |
* You need to make sure the following
applies to your
theme: A. Use the above dir structure (recommended, but not essential) (I'll generally copy an entire existing theme's dir structure into place & rename things to suit) B. Copy the example theme.rc into place in your new \litestep\themes\ThemeX dir C. Edit the theme.rc to suit your theme: -Edit the ThemeDir & ThemePath entries to match your theme's directory name -Specify your theme-specific LSTimeThemeFile (if you made one) -Copy the following settings from your step.rc into the theme.rc (if they vary from the norm). Use '.none' for any items that you want to blank when the step.rc settings may specify something else. Also, remember to use the $ThemePath$ variable for your graphic specifications (it cuts down typing time and makes it easier to rename the theme dir without having to search & replace the setting throughout the theme.rc. Not to mention if you don't include it, you'll end up with mysterious missing graphic items.<g>) WharfTitlebarPix DefaultBackPix FolderPix FolderBackPix PopupTitlePix PopupEntryPix PopupSelEntryPix WharfBevelWidth 0 WharfAnimStep 64 WharfAnimDelay 50 include the above two if needed due to transparency lag on slower boxes VWMForeColor VWMBackColor VWMSelBackColor VWMBorderColor PopupTitleColor PopupEntryColor PopupSelEntryColor LSTaskBarFore LSTaskBarFore2 LSTaskBarBack LSTaskBarText ShortcutMouseOverSound ShortcutClickSound PopupSubMenuHeight PopupFontFace PopupFontHeight minpopupwidth NoPopupBevel D. Edit the existing *ThemePic entries to point at your theme's equivalent graphics.
| |
*And finally Test
it! -Make sure your using the above user's LitestepDir & ThemeFile items in your step.rc and then recycle, tweak, recycle, etc.
| |
Extra
Considerations: Litestep 0.24 supports a number of new features that will heavily influence new themes produced to run on it: *Mobile wharf -You can no longer depend on the wharf to stay where you intended it to be (due to the mobile wharf support). I try to avoid designing my wallpapers with only one position for the wharf. Instead, I've even gone as far as to design the wallpaper & wharf completely distanced from each other (I used to draw my wharf in a layer over the wallpaper, I now tend to hide the wallpaper while working on the wharf). -Also, although you may prefer a right side wharf, others may want a left side wharf, or even one right down the middle. You may want to avoid designing a wharf that looks 'odd' when on the opposite side from where you designed it. (I got caught in this trap myself when designing the LS24 Default theme, it's obviously a right side wharf.<g>) I now test run my stuff for a while with the wharf in unusual locations, to see how they look. * Transparency Support - This one's a toughie. Transparency is VERY cool to look at, but it comes at a significant cost. Your P2/266 with 64mb of ram may run fine with that spider web transparent wharf you put together, but the first user to try it on a slower box, will complain loudly when the wharf folders crawl out. -There are three things you can do to address this situation 1. The obvious option is to avoid heavy use of transparency, heh but who am I kidding, folks designing themes are about looks over performance right?<g> 2. You can tweak the WharfAnimStep & WharfAnimDelay settings. They effect the animation speed of the wharf folders, by adjusting the 'jump' between frames & the delay between rendering of the frames on screen. In general higher numbers improve performance, but will make the animation a bit choppier (fewer frames farther apart). 3. If you want to get technical (at least to the extent that this pixel-tweaker understands it), you can address the root causes of the problem: The way Windows draws partially transparent objects on screen. Basically when Litestep assembles the combination of a transparent application icon, on top of a transparent folder background picture, it sandwiches them together to produce a composite image. This composite image is then passed on to Windows to be displayed. The first thing windows does with the object is attempt to break up the non-transparent parts of the object into regular rectangular sections. If the object's visible outline is rectangular to start with, Windows cuts it into a few squares and draws it on screen. But if it's an irregular outline, then Windows has to carve it up into a bunch of smaller rectangles that fit the outline before it can draw it. The worst extension of this effect would be dithered transparency (i.e. alternating the color 255,0,255 with another color every pixel or so to make the wharf appear to be semi-transparent), as this would force Windows to carve each 64x64 tile into a huge number of tiny nontransparent regions before it can draw them.
| |
Some ported complete themes that you can
look at for reference: -I've done a port of my Default ls24 theme to the new standard,here 468k (non background distro, the backgrounds by themselves are here 635k). -MHolmesIV & mian have ported fluid's Deception theme to the standard, it's available at MH4's site.
|
The Modules.ini file is the LiteStep Modules configuration file, although nearly all modules can also be configured directly in the step.rc. Everything changed in the modules.ini file affects how LiteStep's modules look and act. LiteStep includes some components that uses the Modules.ini file, which are explained below. Some third-party modules use the modules.ini file as their configuration file.
VWM Sticky Windows
Sticky windows is a feature that allows you to set any window on the desktop of your choice which will allow the window to be in your active virtual desktop all the time. This means the VWM will move the window, thus following you to another virtual desktop you switch to.
To use sticky windows:
1. Open the modules.ini file, create it if it does not exist. 2. Define the sticky window(s) by entering the following text: [LSVWM]
stickies=n
stickyW=windowname
stypeW=nstickies=n this sets the number of sticky windows you wish to use. n is the number of sticky windows. stickyW=windowname This defines the sticky window number and its window name.W is the sticky window number. windowname is the window titlename, you must type in the exact case of the window you wish to stick. You may also set the windowname based on the window's Window Class, if you don't know what this means, don't worry about it. You may also use wildcards when defining the window name. To use wildcards, place a * before the first letter of the windowname.
stypeW=n This is optional and allows you to force the use of windowtitles (text as it appears in the window title bar) instead of Window Classes. W is the window number. For n, using 1 means window class is forced, 0 means it will use the Window Title. If nostypeW=n is defined, it assumes the n value of 0.
LSTime allows you to fully customize the clock to the way you want it to look. To define the looks, LSTime incorporates Theme (.thm) files. You either have to create a theme file or modify one.
BitmapFile file.bmp
The "skin" image file to be used for your clock. File must be in Bitmap (.bmp) format.
DigiClockFont x y width height
x The horizontal position to be used for the digital clock font. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the digital clock font. y starts from the top of the tile. The first character's extreme top line up with the defined y position. Must be used with x. width The width of the font. Must be used with height. height The height of the font. Must be used with width. DateFont x y width height
x The horizontal position to be used for the digital clock font that displays the day, month, and year. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the digital clock font that displays the day, month, and year. y starts from the top of the tile. The first character's extreme top line up with the defined y position. Must be used with x. width The width of the font. Must be used with height. height The height of the font. Must be used with width DigiClock x y width height
x The horizontal position to be used for the digital clock. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the digital clock. y starts from the top of the tile. The first character's extreme top line up with the defined y position. Must be used with x. width The width of the clock. Must be used with height. height The height of the clock. Must be used with width DigiDay x y
x The horizontal position to be used for the digital clock font that displays the day. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the digital clock font that displays the day. y starts from the top of the tile. The first character's extreme top line up with the defined y position. Must be used with x. DigiMonth x y
x The horizontal position to be used for the digital clock font that displays the month. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the digital clock font that displays the month. y starts from the top of the tile. The first character's extreme top line up with the defined y position. Must be used with x. Digi2dYear x y
x The horizontal position to be used for the digital clock font that displays the two digit year. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the digital clock font that displays the two digit year. y starts from the top of thetile. The first character's extreme top line up with the defined y position. Must be used with x. DigiYear x y
x The horizontal position to be used for the digital clock font that displays the year. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the digital clock font that displays the year. y starts from the top of the tile. Thefirst character's extreme top line up with the defined y position. Must be used with x. AnaDayFont x y width height
x The horizontal position to be used for the analog clock font that displays the day. x starts from the left side of the tile. The first character's extreme left line up with the defined xposition. Must be used with y. y The vertical position to be used for the analog clock fontthat displays the day. y starts from the top of the tile. The first character's extreme top line up with the defined y position. Must be used with x. width The width of the font. Must be used with height. height The height of the font. Must be used with width AnaMonthFont x y width height
x The horizontal position to be used for the analog clock font that displays the month. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the analog clock fontthat displays the month. y starts from the top of the tile. Thefirst character's extreme top line up with the defined y position. Must be used with x. width The width of the font. Must be used with height. height The height of the font. Must be used with width AnaClock x y width height
x The horizontal position to be used for the analog clock. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the analog clock. y starts from the top of the tile. The first character's extreme top line up with the defined y position. Must be used with x. width The width of the clock. Must be used with height. height The height of the clock. Must be used with width AnaDay x y
x The horizontal position to be used for the analog clock font that displays the day. x starts from the left side of the tile. The first character's extreme left line up with the defined xposition. Must be used with y. y The vertical position to be used for the analog clock fontthat displays the day. y starts from the top of the tile. The first character's extreme top line up with the defined y position. Must be used with x. AnaMonth x y
x The horizontal position to be used for the analog clock font that displays the month. x starts from the left side of the tile. The first character's extreme left line up with the defined x position. Must be used with y. y The vertical position to be used for the analog clock fontthat displays the month. y starts from the top of the tile. Thefirst character's extreme top line up with the defined y position. Must be used with x.
HourHandColor BBGGRR Sets the analog clock's Hour Hand color. BBGGRR is the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray).
HourHandShade BBGGRR
Sets the analog clock's Hour Hand shadow color. BBGGRR is the RGB color code to be used. hexadecimal numbers such as: FFFFFF (white), 000000 (black), 808080 (gray).
X-Mouse is a feature that allows you to switch active windows with your mouse without having to click in the window. This feature is particularly useful when you switch around windows often and you are just tired of clicking on them. The X-Mouse idea originated with X-Window, and since then it has grown so popular, it is now offered in Windows. Thus you may use X-Mouse with LiteStep!
NOTE: Since LS transparency means that you can actually click-through to the desktop (instead of just seeing-through). With X-Mouse on, you may experience erratic behavior because, for instance, your Popups had a transparent spot and you moved yourmouse cursor over it and because you had XMouse on, it automatically changes focus to the desktop and that will mean your Popups close.
To enable X-Mouse, you must do the following:
Windows 95/98 users 1. Download the X-Mouse utility from Microsoft and save it into the LiteStep directory.
2. Run the W95x_mouse.exe file to extract the files into the LiteStep directory.
3. Run Xmouse.exe which will immediately enable the X-Mouse feature.Note: You may also create a Shortcut in the Start Menu's Startup folder so that X-Mouse would be enabled every time you turn on your computer.
Windows NT users 1. Run the Registry Editor (regedit.exe)
2. Go to HKEY_CURRENT_USER\Control Panel\Mouse
3. Add the following DWORD Value:
Name: ActiveWindowTracking Value: 1
4. Restart the computer or Logoff and Login again for the feature to take effect.
Here are some helpful tips that will help you configure and enjoy your LiteStep better:
Explorer /e Opens Explorer to the Desktop folder Explorer /s file.cab Opens a Cabinet (.cab) file. Exit To Dos.PIF Running this file will Shut Down Windows and exit to DOS. (Windows 95/98 only) Popup Control Panel You can have your Control Panel items in your Popup Menu by:
Now, when you open your popup menu (assuming that you have !PopupDynamicFolder for your programs menu item, you will see that you have a new listing under 'Programs' titled 'Control Panel', which will scroll out listing all of your Control Panel applets!
- Open Windows Explorer and the Control Panel itself.
- Navigate (in Explorer) to your 'windows\Start Menu\Programs' and create a sub-directory called 'Control Panel'.
- Select all of your Control Panel applets (from the Control Panel window), then right-click\drag them to the 'Control Panel' sub-directory that you just created.
- When you release the right mouse button, select "Create Shortcut(s) Here" from the popup menu that will appear.
- Exit Explorer and the Control Panel
Control applet.cpl Runs a Control Panel applet. Example: Control mmsys.cpl .LNK files you can make .LNK Shortcut files and run them from the Wharf, LS Shortcut, Popup, or Hotkey. Associated Files You can launch any file as long as they are associated with a program. Blank Wharf Tiles To create a blank Wharf tile with transparency: *Wharf "" *. !none To disable VWM
Auto-SwitchingDouble-click on the VWM Wharf module to disable Auto-Switching, to reenable, double-click on it again. For Windows NT only:
%SystemRoot% this is the Windows NT directory, ie: J:\WINNT %SystemDrive% this is the drive Windows NT is installed on, also called the root drive. ie: J: %UserProfile% this is your profile directory where you keep your personal files (Start Menu, Desktop, etc.) RAS/DUN .rnk Shortcut files To run a NT RAS/DUN .rnk Shortcut file, use "%SystemRoot%\system32\rasphone.exe" -lt file.rnk Using Explorer under NT with LiteStep is generally not a good idea,since many unpredictable results occur from system to system.
To run multiple instances of Explorer: 1. Run the Registry Editor (regedit.exe)
2. Go to HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\Current Version\Explorer 3. Add the following DWORD Value:
Name: DesktopProcess Value: 1If you are using IE4 and up, you must do the following instead:
1. Go to HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\
CurrentVersion\Explorer\Browser\NewProcess
2. Add the following String Value:
Name: BrowseNewProcess Value: YES
For advanced users:
If you know the CLSID of an Explorer namespace, you can use it for opening a folder or program.
The following information was taken from the Microsoft® SDK Help:
Explorer.exe /e,/root,::{CLSID of item} Used when you junction point you are opening is an item that is under the Desktop. Explorer.exe /e,/root,::{20D04FE0-3AEA-1069-A2D8-08002B30309D}\::{CLSID of item} Used when the junction point you are opening is an item that is under My Computer. Explorer.exe /e,/root,path to junction point Used when the junction point you are opening is a file system folder.
License
We are not responsible for anything that occurs to you, your computer, or anything else, while the duration of LiteStep's use to the maximum extent permitted by law.
If you really want to read that legalese stuff from GNU, go right ahead and read the General Public License.
Support
It is difficult for us to maintain a technical support team, but we will try to answer as many questions as possible and to the best of our abilities. You may E-Mail technical support questions to us at qa@litestep.org. Alternatively, you may try the #LS_Help channel on the EFnet IRC Network; more people maybe able to help you there. Remember that technical support is at a voluntary basis. Therefore, it may take quite some time for a reply to your questions.
General Discussion
If you want to discuss about any LiteStep works you produced, have new ideas for new LiteStep features, or just want to talk about other LiteStep relatedthings aside from technical support questions, there is the #LiteStep channel on the EFnet IRC Network for them.
Known Problems
Sites
Here are a few suggested sites you should visit for the latest in LiteStep information:
Copyright © 1998-1999 LiteStep Development. All Rights Reserved.
Official Sites :
http://www.litestep.com/
http://www.litestep.org/
Floach's Site :
http://floach.pimpin.net/
About the LiteStep Development Team
The original creator of LiteStep.
Thank you for releasing the source which helped made LiteStep evolve so much since.
Co-Project leader and coordinator, documentation writer.
Our coordinator back in project 0.24.0. Thank you very much for your coordination effort and bringing LiteStep to its current status!
Project leader and team coordinator, CVS tree maintainer, core coding.
Popup Development, Core coding, Coordinator.
Thank you for your coding effort during the times we needed you. You just kept going and going!
Misc. Core coding.
LSTime development.
0.24.x Documentation writer, NT consulting, Coordinator.
Misc. Coding.
Shortcut Development.
Core Coding.
Core Coding.
Core Coding.
Core Coding.
Installation Package Coding, core coding and troubleshooting.
Core Coding, developing code submission processes.
Installation Package Coding.
Distribution Coordinator, Documentation Editor.
Misc. Core coding.
Beta testing.
Documentation writer.
FAQ writer on http://www.litestep.net/faq/.
Beta testing.
LSVWM development.
Default 0.24.0 Theme maker, Theme.rc FAQ writer.
Core coding, wharf coding.
Thank you so much for all your very hard work!
0.24.0 Popup development.
Core coding.
Documentation Assistants (for 0.24.0 project): Brandon Williams and Scott Nance.
Title Graphic and official LiteStep Logo by MorpheusX.
Information in this documentation was assumed to be accurate and comprehensive at the time of publication.