====== Install Applications ======

==== Select Mirror ====

To have a list of mirrors to choose from, install mirrors.tcz.

To select a mirror, open the App Browser, and click Mirrors, then select a mirror.

For other options see [[mirror|Select Mirror]]

==== Install Applications ====

To install applications while connected to the internet, open the App Browser.

Click Connect.

You will then see a list of extensions, and information about them.

Click on a application you want to install. Then click Go. The application and its dependencies will be downloaded and installed.

When completed, there will be a message saying OK.

==== OnBoot, OnDemand, Download and Load or Download Only ====

When installing applications you may select OnBoot, OnDemand, Download and Load or Download Only.

**OnBoot:** If OnBoot is used, the application is loaded every time the computer is started. Applications you always use, should be in OnBoot.

**On Demand:** If OnDemand is used, applications are not loaded until you start them. When using OnDemand, the computer starts quicker, and uses less RAM. This is ideal for applications you only use sometimes, particularly for computers with small RAM.

**Download and Load:** If Download and Load is used, the application is downloaded and loaded this time only. The next time you start the computer, it will not be loaded. It will still be in the tce directory, but the computer will not do anything with it.

**Download Only:** If Download Only is used, the application is only downloaded. It will be in the tce directory, but the computer will not do anything with it.

The applications in OnBoot and OnDemand can be changed using Apps Audit.

Do not put dependencies in OnBoot or OnDemand. They will be automatically included.

==== Search ====

You can enter a search term, and search for a certain type of application.

You can also change search to provides, and find out which extension provides something.

====  Install Local ====

You can load applications using Install Local. To do this, open the App Browser, click Local, select an application, and click OK.

==== Install Applications While Not Connected to the Internet ====

Extensions may be downloaded from one of the [[mirrors]].

==== Download Extensions, .dep files and Dependencies ====

To install applications on a computer which is not connected to the internet, download the extensions.

Include .dep files, dependencies, and dependencies of dependencies.

If the computer will be connected to the internet in the future, include .md5.txt files, as these are used to determine which programs have been updated. They can also be used to check if any extensions have been corrupted.

==== Put in the /tce/optional Directory ====

Copy and paste all extensions to the /tce/optional directory.

Using Apps Audit, put applications in OnBoot or OnDemand.

Restart the computer.

==== Copy Applications to Other Computers ====
If you install Tinycore on another computer, you don't need to download the extensions again. You can just copy them. Extensions are in the /tce/optional directory.

Using Apps Audit, put applications in OnBoot or OnDemand.

==== Using Commands ====

The following information is included for people using Microcore without a graphical interface, and other advanced users.

==== Install Applications ====

To install an application, and put it in On Boot, use

<code>tce-load -wi app_name.tcz</code>

To install an application, and put it in On Demand, use

<code>tce-load -wo app_name.tcz</code>

To download an application to the /tce/optional directory, but not put it in On Boot or On Demand, use

<code>tce-load -w app_name.tcz</code>

To download an application to the /tce/optional directory, and load it this time, but not put it in On Boot or On Demand, use

<code>tce-load -wil app_name.tcz</code>

If you are running a command line only interface (CLI), then after you load an application using ondemand, then you should refresh your bash path cache with:

<code>hash -r</code>
==== App Browser ====

To search for applications, use

<code>ab search_term</code>

or

<code>ab</code>

and you will be prompted to enter a search term.

Select an application to install.

Press q.

You will then have a number of options.

To install it, and put it in On Boot, press i.

To install it, and put it in On Demand, press o.

==== Start an Application ====

To start an application that is not loaded, use

<code>tce-run app_name</code>

==== Load an Application ====

To load an application, use

<code>tce-load -i app_name</code>

or

<code>tce-load -is app_name</code>

You can then start the application from the menu or wbar.

==== tce Directory ====
If you are running a version of Core earlier than 4.2 then you can find the tce directory by opening the terminal and typing 
<code>cat /opt/.tce_dir</code>

If you are running Core 4.2 or later, then you can find the tce directory by opening the terminal and typing
<code>readlink /etc/sysconfig/tcedir</code>

==== A note on dependencies and Apps Audit ====

When an extension is placed in the OnBoot or OnDemand list using Apps Audit the extension and all it's dependencies are removed from the list of extensions available to be added (the left hand window in Apps Audit). This can result in some extensions apparently disappearing. An example is alsa and alsamixergui:

If a user wishes the alsa sound system to be loaded at boot time the alsa extension is placed in OnBoot, and as alsa-modules is a dependency it will also be removed from the list of extensions available for selection in the left-hand window. The user may occasionally require use of alsamixergui and so places that in OnDemand.

If later alsa is removed from OnBoot, either accidentally or because the user wishes to prevent alsa loading at boot time it does not reappear in the list of extensions available for selection. As a consequence it cannot be added back to OnBoot using Apps Audit. The reason for this is that alsamixergui is in the OnDemand list and has alsa (& consequently alsa-modules) as a dependency so alsa (& alsa-modules) do not appear in the list of extensions available to be added to OnBoot or OnDemand. To be able to restore alsa to OnBoot either the file OnBoot.lst in the tce directory must be edited manually or alsamixergui must be removed from OnDemand, then alsa will be added back to the list of available extensions and can be selected for OnBoot. If the latter method is used alsamixergui will need to be replaced in OnDemand after alsa has been added to OnBoot.

This is only one example, but illustrates a possible cause if an extension is not listed as available by Apps Audit, but has been downloaded to local storage.