Zero Install command-lines begin with 0install
.
On Windows you can also use 0install-win
instead. This will display outputs using windows instead of the console.
Command | Description |
---|---|
select |
Selects a version of the program identified by URI, and compatible versions of all of its dependencies.
Returns an exit status of zero if it selected a set of versions, and a status of 1 if it could not find a consistent set. |
download |
Behaves similarly to '0install select', except that it also downloads the selected versions if they are not already cached.
Returns an exit status of 0 if it selected a suitable set of versions and they are now all downloaded and in the cache; returns a status of 1 otherwise. |
update |
Checks for updates to the program and download them if found.
This is similar to '0install download --refresh', except that it prints information about whether any changes were found. |
run |
Behaves similarly to '0install download', except that it also runs the program after ensuring it is in the cache.
Returns an exit status of 1 if the download step failed. Otherwise, the exit status will be the exit status of the program being run. |
import |
Imports a feed from a local file, as if it had been downloaded from the network. This is useful when testing a feed file, to avoid uploading it to a remote server in order to download it again.
The file must have a trusted digital signature, as when fetching from the network. |
export (Windows only) |
Exports all feeds and implementations required to launch the program specified by a URI to a DIRECTORY. |
search |
Searches for feeds indexed by the mirror server that match specified keywords. Note that the default mirror server indexes all known feeds, regardless of quality; you must decide whether to trust the programs before running them. |
list |
Lists all locally known feed URIs. If a search term is given, only URIs containing that string are shown (case insensitive). |
catalog search (Windows only) |
Searches registered catalogs for applications that match the specified query. If no query is given all applications in the catalogs are listed. |
catalog refresh (Windows only) |
Refreshes (downloads) all registered catalogs. |
catalog add (Windows only) |
Adds an URI to the list of catalogs. |
catalog remove (Windows only) |
Removes an URI from the list of catalogs. |
catalog reset (Windows only) |
Resets the list of catalogs to the default source. |
catalog list (Windows only) |
Lists all registered catalogs. |
config |
View or change configuration settings.
With no arguments, it displays all settings and their current values. With one argument, it displays the current value of the named setting. With two arguments, it sets the setting to the given value or resets it to the default value if the value "default" is given. |
add-feed |
Register an additional source of implementations (versions) of a program. |
remove-feed |
Un-registers a feed, reversing the effect of '0install add-feed'. |
list-feeds |
Lists all extra feeds added to URI using '0install add-feed'. |
digest |
Calculates the manifest digest of a directory or archive. |
store add |
Adds the contents of a directory or archive to the cache. |
store audit |
Checks that all implementations in the cache are undamaged.
Additional arguments specify custom cache locations. |
store copy |
Copies an implementation into the cache. Similar to '0install store add', but the digest is extracted from the directory name.
An additional arguments specifies a custom target cache location. |
store export (Windows only) |
Exports a cached implementation as an archive (ZIP, TAR, etc.). The result can be imported on another machine using '0install store add'. |
store find |
Determines the local path of a cached implementation. |
store list |
Lists all implementation cache directories. |
store list-implementations (Windows only) |
Lists all cached implementations. If a feed URI is specified only implementations for that particular feed are listed. |
store manage |
Displays a graphical user interface for managing implementations in the cache. Shows associations with cached feeds. |
store optimise |
Saves disk space by merging identical files with hardlinks.
Additional arguments specify custom cache locations. |
store purge (Windows only) |
Removes all implementations from the cache. Use this command to clean up the system before removing Zero Install. Deleting cache directories manually may be difficult due to the NTFS ACLs employed to protect implementations against modification.
Additional arguments specify custom cache locations. |
store remove |
Removes an implementation from the cache. |
store verify |
Makes sure an implementation has not been damaged (i.e. it manifest digest has not changed). |
store add-dir (Windows only) |
Adds a directory to the list of custom implementation caches. |
store remove-dir (Windows only) |
Removes a directory from the list of custom implementation caches. |
central (Windows only) |
Opens the central graphical user interface for launching and managing applications. |
add |
Add an application to the application list. |
remove (Windows only) |
Removes an application from the application list and undoes any desktop environment integration. |
remove-all (Windows only) |
Removes all applications from the application list and undoes any desktop environment integration. Use this command to clean up the system before removing Zero Install. |
destroy (Linux only) |
Removes an application. |
show (Linux only) |
Shows the current selections for an application |
whatchanged (Linux only) |
Shows the differences between the current and previous selections for an application. |
man (Linux only) |
Shows the man-page of a given command. |
integrate (Windows only) |
Adds an application to the application list (if missing) and integrate it into the desktop environment. |
alias (Windows only) |
Create an alias for launching an application via 0install without always having to enter the full URI. |
list-apps (Windows only) |
Lists all applications currently in your application list. If a search term is given, only application names containing that string are shown (case insensitive). |
update-all (Windows only) |
Updates all applications in the application list. |
repair-all (Windows only) |
Reapplies all desktop integrations of applications in the application list. |
sync (Windows only) |
Synchronizes the application list with the server. |
import-apps (Windows only) |
Imports a set of applications and desktop integrations from an existing app-list.xml file. |
maintenance deploy (Windows only) |
Deploys Zero Install to the specified TARGET directory or the default directory for programs and integrates it in the system. |
maintenance remove (Windows only) |
Removes the current instance of Zero Install from the system. |
self-update (Windows only) |
Updates Zero Install itself to the most recent version. |
select
Selects a version of the program identified by URI, and compatible versions of all of its dependencies.
Returns an exit status of zero if it selected a set of versions, and a status of 1 if it could not find a consistent set.
Usage: 0install select [OPTIONS] URI
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
--customize (Windows only) |
Show the graphical policy editor. This allows you to customize which version of a program or library to use. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
--with-store |
Add DIR to the list of implementation caches to search.
However, new downloads will not be written to this directory. |
--command |
Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface.
Set to empty ("") to ignore the command during selection. |
--before |
Require a version of the main program earlier than VERSION . i.e., force the use of an old version the program. |
--not-before |
Require a version of the main program not earlier than VERSION . E.g., if you want to run version 2.0 or later, use --not-before=2.0. |
--version |
Require a version of the main program within the given RANGE .
Ranges are separated by pipes (|). Each range is in the form "START..!END". The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version. |
--version-for |
For any library or sub-component with the given URI specifies the version RANGE (as for --version). |
-s --source |
Select source code rather than a binary. This is used internally by '0compile'. |
--os |
Forces the solver to target the operating system OS .
Supported values: *, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown |
--cpu |
Forces the solver to target a specific CPU .
Supported values: *, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src, unknown |
--language |
Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US).
You can use this option multiple times to specify multiple acceptable languages. |
--xml |
Write selected versions to console as machine-readable XML. |
download
Behaves similarly to '0install select', except that it also downloads the selected versions if they are not already cached.
Returns an exit status of 0 if it selected a suitable set of versions and they are now all downloaded and in the cache; returns a status of 1 otherwise.
Usage: 0install download [OPTIONS] URI
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
--customize (Windows only) |
Show the graphical policy editor. This allows you to customize which version of a program or library to use. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
--with-store |
Add DIR to the list of implementation caches to search.
However, new downloads will not be written to this directory. |
--command |
Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface.
Set to empty ("") to ignore the command during selection. |
--before |
Require a version of the main program earlier than VERSION . i.e., force the use of an old version the program. |
--not-before |
Require a version of the main program not earlier than VERSION . E.g., if you want to run version 2.0 or later, use --not-before=2.0. |
--version |
Require a version of the main program within the given RANGE .
Ranges are separated by pipes (|). Each range is in the form "START..!END". The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version. |
--version-for |
For any library or sub-component with the given URI specifies the version RANGE (as for --version). |
-s --source |
Select source code rather than a binary. This is used internally by '0compile'. |
--os |
Forces the solver to target the operating system OS .
Supported values: *, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown |
--cpu |
Forces the solver to target a specific CPU .
Supported values: *, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src, unknown |
--language |
Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US).
You can use this option multiple times to specify multiple acceptable languages. |
--xml |
Write selected versions to console as machine-readable XML. |
--show |
Show where the selected components are stored on the disk. |
update
Checks for updates to the program and download them if found.
This is similar to '0install download --refresh', except that it prints information about whether any changes were found.
Usage: 0install update [OPTIONS] URI
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
--customize (Windows only) |
Show the graphical policy editor. This allows you to customize which version of a program or library to use. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
--with-store |
Add DIR to the list of implementation caches to search.
However, new downloads will not be written to this directory. |
--command |
Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface.
Set to empty ("") to ignore the command during selection. |
--before |
Require a version of the main program earlier than VERSION . i.e., force the use of an old version the program. |
--not-before |
Require a version of the main program not earlier than VERSION . E.g., if you want to run version 2.0 or later, use --not-before=2.0. |
--version |
Require a version of the main program within the given RANGE .
Ranges are separated by pipes (|). Each range is in the form "START..!END". The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version. |
--version-for |
For any library or sub-component with the given URI specifies the version RANGE (as for --version). |
-s --source |
Select source code rather than a binary. This is used internally by '0compile'. |
--os |
Forces the solver to target the operating system OS .
Supported values: *, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown |
--cpu |
Forces the solver to target a specific CPU .
Supported values: *, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src, unknown |
--language |
Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US).
You can use this option multiple times to specify multiple acceptable languages. |
--xml |
Write selected versions to console as machine-readable XML. |
--show |
Show where the selected components are stored on the disk. |
run
Behaves similarly to '0install download', except that it also runs the program after ensuring it is in the cache.
Returns an exit status of 1 if the download step failed. Otherwise, the exit status will be the exit status of the program being run.
Usage: 0install run [OPTIONS] URI [ARGS]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
--customize (Windows only) |
Show the graphical policy editor. This allows you to customize which version of a program or library to use. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
--with-store |
Add DIR to the list of implementation caches to search.
However, new downloads will not be written to this directory. |
--command |
Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface.
Set to empty ("") to ignore the command during selection. |
--before |
Require a version of the main program earlier than VERSION . i.e., force the use of an old version the program. |
--not-before |
Require a version of the main program not earlier than VERSION . E.g., if you want to run version 2.0 or later, use --not-before=2.0. |
--version |
Require a version of the main program within the given RANGE .
Ranges are separated by pipes (|). Each range is in the form "START..!END". The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version. |
--version-for |
For any library or sub-component with the given URI specifies the version RANGE (as for --version). |
-s --source |
Select source code rather than a binary. This is used internally by '0compile'. |
--os |
Forces the solver to target the operating system OS .
Supported values: *, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown |
--cpu |
Forces the solver to target a specific CPU .
Supported values: *, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src, unknown |
--language |
Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US).
You can use this option multiple times to specify multiple acceptable languages. |
--xml |
Write selected versions to console as machine-readable XML. |
--show |
Show where the selected components are stored on the disk. |
-m --main |
Run the specified executable MAIN instead of the default. If it starts with '/' or '\' then the path is relative to the implementation's top-level directory, whereas otherwise it is relative to the directory containing the default main program.
May not contain command-line arguments! Whitespaces do not need to be escaped. |
-w --wrapper |
Instead of executing the chosen program directly, run COMMAND PROGRAM ARGS. This is useful for running debuggers and tracing tools on the program (rather than on Zero Install!).
Note that the wrapper is executed in the environment selected by the program; hence, this mechanism cannot be used for sandboxing. May contain command-line arguments. Whitespaces must be escaped! |
--no-wait (Windows only) |
Immediately returns once the chosen program has been launched instead of waiting for it to finish executing. On Windows the exit code is the process ID of the launched program. |
import
Imports a feed from a local file, as if it had been downloaded from the network. This is useful when testing a feed file, to avoid uploading it to a remote server in order to download it again.
The file must have a trusted digital signature, as when fetching from the network.
Usage: 0install import FEED-FILE [...]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
export
Exports all feeds and implementations required to launch the program specified by a URI to a DIRECTORY.
Usage: 0install export [OPTIONS] URI DIRECTORY
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
--customize (Windows only) |
Show the graphical policy editor. This allows you to customize which version of a program or library to use. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
--with-store |
Add DIR to the list of implementation caches to search.
However, new downloads will not be written to this directory. |
--command |
Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface.
Set to empty ("") to ignore the command during selection. |
--before |
Require a version of the main program earlier than VERSION . i.e., force the use of an old version the program. |
--not-before |
Require a version of the main program not earlier than VERSION . E.g., if you want to run version 2.0 or later, use --not-before=2.0. |
--version |
Require a version of the main program within the given RANGE .
Ranges are separated by pipes (|). Each range is in the form "START..!END". The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version. |
--version-for |
For any library or sub-component with the given URI specifies the version RANGE (as for --version). |
-s --source |
Select source code rather than a binary. This is used internally by '0compile'. |
--os |
Forces the solver to target the operating system OS .
Supported values: *, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown |
--cpu |
Forces the solver to target a specific CPU .
Supported values: *, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src, unknown |
--language |
Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US).
You can use this option multiple times to specify multiple acceptable languages. |
--xml |
Write selected versions to console as machine-readable XML. |
--show |
Show where the selected components are stored on the disk. |
--no-implementations |
Do not include implementation archives in the export. Only export feeds. |
--include-zero-install |
Include Zero Install itself in the export alongside the application. |
--bootstrap |
Choose the type of Bootstrapper to place alongside the export.
Supported values: None, Run, Integrate |
search
Searches for feeds indexed by the mirror server that match specified keywords. Note that the default mirror server indexes all known feeds, regardless of quality; you must decide whether to trust the programs before running them.
Usage: 0install search QUERY
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
list
Lists all locally known feed URIs. If a search term is given, only URIs containing that string are shown (case insensitive).
Usage: 0install list [PATTERN]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
catalog search
Searches registered catalogs for applications that match the specified query. If no query is given all applications in the catalogs are listed.
Usage: 0install catalog search [QUERY]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
catalog refresh
Refreshes (downloads) all registered catalogs.
Usage: 0install catalog refresh
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
catalog add
Adds an URI to the list of catalogs.
Usage: 0install catalog add URI
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
--skip-verify |
Skip downloading the catalog to verify it is valid before adding it to the list. |
catalog remove
Removes an URI from the list of catalogs.
Usage: 0install catalog remove URI
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
catalog reset
Resets the list of catalogs to the default source.
Usage: 0install catalog reset
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
catalog list
Lists all registered catalogs.
Usage: 0install catalog list
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
config
View or change configuration settings.
With no arguments, it displays all settings and their current values. With one argument, it displays the current value of the named setting. With two arguments, it sets the setting to the given value or resets it to the default value if the value "default" is given.
Usage: 0install config [NAME [VALUE|default]]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
--tab |
Switch to a specific tab in the configuration GUI. Possible TAB s are 'updates', 'storage', 'catalog', 'trust', 'sync', 'language', 'language' and 'advanced'.
Has no effect in text-mode. |
add-feed
Register an additional source of implementations (versions) of a program.
Usage: 0install add-feed [OPTIONS] [INTERFACE] FEED
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
remove-feed
Un-registers a feed, reversing the effect of '0install add-feed'.
Usage: 0install remove-feed [OPTIONS] [INTERFACE] FEED
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
list-feeds
Lists all extra feeds added to URI using '0install add-feed'.
Usage: 0install list-feeds [OPTIONS] URI
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
digest
Calculates the manifest digest of a directory or archive.
Usage: 0install digest (DIRECTORY | ARCHIVE [SUBDIR])
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
--manifest |
Display the manifest itself (one line for each file or directory). |
--digest |
Display the manifest's digest (enabled by default if --manifest is not set). |
--algorithm |
The HASH algorithm to use for the digest.
Supported values: sha256new, sha256, sha1new |
store add
Adds the contents of a directory or archive to the cache.
Usage: 0install store add DIGEST (DIRECTORY | (ARCHIVE [EXTRACT [MIME-TYPE [...]]))
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store audit
Checks that all implementations in the cache are undamaged.
Additional arguments specify custom cache locations.
Usage: 0install store audit [CACHE-DIR+]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store copy
Copies an implementation into the cache. Similar to '0install store add', but the digest is extracted from the directory name.
An additional arguments specifies a custom target cache location.
Usage: 0install store copy DIRECTORY [CACHE]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store export
Exports a cached implementation as an archive (ZIP, TAR, etc.). The result can be imported on another machine using '0install store add'.
Usage: 0install store export DIGEST OUTPUT-ARCHIVE [MIME-TYPE]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store find
Determines the local path of a cached implementation.
Usage: 0install store find DIGEST
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store list
Lists all implementation cache directories.
Usage: 0install store list
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store list-implementations
Lists all cached implementations. If a feed URI is specified only implementations for that particular feed are listed.
Usage: 0install store list-implementations [FEED-URI]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store manage
Displays a graphical user interface for managing implementations in the cache. Shows associations with cached feeds.
Usage: 0install store manage
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store optimise
Saves disk space by merging identical files with hardlinks.
Additional arguments specify custom cache locations.
Usage: 0install store optimise [CACHE-DIR+]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store purge
Removes all implementations from the cache. Use this command to clean up the system before removing Zero Install. Deleting cache directories manually may be difficult due to the NTFS ACLs employed to protect implementations against modification.
Additional arguments specify custom cache locations.
Usage: 0install store purge [CACHE-DIR+]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store remove
Removes an implementation from the cache.
Usage: 0install store remove DIGEST+
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store verify
Makes sure an implementation has not been damaged (i.e. if manifest digest has not changed).
Usage: 0install store verify [DIRECTORY] DIGEST
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
store add-dir
Adds a directory to the list of custom implementation caches.
Usage: 0install store add-dir PATH
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
store remove-dir
Removes a directory from the list of custom implementation caches.
Usage: 0install store remove-dir PATH
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
central
Opens the central graphical user interface for launching and managing applications.
Usage: 0install central [OPTIONS]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
add
Add an application to the application list.
Usage Linux: 0install add [OPTIONS] NAME URI
Usage Windows: 0install add [OPTIONS] URI
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
--no-download |
Do not download the application itself yet. Will be automatically downloaded on first use instead. |
remove
Removes an application from the application list and undoes any desktop environment integration.
Usage: 0install remove [OPTIONS] (ALIAS|INTERFACE)
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
remove-all
Removes all applications from the application list and undoes any desktop environment integration. Use this command to clean up the system before removing Zero Install.
Usage: 0install remove-all [OPTIONS]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
integrate
Adds an application to the application list (if missing) and integrate it into the desktop environment.
Usage: 0install integrate [OPTIONS] (ALIAS|INTERFACE)
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
--no-download |
Do not download the application itself yet. Will be automatically downloaded on first use instead. |
--add-standard |
Add the recommended standard access points. |
--add-all |
Add all available access points. |
--add |
Add all access points of a specific CATEGORY .
Supported values: capabilities, menu, desktop, send-to, aliases, auto-start, default-app |
--remove-all |
Remove all access points. |
--remove |
Remove all access points of a specific CATEGORY .
Supported values: capabilities, menu, desktop, send-to, aliases, auto-start, default-app |
alias
Create an alias for launching an application via 0install without always having to enter the full URI.
Usage: 0install alias ALIAS [INTERFACE [COMMAND]]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
--no-download |
Do not download the application itself yet. Will be automatically downloaded on first use instead. |
--resolve |
Print the interface URI for the given alias. |
--remove |
Remove an existing alias. |
list-apps
Lists all applications currently in your application list. If a search term is given, only application names containing that string are shown (case insensitive).
Usage: 0install list-apps [PATTERN]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
update-all
Updates all applications in the application list.
Usage: 0install update-all [OPTIONS]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
-c --clean |
Remove implementations no longer required after the update. |
repair-all
Reapplies all desktop integrations of applications in the application list.
Usage: 0install repair-all [OPTIONS]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
sync
Synchronizes the application list with the server.
Usage: 0install sync [OPTIONS]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
--reset |
Reset the synchronization data. Possible MODE s are 'none' (merge data from client and server normally), 'client' (replace all data on client with data from server) and 'server' (replace all data on server with data from client). |
import-apps
Imports a set of applications and desktop integrations from an existing app-list.xml file.
Usage: 0install import-apps APP-LIST-FILE [OPTIONS]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
--no-download |
Do not download the application itself yet. Will be automatically downloaded on first use instead. |
maintenance deploy
Deploys Zero Install to the specified TARGET
directory or the default directory for programs and integrates it in the system.
Usage: 0install maintenance deploy [TARGET]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
-m --machine |
Apply the configuration machine-wide (for the entire computer) instead of just for the current user. |
-p --portable |
Create a portable installation that can be moved around (e.g., on a thumb drive). |
--restart-central |
Restart the '0install central' GUI after the update. |
maintenance remove
Removes the current instance of Zero Install from the system.
Usage: 0install maintenance remove
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
self-update
Updates Zero Install itself to the most recent version.
Usage: 0install self-update [OPTIONS]
Option | Description |
---|---|
-? -h --help |
Show the built-in help text. |
--background (Windows only) |
Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode. |
--batch (Windows only) |
Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars). |
-v --verbose |
More verbose output. Use twice for even more verbose output. |
--customize (Windows only) |
Show the graphical policy editor. This allows you to customize which version of a program or library to use. |
-o --offline |
Run in off-line mode, overriding the default setting.
In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh). |
-r --refresh |
Fetch fresh copies of all used feeds. |
--with-store |
Add DIR to the list of implementation caches to search.
However, new downloads will not be written to this directory. |
--command |
Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface.
Set to empty ("") to ignore the command during selection. |
--before |
Require a version of the main program earlier than VERSION . i.e., force the use of an old version the program. |
--not-before |
Require a version of the main program not earlier than VERSION . E.g., if you want to run version 2.0 or later, use --not-before=2.0. |
--version |
Require a version of the main program within the given RANGE .
Ranges are separated by pipes (|). Each range is in the form "START..!END". The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version. |
--version-for |
For any library or sub-component with the given URI specifies the version RANGE (as for --version). |
-s --source |
Select source code rather than a binary. This is used internally by '0compile'. |
--os |
Forces the solver to target the operating system OS .
Supported values: *, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown |
--cpu |
Forces the solver to target a specific CPU .
Supported values: *, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src, unknown |
--language |
Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US).
You can use this option multiple times to specify multiple acceptable languages. |
--xml |
Write selected versions to console as machine-readable XML. |
--show |
Show where the selected components are stored on the disk. |
-m --main |
Run the specified executable MAIN instead of the default. If it starts with '/' or '\' then the path is relative to the implementation's top-level directory, whereas otherwise it is relative to the directory containing the default main program.
May not contain command-line arguments! Whitespaces do not need to be escaped. |
-w --wrapper |
Instead of executing the chosen program directly, run COMMAND PROGRAM ARGS. This is useful for running debuggers and tracing tools on the program (rather than on Zero Install!).
Note that the wrapper is executed in the environment selected by the program; hence, this mechanism cannot be used for sandboxing. May contain command-line arguments. Whitespaces must be escaped! |
--no-wait |
Immediately returns once the chosen program has been launched instead of waiting for it to finish executing. On Windows the exit code is the process ID of the launched program. |
--force |
Perform the update even if the currently installed version is the same or newer. |
--restart-central |
Restart the '0install central' GUI after the update. |