Program Ssetup32, (c) by Davor Zorc, Zagreb, Croatia, 2008.
General purpose Win95/ 98/ XP/ Vista installation /uninstall utility. It will
check available space on the chosen drive, create target directories and
copy files to them and the Windows directories, create the Program group
and start the target application. There is a separate version of this program
for Win3.1x systems.
FEATURES
- creates single file distribution package (EXE or ZIP)
- small setup size (cca 160 kB)
- program may be used to install DOS, Win3,1x, Win95/98 or Win XP applications
- Setup, Uninstall and Setup design are all contained in a single SETUP.EXE file
- functions to copy/delete files, create/remove desktop group
- uncompress files compressed with Microsoft compress
- easy configuration/ customization for your project
- insert your own picture logo
- Setup program is secure: install information is scrambled and unreadable.
- create nested directories to any depth and anywhere on the system
- create multiple target sub directories and place files in them
- split to multiple source media
- insert your own (c) copyright in the Setup window (for registered users)
- freeware version is not crippled or limited in any way
- puts main application icon on Windows desktop
- uninstall through Settings/ Control Panel/ Add-Remove Programs
- supports upgrade of new version of target application to the same or different directory
CREATION
OF SETUP DESIGN
Quick customization
1. Copy Setup.exe
to a work directory of your application (for example to directory c:\SET_OUT\WORK).
ALL of your application
files should be in that work directory (regardless if they should be installed
outside the Target directory).
2. Run Setup.exe. Double-click twice
on "Ssetup" logo text in the top left corner of Setup
window. This shows [Edit Design]
button which opens Design form window.
Alternative to steps 1. and 2. is to go to Programs/ Ssetup Dummy
Group and click on "Edit Design" icon. Then browse to the
desired WORK
directory. When Setup.exe opens, click on [Edit
Design] button.
3. Write README.TXT and /or LICENCE.TXT
using menu
Edit/ Ed.Readme/ Licence file. Those files will be readable during installation
clicking the Setup [Readme/Licence] button. Add those files to
Output list.
Click on menu Edit/ Edit logo to edit logo picture SETLOGO.BMP visible
on the main window.
4. press [Auto Make]
button for express design generation. Give name for this application. General
data (SetData) will be automatically filled-up and Output list (which is located bottom-right
on Design form) will be made too. By default all .EXE;. TXT; .HTM; .CHM; .URL; .HLP;
.PDF; .RTF; files will get an Icon in the
group. By default all files will be copied to the Target directory.
Remark: If your application in work directory have files in subdirectories, you have to
set Options/ [Auto Make] with subdir option to include those files in
[Auto Make] (if you plan to make ZIP distribution package it is
also good to activate Options/
Create ZIP with subdir). If there are files with same names in different
subdirectories there might be some name conflicts, so consider renaming
them.
5. To fine tune your design, edit SetData lines which are at top-right on Design
form (see sample below).
When done, click [Save All]
button.
6. You may want to distribute your application in 3 forms:
- Set of files - choose menu Distribution /Create Output Disk1,2.
Distribution directory is c:\SET_OUT\Applicname. Multiple volumes (Disk1,
2, 3,) are created by specifying option Source_Size (see Customization
details).
- ZIP archive - Click on [ > ZIP]
if you wish to produce single
ZIP archive file for distribution of your program. To be able to produce
archive, SSZIP32.EXE (by Info-Zip) is installed on your computer. If you want
to use more powerful program then SSZIP.EXE you may create ZIP archive using PowerArchiver
(www.powerarchiver.com)
or WinZip (www.winzip.com)
or WinRAR (www.win-rar.com) archiver. ZIP file is created in
the distribution directory c:\set_out\Applicname.
- self-extracting EXE file - After making ZIP, click on [Zip >
Exe] button. Alternatively you might use other application to convert
ZIP archive to SFX EXE file (for example
WinRAR).
When user click on distribution EXE file, all files will be extracted to Windows temporary directory,
Setup.exe will be activated, installation will be done and finally, files
from temporary directory will be deleted.
Try your Installation by running distribution package from distribution directory c:\set_out. Try Uninstall by clicking
on Uninstall icon in target group. This testing is best done on
another computer - to be sure that all necessary files have been included
in package.
Customization details
1. Output file list is stored in SETDATA.EZZ
in an UNREADABLE form. It lists files and directories to be installed.
Using Design form, it can be created in 3 ways:
- manually editing line by line and pressing [Add^]
- automatically with menu option [Auto Make] or
- load finished project from *.EZZ file by using menu Project/
Load from.
- import finished project from readable list *.LST file by using menu Edit/
Import design.
Files SETUP.EXE and SETDATA.EZZ must be listed in the
output file list. Do not distribute other Setup files.
Editing of entries is done in Edit line on the bottom middle
of the design form. Clicking on Available file list (on the left)
or Output list (on the right) copies clicked line to edit
line. Also radio-button list above edit line shows what will be done with this
file/ directory entry. You may click radio button to change "do
what character". After editing you may put that line in Output
file list by clicking [Add^] or [Replace^].
You can also add multiple files at once by multi-selecting several files (use
Shift and Ctrl keys) in Available file list and clicking [Add^]. Output
file list is also multi selectable for Deleting lines.
Before each file name line insert a "do what character".
It instructs SETUP what to do with that file/ directory (see below):
- Put + character in front of file name for files which must be
copied and an icon made.
Remark1: you can optionally append description which should
appear under icon (example : +DUMMY.EXE,Dummy Application).
Warning: if you have more than one items with same file name (example
: DUMMY.EXE and DUMMY.TXT) you must add the description, because
without it Windows will make only one icon instead of two. It is also possible
to specify alternative icon name and other details as described in Windows
programming guide for AddItem() function on DDE conversation with Windows
Progman.
Remark2: If description of any file line ends with ^ character, this icon will
appear on Windows Desktop.
- Put - for files which must be copied to target directory
(no icon made)
- Put = for files which must be copied to Windows directory
- Put ~ for files which must be copied to Windows System directory
- Put * for files which must be copied to current
user directory (for example C:\Documents and Settings\USER\My Documents)
- Put . for files which are not copied but may be generated by
application and need to uninstall
- Put > for executable file which must be executed after installation
is finished (must also be under + or -). You may also open non executable file
in the same way (for example text file)
- Put ! for files which must be deleted from old version before installing
new one
- Put \. for a directory which must be created on target directory
- Put \* for a directory which must be created on
user My documents directory
- Put \\ for a directory which must be created on target drive root
2. Apart from Target directory additional
directories may also be created:
- as sub directory of the Target directory (example: tag \.DOC,
see below example Output list). To copy a file to that directory
use notation -DOC\FILE.EXT.
- as sub directory of the current user My documents directory (example: tag
\*LEGAL,
see below example Output list). To copy a file to that directory
use notation *LEGAL\LICENCE.TXT. Keep in mind that other users of
this computer might not be able to access those files!
- as an entry in root of target DRIVE (example: tag \\TEMP\PIPI).
To copy a file to that directory use -\TEMP\PIPI\File.DAT. On your
source disk this File.DAT file must also be in the work directory
(not in specified sub directory). This is also true for any files going
to Windows or System directories.
3. Compressed files support
If file extension is finished with _, it is supposed that it was compressed
with 'compress -r filename' command (Microsoft COMPRESS.EXE
DOS utility). Ssetup will uncompress those files (File.ex_ --> File.exe).
Do not compress Readme.txt so that user can get this information before
installation.
4. Multiple source media support
When making installation on CD-ROMs or diskettes, there is a size limit of each
media. Before doing this option edit SETDATA line: Source_Size=value.
Value is the size of diskette in kByte (if this feature is not needed, set
value to zero). To create source installation files for Diskette1,
Diskette2, click on button [Save All] then
use menu Distribute/ Create Output disk 1,2,3. Files
will be created in c:\set_out directory in subdirectories Disk1,
Disk2,..etc. You can copy those subdirectories to individual disks.
Testing of installation may be done executing Setup.exe in disk1
subdirectory. Keep in mind that Setup would not split a file larger
than diskette size to several chunks (use compression on those files). All files
are put in respective directories (disk1, 2,..) so no sub-directories are
created.
5. Other options set through SETDATA editor:
- ApplicName=Ssetup Dummy - Name of application to install
- Head_Text=Ssetup - Setup design - Text to appear in box on top of
Setup program
- Def_Group=Ssetup Dummy Group - name of the program group (Start/
Programs/)
- Def_Path=<program files>\Ssetup - where to install application. Put <program files> in Def_path to specify dafault programs directory
on any system (usually expands to "c:\Program Files")
- Ver=5.00 - application version
- Producer=Acme - name of producer
- Homepage=http://www.server.com - if you write application URL, the [Web
Homepage] button will show on Readme form which enable browsing to this
URL.
- Ask_Licence=0 -If wish that installation is not possible until user
accept licence text put value 1
- UninstallOldVer=0 - If old version of this application is found on
the computer, Ssetup may ask to uninstall old version, prior to the new
installation.
- Ask_Overwrite=0 -If you want that Setup asks you before overwriting
any existing files put value 1. If you put value 2, then it will only ask if
file to be copied is older then existing file.
- Ask_Dir_Overwrite=0 -If you want that Setup asks you before overwriting
(using) existing directories put value 1
- Run_Program=0 -If you want that application starts running when Setup
finish put value 1
- Check_DiskFree=0 -If you want that Setup checks for free target disk
space put 1
- SpaceNeed=313 - disk space needed on target drive (in kilo Bytes).
This value is calculated automatically when [Save All]
is pressed.
- Form_Color=$00FF8080 - Set form color using menu: Edit/ Set Form
Color
- FullScreen=0 - if set to 1, Setup will have blue desktop
background
- WelcomePanel=0 - shows welcome panel giving options of Default -
typical or Customized install. The purpose of this panel is to hide options from
the user if he wants typical install.
- UseRegRunOnce=0 -Use windows registry RunOnce key for SETUP.EXE
final removal at uninstall or SFX install (if RunOnce is used, final removal
will be done during next system boot). Alternative method is to run BAT file
after SETUP.EXE closes (in this case final removal will be done several seconds
after install/ uninstall). Value means: 0= use BAT file for
install+ uninstall, 1= use Runonce registry for install+ uninstall, 2=
use BAT file for uninstall only, 3= use Runonce for uninstall only,
4= use none.
- Source_Size=0 - used to set size of distribution volumes in kByte
(multiple diskettes or CD's)
- UninstallReport=0 - set to 1 if you wish report after
uninstalling (details about files not deleted).
- AskDeleteShared=0 - Uninstall may ask before deleting files installed
to Windows and System directories (which might be needed for other
applications).
REMARKS AND LIMITATIONS
- SETUP.EXE is copied to the target directory to act as UNINSTALL. It
will delete files specified in SETUP list and remove its Group. After that
it will try to delete the target directory. If there are other files in
that directory it will not delete them or the directory.
- Program does handle multiple source disks (floppies) in a way that
it prompts user to insert next disk when a source file is not found.
- Setup does read /write of Windows registry but only in a list of programs
to be uninstalled.
- You can export finished design specification to a text file (setdata.lst).
It is done using design window menu Edit/ Export design. You can import
saved design using Edit/ Import design. List files are useful for
documenting design because all data is plain text.
- Recommendations for file and directory names: do not use special or language
specific characters. If possible use short names (8+3 characters). Do not use
comma (,) character.
- Setup creates program group for all users of the system (Start/ Programs/)
but makes desktop icons for current user only.
- it is good practice not to put files in Windows or System directories,
unless really necessary.
SAMPLE FILES
- sample SETDATA :
[main]
ApplicName=Ssetup Dummy
Head_Text=Ssetup - Setup design for win95/ 98/ 2000/ XP/ Vista
Def_Group=Ssetup Dummy Group
Def_Path=<program files>\Ssetup
Ver=5.00.0
Producer=Davor Zorc
Homepage=http://www.fsb.hr/~dzorc/ssetup.html
Form_Color=$00FFA6A6
UninstallOldVer=0
Ask_Overwrite=0
Ask_Dir_Overwrite=0
Run_Program=0
Ask_Licence=0
FullScreen=1
WelcomePanel=0
Check_DiskFree=0
SpaceNeed=559
UseRegRunOnce=0
Source_Size=0
UninstallReport=1
AskDeleteShared=0
- sample OUTPUT LIST (or *.LST file to import):
;-----------------------------------------------------------------------------
; SSETUP- comment lines begin with ; in colon 1
; Text on all lines must begin at column 1.
; + = copy & icon, - = copy, = = copy WinDir, * = copy user dir.
; . = no copy, ! = delete, > = run, \ = mkDir,
;
;------------- files for Setup/ Uninstall ------------------------------
+SETUP.EXE ;copy and makes icon for SETUP (for Uninstalling)
-SETDATA.EZZ ;this file is copied and updated in target directory
;
; ------------ list of files to copy/ remove --------------------------
;
!DUMMY.TMP ;delete if exist on target dir. from previous installation
+README.TXT ;copy & make icon
+DUMMY.EXE,Dummy Application^ ;copy & make desktop icon: "Dummy Application"
>DUMMY.EXE ;run this after installation (must also be after +)
-DUMMY.RES ;copy only
~DUMMY.DLL ;copy to windows system dir
=DUMMY.INI ;copy to Windows directory
.DUMMY.TMP ;for uninstall-file generated later (by this application)
-DOC\FILE_ID.DIZ ;put in sub-directory of target directory
;
-\DATA\PIPI\F.DAT ;copy to directory relative to target drive root
*SSETUP_LEGAL\LICENCE.TXT ;copy to this user "My documents" directory
;
;------------- make Directories ----------------------------------------------
;
\.DOC ;create extra sub-directory in Target directory
\\DATA\PIPI ;create absolute directory on Target drive
\*SSETUP_LEGAL ;create directory on this user "My documents" directory
;-----------------------------------------------------------------------------
INSTALLATION (GUIDE FOR END USERS)
- If you have ZIP distribution file (xxxxxxx.zip) unzip it to some temporary
directory.
- On windows 2000, windows XP or Vista you need to have administration privileges
to be able to install applications.
- Please close all open applications before starting this installation.
- Start Setup program. Choose Directory and program Group or just leave
it as it is.
- Click on [Start Installation]. During installation you can abort
it by clicking on [ABORT SETUP] button.
- When setup is finished click on the Application icon.
NOTES:
- If you do not wish to make a new program group, or if you do not want
new icons to be added in an existing group, click checkbox [x] Skip
group.
- If you want that Setup asks you before overwriting files which are
already on the system or before using existing directories, check [x] Ask
overwrite.
- If you want that application starts running when Setup finish, check
[x] Run program.
- You do not need to uninstall any old version before installing a new
one in the SAME directory.
- In Windows95/98/NT/XP program Group is accessible under 'Start', 'Programs'.
UNINSTALL (GUIDE FOR END USERS)
- To uninstall go to Start/
Settings/ Control Panel/ Add-Remove Programs.
- Other method is to go to this application program group Start/ Programs/
myApplic and to click Uninstall.
- While uninstalling, all specified files are removed from the target
drive. (from the target directory, other created directories and Windows
directories.)
- Setup Uninstall will ask before removing files from Windows system
directories because they might be shared.
- If you installed this application icons in one of existing groups (shared with other
applications) answer No when Setup ask to remove that group.
REGISTRATION
This program is unregistered PERSONAL FREEWARE but requires payment to
the author for commercial use. It is the full feature version and free to test for one month.
It is illegal to use this program in your commercial distribution package without
prior registration. To register please send completed form together with
cash (in opaque envelope) or a banker's check payable to:
Dr.sc. Davor Zorc
Bosiljevska 34
10 000 Zagreb
Croatia (Europe)
Comments and suggestions are welcome! I would enjoy receiving picture
postcards from users around the world. Thanks!
PRICE FOR SINGLE COMMERCIAL USE : 20 US$ or equivalent in convertible
currency. This is the price for shareware authors to use it to distribute
one product (program) title.
UPGRADE PRICE FOR SINGLE COMMERCIAL USE: 5 US$ or equivalent in convertible
currency.
PRICE FOR CORPORATE USE : 150 US$ or equivalent in convertible
currency. This is the price to use it to distribute more product types
under one producer name.
Experience shows that personal checks or bankers checks
from USA and European Union banks are accepted. EuroChecks and postal checks
(money orders) are NOT accepted. You will receive the latest version by
e-mail and the instructions on how to make your own copyrighted Setup.
You will also receive free registered upgrades for at least 6 months.
Latest version may be found at Ssetup Homepage:
http://www.fsb.hr/~dzorc/ssetup.html.
See the author at Author's homepage: http://www.fsb.hr/~dzorc
Publication place in the world is: http://www.simtel.net/,
in section:
>Programming - install Installation/ Uninstall Programs
<------------------------ cut order form here --------------------->
___________________________________________________________________
Registration form for : SSetup32
___________________________________________________________________
Name:____________________________ Address: ________________________
City, State: ____________________________ Country: ________________
Zip:__________________ E-mail: ____________________________________
Your Home page:____________________________________________________
Program delivery: e-mail [ ] CD-ROM disk [ ]
Included US$:_____________ cash [ ] check [ ]
Comments, suggestions for future updates, bugs, complaints:
___________________________________________________________________
___________________________________________________________________
___________________________________________________________________
Where did you get this file:
___________________________________________________________________
<------------------------ cut order form here --------------------->
LEGAL
This program, its look and feel and its functionality is Copyright (c) by
Davor Zorc.
This program is tested and believed to be free of bugs. There is however no
guarantee that this program will perform expected duty, and that it will not
harm your machine, data or user in any way.
This program is PERSONAL FREEWARE and requires payment to the author for
commercial use, after 30 days of trial period.
Mentioned hardware and software products are (c) of their own producers.
You may re-distribute complete unmodified package to BBS, Internet, CD-ROM,
providing:
- no money is charged for this program
- you must email the author what version you are going to publish and in
what product (so the author is able to send new version).
ACKNOWLEDGEMENTS
- ZIP.EXE is a product of Info-ZIP (here renamed to SSZIP32.EXE). See licence
by Info-ZIP)
- Self-Extracting EXE module sfx_tuni.stb is based on David Cornish's SFX Maker
ver. 2.5 SR-2b
- Logo image, full credits to Vasili Vorotnikov,
www.vaksa.net
- Many thanks to my friend Peter Rader for his suggestions and beta testing.