Help

    After the download of Piccolo Installer, double click on it to un-zip.
    You can use it as a stack: launch LiveCode, then open "Piccolo Installer”.
    But the best way to use it is as a plug-in: copy it to your "My LiveCode/Plugins" folder (see "File & Memory" on the LiveCode Preferences)

    Once opened, you will be presented with 6 tabs. The main tab is the “New/Load” tab, where you load different installer settings and set the name of your installer and the software name.


    • 0 - New/Load
      • Settings
        • Once you modify the Piccolo Installer stack in any way, you will be able to save your set-up for future recall: choose “New” to create a new installer setting. You will be prompted to supply an unique name for this setting.
        • Remember: each setting is just a collection of parameters and pointer to files and folders location. If you move these folders and files after having saved, Piccolo Installer has no way to know where the moved files are.
        • To load a setting, just press the Setting button. You will be presented a list of your saved settings.
        • To erase a setting, choose it and press Delete
      • Installer name
        • This will be the name of the installer that will be built.
      • Software name
        • This is the name of your software to be installed. It will be used only inside the text shown by the installer.
      • Installer type
        • With this button you decide if you will build an installer for Mac OSX only, Windows only or for both, Mac and Windows.
      • Include Uninstaller
        • If you check this button the Installer you will build will be able to uninstall the installed files.
      • Test install
        • This will allow you to see PiccoloInstaller in action. If connected to internet, Piccolo installer will download and unzip a folder to your desktop, containing a bunch of files, folder and apps. The test button will also create a settings for these items. Just press the GO button on the “Build” tab in order to create the installer
      • Reset all
        • This button will empty all fields of PiccoloInstaller. Before creating a new install setting, is a good norm to clear everything.

    • 1 - Add Files
      • Add files / Add folder
        • With these two button, you choose files and folder that your installer will place on the destination computer. Where these files are going to be placed is decided by the other two buttons: Destination folder and Optional Folder in destination. You can also drag files and folder to the list, in order to add their references.
      • Modify file and folder path
        • Double click on a line in order to change a file or folder path
      • Destination folder
        • You may choose, for each file or folder selected with the "Add file", "Add folder" buttons, four kind of destinations where the installer will place the files: Application folder, Desktop, Preferences folder, Documents folder
        • To change a destination, select the line and modify the destination button
      • Optional folder in Destination
        • Each chosen file or folder, can optionally have a further directory, to be created by the installer: choose "other" to create a new folder to be generated inside the destination.
      • Platform
        • On each line you can click the “Platform” column in order to decide for which platform the file or folder will be installed (MacOSX, Windows or both platform).

    • 2 - Installer Graphic
      • Icons
        • Select here the path to the OSX or Windows icons for your installer
      • Choose Installer Picture
        • A small (130 x 130 px) png graphic to be placed on each window of the installer

    • 3 - Installer options
      • On your left there is a list of the files and folders that you included on the installer. Drag from this list to the various fields on the windows in order to activate the options
      • Languages
        • At the moment, you may choose only 3 languages, to be displayed inside the built installer: click on the first column to check the line and make the language available
        • Drag then a text file from the left list of the windows to the appropriate column in the languages display, in order to add the optional "license" file and "read me" file (you can have different read me files according to the OS of the user).
        • To delete a "read me" file, select it and press "cancel" or "delete" on your keyboard
      • Application to start after installation
        • Drag from the list of included files your main application here, in order to present to the user the choice of starting up your application after install.
      • Alias
        • Drag a file from the list to this field in order to create Desktop alias on Windows or OSX.
      • Start up
        • You can drag here to create alias only on the Windows start menu
      • File extension
        • If your installer will be for Windows, you can put here a document extension (like ".tcl") and drag an application to be launched by the above extension.

    • 4 - Scripts
      • To be run BEFORE
        • If before creating your installer you prepare a LiveCode stack with your needed commands on it (no functions can be called by the installer...), you can drag it here from the left list (load it before on the "1 - Add files" tab"). The chosen "command" of the main stack will be called by the installer before doing any install on the user's computer.
        • You can use this to add more complex actions to your installer or, for example, to delete previous install, to kill running application before install, to check versions of previous install.
        • If you place a global named "gErrorInLCScript" in your stack, if your script will set this global to "True", the installer will abort the installation.
        • You can drag here also an application (from the left list) to be run before the install
      • To be run AFTER
        • Same as above but the command will be called at the end on the install. No "gErrorInLCScript" here, off course
      • To be run BEFORE UNInstalling
        • In case you need to close applications or documents before the user uninstalls his files, you can drag here a stack from the list, with a script that will do your tasks.
    • 5 - Build
        • Press the “GO!” button to start the creation of the installer.
        • You can also chose the default path where to build the installer (for example in the desktop)