Using the Dotpup Wizard

Using the working compiled program "myprogram" as an example, make the filesystem as shown on the left of figure 1:

• Create folder         /root/myprogram/FILESYSTEM
• Copy       /usr/local/bin/myprogram      to    /root/myprogram/FILESYSTEM/usr/local/bin/myprogram
• Same with all other files that myprogram needs  
• Optional: Create a /root/myprogram/resources folder, if needed, see "hidden features" below
  
• Create icon:         /root/myprogram/my-icon.xpm
  (or locate one you like in /usr/local/lob/x11/mini-icons)
• Create startscript        /root/myprogram/run-myprogram       for example:  

                Use this code, if "myprogram" is in /usr/bin or /usr/local/bin

Code:

#!/bin/sh myprogram

            This opens an orange terminal and runs myprogram

Code:

#!/bin/sh rxvt -bg orange --geometry 60x20 -title "myprogram" -e myprogram

             Use this code, if "myprogram" is not in one of the Folders, that are in $PATH (such as /usr/local/bin)

Code:

#!/bin/sh cd /usr/local/myprogram/ ./myprogram

 

• Make it executable:         chmod 755 /root/myprogram/run-myprogram
• Optional:(advanced):create /root/myprogram/resource   and add scripts that will be run as the pup installs, see diagram below, and NOTES.
  
• Finally, drag         /root/myprogram         to the Dotpup-wizard.
• More notes: The first letter of Alien packages or dotpups must be UPPER case to avoid problems with pupget.  Not:  openssh.pup  But: Openssh.pup 

FIGURE 1
 
Running the wizard:

• Drop the above folder on the Dotpup wizard
• Choose "standard" (target directory: usr/local/myprogram) or "relocatable" (to install the program to another location) 
• Unless myprogram is big, like OpenOffice, use "standard." Relocatable will let you choose another target directory.  
• Choose the icon
• Choose any hidden config files needed
• Choose the application, that will be visible in the menus: (pick the run-script you made, not the binary inside /FILESYSTEM)   
• The next steps automatically create a .desktop file   (an XDG-menu-definition):
• First, choose a category according to the Freedesktop-standard
• If you like, you now can edit the XDG-menu, or just exit the window
• Your Dotpup is ready for (testing) upload.

NOTES:
You can add 3 scripts that will run during Dotpup-installation:
- prepreinstall.sh
This is run before anything else.
As the Dotpup is not extracted yet, you cannot access embedded pictures.
- preinstall.sh
Runs after the folder selection for relocatable Dotpups.
Same restrictions as above.
- postinstall.sh
runs after the Dotpup was installed from the final location.
---------------------------------
The first letter of Alien packages (one that replaces applications on the original Puppy CD)
must be UPPER case to avoid problems with pupget.  Not:  openssh.pup  But: Openssh.pup
--------------------------------- 
Menu-entries:
/usr/local/myprogram/run-myprogram will appear in the dotpups-menu.
Since Puppy 2.14, this is depreciated, but the wizard also allows you to create a ".desktop" file.
Puppy since 2.14 will use this to add a menu-entry in the correct category.
----------------------------------
When this Pup is installed:
myprogram.tgz is extracted to /usr/local (so you have the file /usr/local/myprogram/myprogram).
FILESYSTEM.tgz is extracted to /
Overwrite: If the files in FILESYSTEM.tgz already exist, and a message will pop up.  
Desktop-Menus are updated, and a symbolic Link will be added to /usr/local/bin, so that your program seems to be in the PATH, this way you can start it in rxvt without typing the full patname.
All files and symlinks will be registered to PupGet.
---------------------------------
A dotpup can be created by hand easily as well, see here: http://puppylinux.org/wikka/dpup
For Puppy 2.14 and up users: http://www.puppyos.com/development/createpet.htm
---------------------------------
 
Download:
http://puppyfiles.org/dotpupsde/dotpups/System_Utilities/Dotpup-Wizard-mu06.pup (25 kb)

---

CategoryHowto