home *** CD-ROM | disk | FTP | other *** search
/ Softwarová Záchrana 3 / Softwarova-zachrana-3.bin / ZipInstaller / zipinst.txt < prev   
Text File  |  2004-07-19  |  17KB  |  468 lines
  1.  
  2.  
  3.  
  4. ZipInstaller v1.21
  5. Copyright (c) 2003 - 2004 Nir Sofer
  6.  
  7.  
  8. Description
  9. ===========
  10.  
  11. The ZipInstaller utility installs and uninstalls applications and
  12. utilities that do not provide an internal installation program. It
  13. automatically extracts all files from the Zip file, copies them to the
  14. destination folder you select, creates shortcuts in the start menu and in
  15. your desktop, and adds an uninstall module to allow you to automatically
  16. remove the software in the future.
  17.  
  18. This utility was originally developed to install the utilities in NirSoft
  19. Web site, but you can use it for installing utilities and applications
  20. from other sources, like the utilities provided in SysInternal Web site,
  21. Funduc Software, and many others.
  22. Generally, this utility can install properly almost any software
  23. compressed in Zip files that doesn't provide an install/uninstall module.
  24.  
  25.  
  26.  
  27. Versions History
  28. ================
  29.  
  30.  
  31.  
  32.  
  33. 20/07/04
  34. 1.21
  35.  
  36. * Ability to create self-install executables. (/selfexe command-line
  37.   parameter)
  38. * The 'Start In' field in all shortcuts created by ZipInstaller is now
  39.   filled with the appropriate folder.
  40. * Uninstall improvement: if a file is locked and cannot be deleted,
  41.   ZipInstaller will try to move it into the temp folder, instead of
  42.   displaying error message. (This trick works only on Windows 2000/XP)
  43. * Fixed bug: In previous version, the configuration file inside the zip
  44.   file was copied to the installation folder with all other files,
  45.   although it's not really needed.
  46. * New option: copy the uninstaller module to the installation folder,
  47.   instead of Windows folder (UninstallInDestFolder value)
  48.  
  49.  
  50. 07/06/04
  51. 1.20
  52.  
  53. * Ability to translate to other languages.
  54. * New option: Add uninstall shortcut under the programs folder. (If
  55.   this option is unchecked, uninstall shortcut won't be added)
  56. * New option: Remember the above settings for future installations. If
  57.   this options is checked, the current install settings will be saved in
  58.   the Registry, and they'll be loaded as default in future installations.
  59. * ZipInstaller Configuration File (.zic file) - Allows you to control
  60.   the installation settings, like changing the default installation
  61.   folder, the 'Install For' setting (For current user or for all users),
  62.   the product info (product name, compant, and so on), and more...
  63. * With ZipInstaller Configuration File, you are allowed to install a
  64.   software without any user interaction.
  65. * Extra information about the installed software is now added under the
  66.   uninstall Registry key: company name, product version, install folder,
  67.   and description.
  68.  
  69.  
  70. 27/06/03
  71. 1.11
  72. Fixed bug with the ZipInstaller context menu: In version 1.10, there was
  73. an error if the Zip filename contained one or more space characters.
  74.  
  75. 22/06/03
  76. 1.10
  77.  
  78. * Added support for more special files - readme.html, readme.htm,
  79.   readme.doc, manual.txt, manual.html, and so on...
  80. * New option: Allows you to add ZipInstaller to the context menu of Zip
  81.   files, so you can easily start the installation process directly from
  82.   Explorer window.
  83. * Starting from this version: If ZipInstaller is failed to delete a
  84.   file during uninstall, it allows you to try again, skip the problematic
  85.   file, or cancel the uninstall.
  86. * If there is only one EXE file inside the Zip file, and it doesn't
  87.   contain any software information, the EXE is probably an internal
  88.   installation software, so ZipInstaller asks you whether you want to run
  89.   it.
  90.  
  91.  
  92. 08/05/03
  93. 1.00
  94. First Release
  95.  
  96.  
  97.  
  98. License
  99. =======
  100.  
  101. This utility is released as freeware for personal and non-commercial use
  102. only. You are allowed to freely distribute this utility via floppy disk,
  103. CD-ROM, Internet, or in any other way, as long as you don't charge
  104. anything for this.
  105.  
  106.  
  107.  
  108. Disclaimer
  109. ==========
  110.  
  111. The software is provided "AS IS" without any warranty, either expressed
  112. or implied, including, but not limited to, the implied warranties of
  113. merchantability and fitness for a particular purpose. The author will not
  114. be liable for any special, incidental, consequential or indirect damages
  115. due to loss of data or any other reason.
  116.  
  117.  
  118.  
  119. Using ZipInstaller
  120. ==================
  121.  
  122. This utility is a small standalone executable. You don't have to install
  123. it, and it doesn't require any additional DLLs. Simply run the executable
  124. (zipinst.exe) and start using it.
  125. In the first dialog you get immediately after you run this utility, you
  126. have to select the Zip filename that contains the software you want to
  127. install. After you select the desired Zip file and press the continue
  128. button, ZipInstaller analyzes the Zip file:
  129. * If it finds an internal installer inside the Zip file (setup.exe or
  130.   install.exe) it'll ask you if you want to run the installer software.
  131. * For each executable (.EXE file) in the Zip file, ZipInstaller
  132.   inspects the version resource information (company name, product name)
  133.   in order to use it during the installation process.
  134.  
  135. After the analysis process is finished, the next dialog-box is appeared.
  136. The product information (company, product name, version) is displayed on
  137. the screen if it's found inside the Zip file during the analysis process.
  138. Before you start to install, you can change the following installation
  139. options:
  140. * Destination Folder: ZipInstaller will copy all program files to this
  141.   folder. You can select one of the default folders from the combo-box,
  142.   or select any other folder by clicking the 'Browse' button.
  143. * Install for: This option is available only under Windows NT, Windows
  144.   2000 and Windows XP. If you choose to install for the current logged on
  145.   user (the default option), the shortcuts to the installed software will
  146.   be added only to the desktop and the start menu of the current logged
  147.   on user. If you choose to install for all users, the shortcuts will be
  148.   added to the desktop and start menu of all users.
  149. * Add shortcuts to the programs folder: If this options is checked, a
  150.   folders containing essential shortcuts will be added to the programs
  151.   folder under the start menu. You can select one of the default folder
  152.   names or type any other folder name you want.
  153.   In this programs folder, ZipInstaller automatically adds shortcuts to
  154.   the following files:
  155.   o Executable files (*.exe)
  156.   o Help file (*.chm, *.hlp)
  157.   o readme file (readme.txt, readme.htm, readme.html or readme.doc)
  158.   o manual file (manual.txt, manual.htm, manual.html or manual.doc)
  159.   o Uninstall program (If the uninstall option is selected)
  160.  
  161. * Add a shortcut to the program on the desktop: If this option is
  162.   checked, a shortcut to the executable file of the installed software is
  163.   added to the your desktop folder. If the Zip file contains more than
  164.   one executable file, a shortcut to the program folders will be added to
  165.   the desktop.
  166. * Add uninstall module: If this option is checked, the uninstall module
  167.   will be added with the installed software, and you'll be able to
  168.   automatically uninstall it in the future.
  169. * Add uninstall shortcut under the programs folder: If this option is
  170.   checked, a shortcut that runs the uninstall module will be added to the
  171.   programs folder. Otherwise, the uninstall shortcut won't be added.
  172. * Remember the above settings for future installations: If this option
  173.   is checked, the current installation settings will be saved in the
  174.   Registry, and they will be used as default settings in the next time
  175.   that you use ZipInstaller.
  176.  
  177.  
  178. After you click the "Install" button, ZipInstaller copies all files from
  179. the zip file into the destination folder, and creates shortcuts in the
  180. desktop and/or in the start menu according to your selection.
  181. After the installation process is finished, you'll see a new programs
  182. folder with shortcuts to the installed software, like the following
  183. example:
  184.  
  185.  
  186.  
  187. The uninstall module
  188. ====================
  189.  
  190. If you select the add the uninstall module during installation, the
  191. executable file of ZipInstaller (zipinst.exe) is copied to your Windows
  192. directory. In addition, a file named "uninst1~.nsu" is created in the
  193. destination folder. Do not delete or modify this file. It contains
  194. essential information for removing the installed application in the
  195. future.
  196.  
  197. Whenever you want to remove the software you have installed with
  198. ZipInstaller, you can simply start the uninstall process by choosing the
  199. uninstall option from the shortcut created in programs folder. You can
  200. also remove the installed software directly from the "Add/Remove
  201. programs" module in the Control Panel.
  202.  
  203.  
  204.  
  205. ZipInstaller Configuration File (*.zic)
  206. =======================================
  207.  
  208. Starting from v1.20, ZipInstaller allows you to easily change the default
  209. installation settings by using a simple configuration file. with
  210. ZipInstaller configuration file, you can set the default installation
  211. folder, the default programs folder for creating the shortcuts, the
  212. product information (product name, product version , and so on...), and
  213. more.
  214.  
  215. There are 3 different methods to use the configuration file.
  216. 1. Load it from command-line by using /cfg parameter. For Example:
  217.    zipinst.exe /cfg c:\temp\myconfig.zic
  218.  
  219. 2. Put the configuration file inside the Zip file that contains the
  220.    program you want to install. You must add the configuration file as
  221.    "~zipinst~.zic", so ZipInstaller will recognize it and use it for
  222.    configuring the installation.
  223. 3. Some of the ZipInstaller settings (but not all of them !) are also
  224.    loaded from the Registry, under
  225.    HKEY_CURRENT_USER\Software\NirSoft\ZipInstaller as the default
  226.    settings for all installations.
  227.  
  228. The zic file is simply a standard INI file, and all its values are stored
  229. under [install] section.
  230. For example:
  231.  
  232.  
  233.  
  234. [install]
  235. ZipFile=f:\temp\strun.zip
  236. AddUninstall=1
  237. AddUninstallShortcut=1
  238. DesktopShortcut=1
  239. InstallTo=2
  240. StartMenuShortcut=1
  241. ProgramFilesFolder=D:\Program Files
  242. NoUserInteraction=1
  243. InstallFolder=%zi.ProgramFiles%\%zi.ProductName%
  244. StartMenuFolder=%zi.CompanyName%\%zi.ProductName%
  245. ProductName=StartupRun
  246. ProductVersion=1.20
  247. CompanyName=NirSoft
  248. Description=StartupRun
  249. UninstallRegKey=StartupRun1
  250. NoExtraUninstallInfo=0
  251. NoSuccessMessage=1
  252.  
  253.  
  254.  
  255. The following table describes all settings that you can use in
  256. ZipInstaller config files. Some of these settings are also loaded from
  257. the Registry (Under HKEY_CURRENT_USER\Software\NirSoft\ZipInstaller) as
  258. the default settings of ZipInstaller.
  259. For example: If you want that ZipInstaller will use your customized
  260. "Program Files" folder instead of using the standard "Program Files"
  261. folder of Windows, add a new string value named "ProgramFilesFolder"
  262. under the above Registry key.
  263.  
  264.  
  265.  
  266.  
  267. ZipFile
  268.  
  269. Specifies the Zip file to load. if this value is not specified,
  270. ZipInstall will ask to select a Zip file. This value should not be used
  271. if the config file is stored inside the Zip file itself.
  272.  
  273. InstallTo
  274.  
  275. Set this value to 1 in order to install for all users, or 2 in order to
  276. install only for the current logged-on user.
  277.  
  278. DesktopShortcut
  279.  
  280. If you set this value to 1, ZipInstaller will add shortcuts to the
  281. desktop.
  282. If you set this value to 0, shortcuts won't be added to the desktop.
  283.  
  284. StartMenuShortcut
  285.  
  286. If you set this value to 1, ZipInstaller will add shortcuts under Start
  287. Menu-Programs folder.
  288. If you set this value to 0, the shortcuts won't be added.
  289.  
  290. AddUninstall
  291.  
  292. If you set this value to 1, ZipInstaller will add an uninstall entry to
  293. the Add/Remove module.
  294. If you set this value to 0, the uninstall entry won't be added (the
  295. default value is 1)
  296.  
  297. AddUninstallShortcut
  298.  
  299. Specifies whether ZipInstall should add a shortcut to the uninstall
  300. module under the Start Menu-programs folder. The default value is 1.
  301.  
  302. ProgramFilesFolder
  303.  
  304. Specifies the "Program Files" folder that ZipInstaller should use. If
  305. this value is not specified, the default "Program Files" folder of
  306. Windows is used.
  307.  
  308. InstallFolder
  309.  
  310. Specifies the default folder to install the software. You can put in this
  311. string all Windows environment variables, as well as special variables
  312. provided by ZipInstaller.
  313. For Example:
  314.  
  315. %zi.ProgramFiles%\%zi.CompanyName%\%zi.ProductName%
  316. D:\My Software\%zi.ProductName%
  317.  
  318. StartMenuFolder
  319.  
  320. Specifies the default programs group created under the Start
  321. Menu-Programs folder. You can put in this string all Windows environment
  322. variables, as well as special variables provided by ZipInstaller.
  323. For Example:
  324.  
  325. %zi.CompanyName%\%zi.ProductName%
  326. My Software\%zi.ProductName%
  327.  
  328. NoExtraUninstallInfo
  329.  
  330. By default, extra information about the installed software is added the
  331. the uninstall Registry key. If from some reason you don't want that the
  332. extra information will be added, set this value to 1.
  333.  
  334. NoSuccessMessage
  335.  
  336. By default, ZipInstaller displays success message when the installation
  337. is completed. You can avoid this message by setting this value to 1.
  338.  
  339. NoUserInteraction
  340.  
  341. If you set this value to 1, ZipInstaller will start the installation
  342. process immediately, without asking the user to confirm the desired
  343. installation options.
  344.  
  345.  
  346. UninstallRegKey
  347.  
  348. By default, ZipInstaller uses the product name as the uninstall key under
  349. HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall.
  350. If you want to use another key, put it in this value.
  351.  
  352. ProductName
  353. ProductVersion
  354. CompanyName
  355. Description
  356.  
  357. Use these values if you want to modify the product information extracted
  358. from the executables in the Zip file by ZipInstaller. ZipInstaller
  359. displays the product information on the installation options window, as
  360. well as it uses it to suggest the default install folders and program
  361. groups.
  362.  
  363. UninstallInDestFolder
  364.  
  365. By default, the ZipInstaller executable (zipinst.exe) is copied to the
  366. Windows directory, for using it during the uninstall process. If from
  367. some reason you want that the ZipInstaller executable will be copied into
  368. the program installation folder (instead of Windows folder), set this
  369. value to 1.
  370.  
  371. The following special environment variables are provided by ZipInstaller.
  372. You can use these variables to customize the default installation folder
  373. ("InstallFolder" value) and the default programs group under start menu
  374. ("StartMenuFolder" value).
  375.  
  376.  
  377. %zi.ProgramFiles%
  378. The default Program Files folder of ZipInstaller.
  379.  
  380. %zi.CompanyName%
  381. The company name.
  382.  
  383. %zi.ProductName%
  384. The product name.
  385.  
  386. %zi.ProductVersion%
  387. The product version.
  388.  
  389. %zi.ZipName%
  390. The name of the zip file excluding the .zip extension.
  391.  
  392.  
  393.  
  394. Command-Line Options
  395. ====================
  396.  
  397.  
  398.  
  399. /selfexe
  400. /selfexe <Zip Filename> <Executable Filename> <Translation File
  401. (Optional)>
  402.  
  403. Creates a self-install executable from a ZIP file. The translation file
  404. parameter is optional. If you specify it, ZipInstaller will use it during
  405. the installation process.
  406.  
  407. Examples:
  408. zipinst.exe /selfexe c:\temp\volumouse.zip c:\temp\volumouse-setup.exe
  409. zipinst.exe /selfexe c:\temp\wul.zip c:\temp\wul-setup.exe
  410. c:\temp\zipinst_lng.ini
  411.  
  412. /i
  413. /i <Zip Filename>
  414.  
  415. Start the ZipInstaller utility with specific Zip file.
  416.  
  417. /cfg
  418. /cfg <ZipInstaller Configuration File>
  419.  
  420. Starts ZipInstaller with the specified configuration file.
  421.  
  422. /uninst
  423. /uninst <uninstall filename (uninst1~.nsu) >
  424.  
  425. Uninstall software according to the information inside the uninstall
  426. filename. This options is internally used by ZipInstaller. You don't have
  427. to directly use this command-line option.
  428.  
  429. Notice: Under Windows NT, Windows 2000 and Windows XP, you can use the
  430. ZipInstaller utility only if you are logged on with administrator
  431. privileges. Otherwise, the install/uninstall process will be failed.
  432.  
  433.  
  434.  
  435. Translating ZipInstaller to other languages
  436. ===========================================
  437.  
  438. ZipInstaller allows you to easily translate all dialog-boxes and strings
  439. to other language.
  440. In order to do that, follow the instructions below:
  441. 1. Run ZipInstaller with /savelangfile parameter:
  442.    zipinst.exe /savelangfile
  443.    A file named zipinst_lng.ini will be created in the folder of
  444.    ZipInstaller utility.
  445. 2. Open the created language file in Notepad or in any other text
  446.    editor.
  447. 3. Translate all menus, dialog-boxes, and string entries to the
  448.    desired language.
  449. 4. After you finish the translation, Run ZipInstaller, and all
  450.    translated strings will be loaded from the language file.
  451.    If you want to run ZipInstaller without the translation, simply rename
  452.    the language file, or move it to another folder.
  453. Notice: When you install a software with ZipInstaller, the translation
  454. file (zipinst_lng.ini) is copied to the Windows directory together with
  455. the ZipInstaller executable (zipinst.exe), so when you uninstall the
  456. software, ZipInstaller will also load the translation file for using
  457. during the uninstall process.
  458.  
  459.  
  460.  
  461. Feedback
  462. ========
  463.  
  464. If you have any problem, suggestion, comment, or you found a bug in my
  465. utility, you can send a message to nirsofer@yahoo.com
  466.  
  467.  
  468.