Tree [6f07ed] master / Help /

File Date Author Commit
COPYING 2006-12-03 Thomas Leonard Thomas Leonard [e696bf] Created Zero2Bundle.
Changes 2006-12-03 Thomas Leonard Thomas Leonard [e2d16b] Wrote documentation.
README 2006-12-03 Thomas Leonard Thomas Leonard [e2d16b] Wrote documentation.

Read Me

		Create self-contained app bundles from Zero Install
		by Thomas Leonard


Zero2Bundle takes a Zero Install feed and creates a self-contained ROX
application directory containing that program AND any libraries it requires.
This may be useful if you want to use the resulting bundle on a machine with
no Internet connection.

Note: normally, you would use AddApp rather than Zero2Bundle. AddApp creates
small launchers, which will download the application if required and store it
in the cache. AddApp launchers will automatically check for updates, run the
correct binary for different platforms, and share libraries. Zero2Bundle, by
contrast, copies the program and all required libraries into the created


Find the URL for the program you want to run. For example, Edit's URL is:

1. Run Zero2Bundle and copy and paste the URL into the dialog box.
2. Click on Add.
3. If the system doesn't yet know about Edit, a box will pop up showing the
   newly-downloaded information about it and prompting you to choose which
   version you want (see for details about this).
4. Click on Download.
5. A ROX savebox appears showing the application. Drag it into your Apps
   directory (or whereever you want it).

The application can then be run like any other normal ROX application.


It always includes all dependencies in the bundle. You might only want some
of them. However, the extra ones are easily removed:

- Open the application directory (Shift+Click in ROX-Filer).

- Delete the sub-directory corresponding to the dependency you don't want.

- Remote the lines from the main AppRun file which refer to it. For example,
  to remove ROX-Lib from Edit, you'd delete these lines:

	if [ "x$PYTHONPATH" = x ]; then


The icon is just a recoloured and edited version of Geoff Youngs' 0install


This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA  02111-1307  USA

Please report any bugs to the mailing list: