'''Extras''' is the primary repository for Maemo applications where most community software can be found. There are many excellent software projects distributed through Extras including [http://openbossa.indt.org.br/ Canola], [https://garage.maemo.org/projects/maemo-mapper Maemo Mapper], [https://garage.maemo.org/projects/omweather/ OMWeather], and others.

+

'''Extras''' is the primary [[repository]] for [[Maemo]] [[Software|applications]] where most community software can be found. You can browse the applications available in Extras at [http://maemo.org/downloads Maemo Downloads].

+

== Using Extras ==

== Using Extras ==

-

<h3>To enable Extras repository, just open [https://garage.maemo.org/extras-assistant/install/extras.install this link] on your tablet.</h3>

+

The Extras repository is pre-configured on the [[Nokia N900|N900]] and listed as '''maemo.org''' and is [[Maemo_5/PR1.1#Application_Manager|enabled by default in PR1.1]].

+

=== To enable Extras repository for pre-PR1.1, just open [https://garage.maemo.org/extras-assistant/install/extras.install this link] on your tablet. ===

Or you can enable it by hand:

Or you can enable it by hand:

-

* Go into the Application manager.

+

-

* Tap the menu -> Tools -> Application catalog...

+

Go into the Application manager.

-

* Double-tap maemo Extras.

+

Tap the menu -> Tools -> Application catalog...

-

* Uncheck Disabled.

+

Double-tap maemo Extras.

+

Uncheck Disabled.

+

+

If you don't have maemo Extras among your catalogs, you can manually add it. The configuration below is for N900 up to firmware PR 1.1.1:

+

+

Application manager --> Application catalogs --> New

+

Catalog name: maemo.org

+

Web address: http://repository.maemo.org/extras/

+

Distribution: fremantle

+

Components: free non-free

+

+

The configuration below is for N900 for firmware [[Maemo 5/PR1.2|PR 1.2]]:

+

+

Application manager --> Application catalogs --> New

+

Catalog name: maemo.org

+

Web address: http://repository.maemo.org/extras/

+

Distribution: fremantle-1.2

+

Components: free non-free

+

+

The configuration below is for N900 for firmware [[Maemo 5/PR1.3|PR 1.3]]:

+

+

Application manager --> Application catalogs --> New

+

Catalog name: maemo.org

+

Web address: http://repository.maemo.org/extras/

+

Distribution: fremantle-1.3

+

Components: free non-free

+

+

=== Diablo ===

+

+

# Open <code>/etc/apt/sources.list</code> with a text editor

+

# Append the following line to that file:<br/><pre>deb http://repository.maemo.org/extras/ diablo free non-free</pre>

+

# Update your APT cache with:<br/><pre>apt-get update</pre>

== About Extras ==

== About Extras ==

Extras is split into two areas:

Extras is split into two areas:

-

* '''free''' applications are Open Source have been through the Maemo [[Extras repository process definition| Extras vetting process]]

+

* '''free''' applications are open source have been through the Maemo [[Extras repository process definition| Extras vetting process]]

* '''non-free''' applications are usually closed, binary only and their quality and security must be taken on trust

* '''non-free''' applications are usually closed, binary only and their quality and security must be taken on trust

Anyone interested in contributing to Extras should look at the [[Extras repository process definition]].

Anyone interested in contributing to Extras should look at the [[Extras repository process definition]].

-

== Extras-devel ==

+

Developers should also consult [[Packaging#Packaging_policy|the extras policy]] for information on handling interactions with other distributions.

-

Extras has a development repository called "Extras-devel", where not-yet-ready-for-prime-time package testing goes on and where new alpha and beta versions of software are frequently made available before they're pushed to Extras proper. This repository is ''not'' recommended for regular usage unless you are interested in testing software that may potentially break your system, or need a specific package out of this repository. You can add Extra-devel to your repository list by opening this [https://garage.maemo.org/extras-assistant/install/extras-devel.install .install] on your tablet.

+

-

== For developers ==

+

== Extras-testing ==

-

=== Uploading to Extras ===

+

'''The software hosted in extras-testing might not be ready for end users!''' Please don't play with it unless you really know what you are doing. See [http://talk.maemo.org/showpost.php?p=431432&postcount=5 this post] for a more user-specific discussion of the risks. There is also some tips at [[Installing unstable applications]] -article.

-

{{main|Uploading to Extras}}

+

-

Anyone with a [http://garage.maemo.org/ Garage] account can upload packages to Extras, and so make them available to the widest possible user base. It is important to note that the ''uploader'' needs a Garage account: the package itself does not need to be hosted in the Garage.

+

-

=== Policy ===

+

Extras-testing is a repository that holds applications waiting to be tested (that is, those that the maintainer believes are ready for public release). It is a place where power users can download the latest developer releases, test them out and evaluate them. User backups and predisposition to [[Documentation/Maemo 5 Developer Guide/Development Environment/Maemo Flasher-3.5|re-flash]] your device in case of trouble is assumed. All apps must go through [[Extras-testing]] and receive a minimum number of tester approval votes before they can be promoted to Extras.

-

{{main|Task:Consolidation of Extras}}

+

-

The Extras policies are still in the process of being defined and refined. See [[Extras repository process definition]] and [[Diablo Extras repository proposal]] for details and discussion.

+

-

See also the [[Extras/3rd Party Package Policy]] being tested in Fremantle.

'''The software hosted in extras-devel is most likely not ready for end users!''' PLEASE PLEASE PLEASE don't play with it unless you really know what you are doing.

-

=== Downloads ===

+

Developers upload the newest version of their software to [[Extras-devel]]. From there the packages go through an automatic and human Quality Assurance process. This is a repository for developers and regular contributors of specific software projects. If you want to play with extras-devel software you need to be prepared to feel some pain sooner or later.

-

{{main|Providing changes since last version of a package}}

+

-

You can [https://maemo.org/downloads/product/create/OS2008/application.html create an entry] for your application in the [http://maemo.org/downloads maemo.org downloads section]. If the unixname of your entry is the same as your debian package in Extras, the version information will be automatically updated when you upload a new package.

+

-

There is a discussion going on about how to provide changes since last version of a package. At the moment there isn't a conclusion to this discussion yet.

+

In theory, packages can be mass downgraded from extras-devel to extras but the exact procedure is TBD.

The software hosted in extras-testing might not be ready for end users! Please don't play with it unless you really know what you are doing. See this post for a more user-specific discussion of the risks. There is also some tips at Installing unstable applications -article.

Extras-testing is a repository that holds applications waiting to be tested (that is, those that the maintainer believes are ready for public release). It is a place where power users can download the latest developer releases, test them out and evaluate them. User backups and predisposition to re-flash your device in case of trouble is assumed. All apps must go through Extras-testing and receive a minimum number of tester approval votes before they can be promoted to Extras.

The software hosted in extras-devel is most likely not ready for end users! PLEASE PLEASE PLEASE don't play with it unless you really know what you are doing.

Developers upload the newest version of their software to Extras-devel. From there the packages go through an automatic and human Quality Assurance process. This is a repository for developers and regular contributors of specific software projects. If you want to play with extras-devel software you need to be prepared to feel some pain sooner or later.

In theory, packages can be mass downgraded from extras-devel to extras but the exact procedure is TBD.