This is not the current specification for Ubuntu Software Center; it is an archived copy of the specification for Ubuntu Software Center 2.0. Not all of it was implemented, and it includes some initial plans for 3.0.

Ubuntu Software Center is a utility for installing and removing software in Ubuntu. In version 1, it builds on the basic philosophy of Add/Remove Applications with an easier-to-use design. In version 2, the primary feature goals are displaying non-application packages, and making PPAs and other repositories more prominent. In version 3, we plan to offer commercial software for sale, and allow ratings and reviews of software. Later versions may include recommendation features, replace other tools such as apturl, gdebi, APTonCD, and most of the Computer Janitor, and integrate with Update Manager. Integrating those various utilities will make handling software easier, socially improve security, hopefully free space on the Ubuntu CD, and provide a prominent showcase for Ubuntu and partner software. Ubuntu Software Center is implemented using Python, GTK, and Aptdaemon, and may use PackageKit for some components. The project is hosted in Launchpad.

How you can help

We welcome useful contributions from anyone, regardless of age, gender, or experience.

If your expertise is in one of these areas, search through this specification for the color-coded sections relevant to you:

Artists

Copy-editors

GTK/Clutter hackers

Interface designers

Librarians

Packagers

Otherwise, if you are a Python programmer, get the latest code and try fixing existing bugs, or implementing something for version 3.0. When you have something ready, propose it for merging.

If you are a tester, look through this specification and compare the behavior described, sentence by sentence, to the behavior you see in the trunk version. If something has been implemented but behaves differently from how the specification describes it, report a bug if it hasn’t been reported already.

Contents

  1. How you can help
  2. Rationale
  3. Ubuntu Software Center 2.0
    1. Definitions used in this specification
    2. Branding
    3. Launching
      1. Launching graphically
      2. Launching from the command line
    4. Common interface components
      1. Menus
      2. Location bar
        1. Path button
        2. Search field
      3. Searching in general
      4. Software icon view
      5. Software list view
      6. Categorized list view screen
      7. Software item screen
    5. Main window
      1. Navigation pane
      2. Main pane
      3. Navigation between screens
      4. “Get Software” section
        1. Back/Forward navigation
        2. Location bar in the “Get Software” section
        3. Software list view in “Get Software”
        4. Lobby screen
        5. Department screen
        6. Subsection screen
        7. Searching in “Get Software”
        8. Software item screen in “Get Software”
      5. “Installed Software” section
        1. Software list view in “Installed Software”
        2. Software item screen in “Installed Software” section
      6. Individual software sources
        1. Software list view for individual software sources
      7. “In Progress” section
      8. Status bar
    6. Determining software item information
      1. Icon
      2. Title
      3. Summary
      4. Genre
      5. License label
    7. Custom package lists
    8. Handling a broken apt cache
    9. Handling an externally-changed apt cache
    10. Copying a Web link for a package
    11. Installing software
    12. Removing software
    13. Help
    14. About window
  4. Ubuntu Software Center 3.0
    1. Ratings and reviews
      1. Submitting reviews
      2. Review service
      3. Presenting reviews
      4. Flagging reviews as inappropriate
    2. Single-pane department screen
    3. Popularity
    4. Purchasing software
    5. History section
    6. Copying installations across computers
    7. “Where Is It?” button
    8. Announcing newly-installed applications
    9. Dragging installed applications from USC to a launcher
  5. Features you can implement
    1. Minimum pane sizes
    2. Auto-sizing the navigation pane
    3. Smarter ellipsis of software list view items
    4. Copying software list view items to the clipboard
    5. Copying software item text to the clipboard
    6. Back and Forward menu items and keyboard equivalents
    7. Add-on packages
    8. Launching and navigating from apt: links
      1. apt:package-name
      2. apt:package-name?minver=1.0
      3. apt:package1,package2,…
      4. apt:package-name?section=multiverse
      5. apt:package-name?channel=lucid-partner
      6. Replacing apturl
    9. Date installed
    10. Cancel bar in “In Progress” screen
    11. More informative text for waiting tasks
    12. Copying a Web link for an “In Progress” package
    13. Animation of the main pane
  6. Roadmap
    1. October 2009
    2. April 2010
    3. October 2010
    4. April 2011
  7. Eventual scope
  8. User stories
  9. Similar efforts
  10. Yet-to-be-specified features
    1. Launching via inserting an Ubuntu CD
    2. Launching via .deb package (replacing gdebi)
    3. Launching via file of unknown type
    4. Subcategories
    5. Wine integration
    6. License information
    7. Developer tools
    8. Eliminating the “{title} can’t be installed at the moment” alert
  11. Unresolved issues
  12. Unsorted ideas

Rationale

In past versions of Ubuntu, there have been many graphical utilities promoted for installing and removing software. For installing and uninstalling graphical applications you could use “Add/Remove Applications“ or the more technical “Synaptic Package Manager”, though the former warned you to use the latter “for more complicated needs”. For installing and uninstalling other software, you had to use Synaptic. For installing updates, the usual route is Update Manager, but it instructs you to run Synaptic if it encounters conflicts. For configuring where all these utilities look for software, you use “Software Sources”. For installing official software via the Web, you use apturl. For installing downloaded .deb packages, you use gdebi. And for removing no-longer-needed software, you use Computer Janitor. This redundancy increases the amount of interface people have to learn, wastes space on the Ubuntu CD, and fragments development effort. Having multiple sanctioned graphical methods of installing software also makes people more likely to think that unsanctioned methods are just as safe, when they are not. Meanwhile, the descriptions of available software are often technical gibberish. And many software project and vendor Web sites either provide command-line installation instructions (dulling users to malicious terminal commands from other sources) or .tar.gz downloads that are difficult to install and near-impossible to update.

Instead, there should be one obvious mechanism for installing and removing software in Ubuntu, with a self-evident name and an interface anyone can use. There should be a coordinated system for developers and enthusiasts to improve the usefulness of descriptions and other metadata for software packages. And projects and vendors whose software is packaged for Ubuntu should be encouraged to provide links to their software’s presence in the Software Center, instead of command-line installation instructions.

If Linux has an Achilles heel, from the point of view of a Windows user, it's installing new software. Be prepared to enter a new world in which Windows Update is a model of simplicity by comparison, and in which you may feel as if you need a Ph.D. in physics merely to install new applications or updates.

— Preston Gralla, “Living free with Linux: 2 weeks without Windows”, Computerworld

First there is the Add/Remove Applications program, which is designed to allow you to Add and Remove Applications. Second, there is the Synaptic Package Manager, which allows you to Manage Packages (in a manner that is uniquely synaptic, apparently) or Applications as some might call them, by allowing you to Add and Remove them. Finally there is Software Sources, which, if Wine’s installation instructions are any indication, provides Sources of Software, filling a glaring gap in Ubuntu Linux by allowing you to Add and Remove Applications.

— Ash Pringle, “The New Year Linux resolution: Day 5”, zMogo

Ubuntu Software Center 2.0

Definitions used in this specification

alert

A dialog that emits the standard alert sound (if any) when it opens, and requests attention if it opens in the background.

alphabetically

Following the Unicode Collation Algorithm for the user’s locale. For example, in an English locale, “Déjà Dup Backup Utility” should be sorted alphabetically between “Debian Documentation Browser” and “DeskScribe”.

dialog
A window that is modal to its parent (if it has one), only ever minimizes together with its parent (if it has one), and does not have any buttons in its title bar (except Minimize if it has no parent).

em
The height of the Gnome application font setting. For example, if the current Gnome application font setting works out to be 12 pixels, then 3 em = 36 pixels.

leading
Left whenever the system is using a left-to-right language. Right whenever the system is using a right-to-left language. (All mockups in this specification are of left-to-right layouts.)

software item

A package or an application. If app-install-data or an archive index refer to one and only one application in a package, the package itself should not be treated as a software item, because it is represented by the application instead. But if there are multiple applications in a package, or none at all, the package should be treated as a software item.

trailing
Right whenever the system is using a left-to-right language. Left whenever the system is using a right-to-left language.

Branding

The program itself, as well as application launchers, help pages, and marketing materials, should consistently use the term “Ubuntu Software Center” (not just “Software Center”). This name should be localized, for example as “Centre” in Commonwealth countries. It is not necessary to translate it word-for-word, but:

The package name and executable name should both be software-center.

The application Comment should be “Lets you choose from thousands of free applications available for Ubuntu” (without a period), and the summary in the About window should be “Lets you choose from thousands of free applications available for Ubuntu.” (with a period).

The package Summary should be “Utility for browsing, installing, and removing applications” (without a period).

The package Description should be:

Ubuntu Software Center lets you browse and install thousands of free applications and other software available for Ubuntu. You can view available software by category, or search quickly by name or description. You can also examine the software already installed, and remove items you no longer need.

To install or remove software using the Center, you need administrator access on the computer.

The application icon should be of an attractive shopping bag with handles, such as you might get from a high-class department store.

softwarestore.svg

icon-v2.jpg

1.x

2.x

The version shipped in Ubuntu 10.04 should be at least 2.0.

Launching

If USC is launched by any means when it is already open, the existing instance should be focused.

Launching graphically

In the standard gnome-panel “Menu Bar” applet, “Ubuntu Software Center” should be the last item in the “Applications” menu, with a separator immediately before it. In the gnome-panel “Main Menu” applet, “Ubuntu Software Center” should similarly be after the list of application categories, with separators immediately before and after it.

In Ubuntu Netbook Remix (netbook-launcher), “Ubuntu Software Center” should appear in the “System” > “Administration” subcategory.

How do we specify performance requirements? Also need to specify progress feedback if launching is slow.

When opened directly, the Center should by default display the lobby screen of the “Get Software” section, scrolled to the top. The search field should be empty. Default focus should be on the search field (so that you can start searching immediately, or use Down followed by other arrow keys to navigate the items in the lobby screen).

Launching from the command line

software-center should launch the Center to its default view. software-center package-name should open the Center to display that package. What to do if the package is unknown?

Common interface components

_File
=====
  _Install
  _Remove
-------------------
  _Close    Ctrl W

“Install” and “Remove” should be disabled by default. “Close” should, by default, close the window and exit the Center.

In future this menu will contain items for more obscure package operations.

_Edit
=====
  _Undo                     Ctrl Z
  _Redo               Shift Ctrl Z
-----------------------------------
  Cu_t                      Ctrl X
  _Copy                     Ctrl C
  Copy _Web Link      Shift Ctrl C
  _Paste                    Ctrl V
  _Delete
-----------------------------------
  Select _All               Ctrl A
-----------------------------------
  Searc_h…                  Ctrl F
-----------------------------------
  _Software Sources…

“Software Sources…” should open the Software Sources control panel. (software-properties-gtk should be responsible for focusing an existing copy of itself if it is already open.)

All other items in this menu should be insensitive by default; their availability and behavior is defined elsewhere in this specification.

_View
=====
* All Software
  Canonical-Maintained Software

All items in this menu should be insensitive by default; their availability and behavior is defined elsewhere in this specification. Test case: (sc-003) Start installing something in the Center. While it is installing, navigate to the “In Progress” section, and open the “View” menu. Its items should be insensitive.

In future this menu may include items for different view types (Icons, List, Gallery).

_Help
=====
  Ubuntu Software Center _Help…
--------------------------------
  _About This Version

By default, “Ubuntu Software Center Help…” should open the help viewer to the front page of the help.

“About This Version” should open the About window, or focus it if it is already open.

Location bar

location-bar.jpg

Many Center sections include a location bar, which appears at the top of the main pane. It should appear as a raised block inside the main pane.

The location bar contains various contents, sometimes including a title, path button, and/or search field. Where there is a title, it should be displayed in bold text. The search field should always be at the trailing end, while any other contents are at the leading end. Whenever the search field is not present, the other contents should consume, if necessary, some of the space the search field would otherwise consume.

Path button

path-button.jpg

In some screens, the location bar includes a path button. This should consist of a button in one or more interlocking segments, with the point of one fitting into the crook of the next. If the button cannot be wide enough to display the text of all the segments, then the first segment should be shortened, with the text inside it being ellipsized at the trailing end, e.g. “Get Softw…”. If the button is still too wide even after the first segment has been shortened to read just “…”, then the second segment should be shortened in the same way, and so on.

The path button should have the accessible name “You are here:”.

Search field

search-field.jpg

Whenever a search field is present in the window, the “Edit” > “Search…” menu item should be sensitive. Selecting it should focus the search field, and (even if it is focused already) select its entire contents.

Whenever the search field is focused, the “Edit” > “Undo”, “Redo”, “Cut”, “Copy”, “Paste”, “Delete”, and “Select All” items should have their usual sensitivity and operation for a text field.

Inside the leading end of the field should be a symbolic magnifying glass icon. Clicking the icon should focus the field and select its entire contents.

When (and only when) the search field is not empty, the trailing end of the field should have a symbolic clear icon. Clicking the icon should focus the field and clear its contents.

Besides the normal behavior for text fields, whenever the insertion point (caret) is at the trailing end of the search field, pressing the Down arrow key should focus the contents of the main pane and select the first item — such as the first department in the lobby screen, or the first result in any list of search results.

The search field should have the accessible name “Search”.

Searching in general

When searching anywhere in the Center, any word in the search string that is followed by a space or punctuation should be treated as a a complete word, while any word that is not should be treated as if it may be either a complete word or the beginning of a word. Test case: (sc-004) From the top-level “Get Software” screen, search for “atom”; it should return both Atomix and Liferea (an Atom feed reader). Now search for “atom ” (with a trailing space); it should return only Liferea.

[foundations-lucid-non-applications-in-software-center 1 of 4]

If the search terms exactly match a package name, that package should be returned first in the results, even if the package was hidden by default.

Software icon view

A software icon view is used mainly to present software items, and currently also to display the list of departments in the “Get Software” section.

Each item in an icon view features the software item’s icon and its title.

If the icon is scalable, or larger than 4 em in either dimension, it should be scaled down proportionally so that it is 4 em in its largest dimension. If the icon is already smaller than 4 em in both dimensions, it should be drawn at actual size and centered (both horizontally and vertically) inside a 4 em square that has a 0.05-em-wide border of color 170,170,170 (#aaaaaa).

Underneath the icon, the item title should be printed in 0.9-em text that is horizontally centered but top-aligned in its own block; if the title occupies more than two lines, it should be ellipsized in the middle (because unique elements of titles are more often at the beginning or the end). If the package is not available for this computer’s architecture, both the icon and the text should have 50% opacity, but the package should still be selectable.

Items should be laid out like horizontal text: starting at the leading edge and continuing until there is no room for another item on the same line, then wrapping downward.

Each item in a software icon view should produce a pointing-hand pointer when moused over, and single-clicking should navigate to that item.

Software list view

[foundations-lucid-software-center-ui-improvements 1 of 7]

A software list view is used in several screens in the Center. In a list view, each software item should have a row displaying the item’s icon, title, and summary. The row’s accessible name should be the item’s title, and its accessible description should be the item’s summary.

item-row-basic.jpg

Various extra elements are added to the software list view in the “Get Software” section, in the “Installed Software” section, and in the “In Progress” section.

In any software list view, as with the software icon view, the icon should be overlaid in the corner with the installed emblem if the package is currently installed.

If either row of text is wider than the space available, it should be ellipsized at the trailing end.

By default, none of the rows in a software list view should be selected. If the view allows selection, clicking anywhere in an row should select that item, and Ctrl+clicking on a selected item should deselect it. If no item is selected, pressing the Down arrow key should select the first row, and conversely pressing the Up arrow key should select the last row. If the view does not allow selection, the arrow keys should scroll the view without highlighting rows.

If the software item is not installable for this computer’s architecture, both the icon and the text — but not the buttons when the row is expanded — should have 50% opacity, but the item should still be selectable.

Whenever an item is selected in a software list view:

Unless otherwise specified, a software list view should always have a vertical scrollbar. (This prevents elements at the trailing end from jumping about when the view contents switches between shorter than, and longer than, the container’s height). A software list view should never have a horizontal scrollbar.

[foundations-lucid-non-applications-in-software-center 2 of 4]

If a software list view has items hidden by default, the bottom of the pane containing the view should have a panel (below the bottom of the scrollbar) containing text of the form “17 other technical items”. Following that link should display the items that were hidden by default, and make the panel itself slide down into oblivion.

software-list-view-disclosure.jpg

Categorized list view screen

[foundations-lucid-software-center-ui-improvements 2 of 7]

categorized-list-view-screen.jpg

A categorized list view screen should use a software list view, with the addition that all its software items should be child items of parent items for the department (but not the subsection) that they belong to. Only departments that actually contain items should be shown. The expanded or collapsed state of every department, for every categorized list view screen, should be remembered between sessions until that department stops existing in that list view.

Any categorized list view screen should have a location bar, containing a section-dependent title and a search field. It should also have section-dependent status bar text (which, as usual, should temporarily be overridden when displaying search results).

Searching from a categorized list view screen should not cause any departments to expand of their own accord. However, departments that do not either (a) contain any matching software items, or (b) have names that match the search text themselves, should themselves not be present in the list view.

Software item screen

In both the “Get Software” and “Installed Software” sections, a software item screen should show information about an item, and let you install or remove it. (Once add-on handling is implemented, it should also let you select and change add-ons.)

Whenever a software item screen is being displayed:

Erratum: In 2.0, the stars and reference to reviews shown here should not be present.

software-item-screens.jpg

A software item screen should contain:

The installed state bar contents depends on the item’s exact state.

The availability state bar contents also depends on the item’s exact state.

The “Get Software” section shows screens for both uninstalled and installed items, and these should share the overall “Get Software” color scheme. The “Installed Software” section shows screens for installed items only, and should have a different color scheme.

Copy-editors

Within the Center, examine the title, summary, and description of an item. Is it concise and helpful? Is the spelling and grammar correct? If it’s a non-geek application, does the description avoid geek language? Is it in the appropriate department? If you find a problem, and you are comfortable diving into code to fix it yourself, follow the distributed development instructions with the app-install-data-ubuntu package to fix problems in an application’s title or summary, or the package itself to fix problems with its description. Otherwise, report a bug with (a) the current text, (b) what needs improving, and (c) your proposed replacement text, and give the bug report the metadata tag.

Packagers

Please look for bugs that people have reported about inappropriate application names or summaries, or package descriptions or departments, and fix them. Thanks for your help.

Packagers

If a single package contains multiple applications, and people might reasonably want to install these applications separately, work to separate the packages into one per application.

Main window

main-window-structure.jpg

The Center should use a normal window, with the title “Ubuntu Software Center”.

default window size and placement TBD

The main window has four major components: the menu bar at the top, the navigation pane on the leading side, the main pane on the trailing side, and the status bar at the bottom. The bar between the navigation pane and the main pane should be draggable to change their respective widths.

Sometimes the main pane contains a location bar or an action bar.

The navigation pane should have the accessible name “Software sources”. It should have a vertical scrollbar only when necessary, and should never have a horizontal scrollbar. Instead, each item inside it should be ellipsized at its trailing end whenever there is not enough room to show it completely.

The navigation pane should list the top-level sections that can be navigated to, each with a text-size icon and a label:

In future versions the navigation pane will contain other items, such as history, recommendations, and user-created collections.

In the navigation pane, one and only one item should be selected at any time. Single-clicking an item should select it. Double-clicking should behave identically to single-clicking, and secondary-clicking or dragging should do nothing.

If you collapse the parent item of the selected item in the navigation pane, that parent item should become selected instead.

Test case: (sc-006) In the “Get Software” section, navigate to the AbiWord application, and scroll to the bottom of the AbiWord screen. In the navigation pane click on “Installed Software”, then on “Get Software”. The Center should resume displaying the bottom of the AbiWord screen.

Test case: (sc-007) In the “Installed Software” section, navigate to the Firefox application. Close the Center, then reopen it. Click on “Installed Software”. The Center should display the top level of the Installed Software section.

Test case:(sc-008) Begin installing something. While it is installing, in the “Get Software” > “Internet” section, search for “chat”, and scroll through the results. Click on “In Progress”; the Center should show the installation progress. Now click on “Get Software”. The Center should return to the search results for “chat” within the “Get Software” > “Internet” department, in exactly the scroll position that you left it.

Main pane

Whenever the main pane contains a location bar with a path button, the main pane should have an accessible name the same as the text of the last item in the path button.

Whenever the main pane does not contain a location bar with a path button, the main pane should have an accessible name the same as the text of the selected item in the navigation pane.

Whenever the Center navigates from one screen to another, whether directly (with mouse or keyboard) or indirectly, it should:

  1. immediately highlight the appropriate row in the navigation pane, if it has changed;
  2. begin displaying the corresponding screen in the main pane;
  3. if the corresponding screen has not displayed within 1 second, display a blank screen with a horizontally and vertically centered spinner, until the screen is available.

Test case: On a slow computer, choose “View” > “All Software”, then “Provided by Ubuntu” on a slow computer. The spinner screen should appear until the full list is available.

When navigating to a different section, the main pane should display, to the extent still applicable, the section exactly as it was when it was last viewed since the Center was launched: the same department, category, search results, scroll position, etc. This memory should not persist once the Center is closed.

“Get Software” section

The “Get Software” section should present all software items that are installable from any of the computer’s current software sources (plus any software source represented by a X-AppInstall-Channel attribute in app-install-data), regardless of whether they are already installed (already-installed items should have the “installed” emblem). It should not provide access to packages that are currently installed but not in any of your software sources; these should be in the “Installed Software” section instead.

The section contains a “lobby” screen, screens for each “department”, screens for subsections, and a screen for each software item.

In the navigation pane, the “Get Software” item should have the same icon as the Software Center itself. It may have an extra icon at the trailing end for a broken software catalog.

Whenever you are in the “Get Software” section, the “View” > “All Software” and “View” > “Canonical-Maintained Software” items should be sensitive. Changing the selection should determine whether all software or just Canonical-maintained software is are shown. The selection should persist regardless of which screen in the “Get Software” section is being displayed.

Whenever a software item is selected — whether searching from the lobby, in a department, in a subsection, or implicitly by being in a software item screen itself:

Back/Forward navigation

[foundations-lucid-software-center-ui-improvements 3 of 7]

Starting from each launch of the Center, it should remember a navigation history of the screens you have visited in the “Get Software” section (not including any screens for individual software sources). This navigation history should function as in a conventional Web browser: navigating using the history should move within it without adding items to it, and navigating without using the history should discard all forward items from the history.

Each item in the history should remember its scroll position, what software item was selected (if any), and what element was focused (if any).

If the search field was non-empty when you navigated to a separate screen, the search you had entered just before you navigated should be stored as its own history item. Intermediate searches should not be in the history.

Test case: (sc-009)

  1. Launch the Center. Both the Back and Forward buttons should be insensitive.
  2. Navigate to the “Games” section. The Back button should become sensitive.
  3. Navigate to the “Installed Software” section, and then to an individual item screen inside it. Return to “Get Software” in the navigation list. You should be back in the “Games” section.
  4. Activate the Back button. You should return to the lobby, the Back button should become insensitive, and the Forward button should become sensitive.
  5. Activate the Forward button. You should return to the “Games” section, the Back button should become sensitive, and the Forward button should become insensitive.

Location bar in the “Get Software” section

get-software-location-bar.jpg

All screens in the “Get Software” section should have a location bar, containing at least Back and Forward buttons and a path button. (The elements in the path button are defined for individual screens in this specification.)

The Back and Forward buttons should navigate through the navigation history. If there is no screen to go back to or forward to, the Back and Forward buttons should be insensitive respectively.

Software list view in “Get Software”

Erratum: In 2.0, the stars and reference to reviews shown here should not be present.

item-row-available-unselected.jpg

item-row-available-selected.jpg

When (and only when) a row is selected, it should expand to reveal “More Info” and “Install” buttons (and, if add-on handling has been implemented and the item has add-ons, a “Choose Add-Ons…”/“Change Add-Ons…” button depending on whether the item is currently installed).

item-row-available-unselected.jpg

item-row-available-selected.jpg

item-row-available-installed-unselected.jpg

item-row-available-installed-selected.jpg

The “More Info” button should have Enter as its access key. Activating it should navigate to the software item screen.

The “Install” button (and, once implemented, the “Choose Add-Ons…”/“Change Add-Ons…” button) should be insensitive if the item is installed, currently installing, or scheduled for installation. The “Install” button should not have an access key (because that would interfere with typing letters to navigate the list). Activating the button should install the item.

When an item is being installed or removed (or, once add-on handling has been implemented, is having its add-ons changed), the trailing end of the row should have a progress bar showing progress of the task. If the item is being installed (or is having its add-ons changed), it should also have an icon-only cancel button. During this time the secondary text for the row should be the status text for the task, instead of the item’s summary.

item-row-available-installing-unselected.jpg

item-row-available-installing-selected.jpg

item-row-available-removing-unselected.jpg

item-row-available-removing-selected.jpg

Lobby screen

lobby.jpg

The lobby is the entry point to the Center, so it is important that it be attractive and welcoming. (The term “lobby” should not appear anywhere in the interface or help text.)

Whenever the lobby screen is being displayed:

The background of the lobby screen should be grey-blue 182,189,196 (#b6bdc4), and all text in that screen should be black 0,0,0 (#000000). The padding between the edges of the lobby and its contents should be 1 em, both horizontally and vertically.

The lobby currently has one section, “Departments”. The header should use a background... TBD The section should have a bottom margin of 2 em.

Arrow keys should change focus between the selectable items in the lobby screen.

The “Departments” section of the lobby screen should list the departments as defined and sorted under “Genre”, using an icon view.

Artists

What is a more attractive way of presenting these departments? Currently they look very similar to individual applications, but probably they should look different. Perhaps they should use buttons of some sort? Perhaps the clickable element for each department could incorporate small versions of the icons for the most popular applications or packages in that department?

Department screen

[foundations-lucid-software-center-ui-improvements 4 of 7]

get-software-department.jpg

If a department has any subsections, or if it has any items marked as X-AppInstall-AlwaysOnTop, the department screen should have two panes. Otherwise, it should have one pane.

If there are any items marked as X-AppInstall-AlwaysOnTop, the top pane should begin with a “Bundles” section, presenting those items alphabetically in an icon view.

Next in the top pane should be a section with the same name as the department itself (e.g. “Games”), presenting those items alphabetically in an icon view.

The bottom pane — or, if there is only one pane, the only pane — should be an alphabetically sorted software list view of the software items in that department. If the department is not set to “Show non-applications by default”, non-application items should be hidden by default.

Whenever a department screen is being displayed:

Subsection screen

[foundations-lucid-software-center-subcategories 1 of 2]

get-software-subsection.jpg

A subsection screen should be an alphabetically sorted software list view of the software items in that subsection. If the subsection is not set to “Show non-applications by default”, non-application items should be hidden by default.

Whenever a subsection screen is being displayed:

Searching in “Get Software”

When in the lobby, or in the screen for a department or subsection, the location bar should contain a search field that searches within that scope. This should follow the standard searching behavior.

In addition, whenever the search field contains any text, or has been empty for less than two seconds:

Test case: (sc-010) Launch the Center. Type Ctrl F; the search field should be focused. Type “fire” (without quotes or pressing Enter); the “Search Results” path button element should appear, and the main pane should be replaced by search results, with Firefox first. Press the down arrow key once; Firefox should be selected in the results. Press Enter; the Center should navigate to the software item screen for Firefox.

department-search.jpg

[foundations-lucid-non-applications-in-software-center 3 of 4]

When searching from the lobby, a non-application item should be hidden by default if its primary subsection (or, if it has no subsection, its primary department) does not “Show non-application packages by default”.

When searching from a department screen, a non-application item should be hidden by default if its presence in that department is in a subsection (or, if it has no subsection, that department itself) that does not show non-application packages by default.

For the sake of people who are unfamiliar with how they should use the search, there should be a greylist of words that are downplayed when searching. “Downplayed” in this sense means that:

For English, the greylist should be “app application package program programme suite tool”. The greylist should have a translation note: “Do not translate this list directly. Instead, provide a list of words in your language that people are likely to include in a search but that should normally be ignored in the search.”

Test case: (sc-011) From the lobby, search for “drawing”. Then search for “drawing program”. The Center should return exactly the same results for both searches, but in a different order.

Test case: (sc-012) From the lobby, search for “application suite”. The Center should return only results that include both those words.

Testers

You can help us improve the search function by testing it in successive versions.

Needs refactoring: Some of this search logic also applies to “Installed Software”.

Software item screen in “Get Software”

Whenever a software item screen is being displayed in the “Get Software” section:

“Installed Software” section

The “Installed Software” section should provide access to all software items that are currently installed, regardless of whether they are available from any of the computer’s current software sources.

[foundations-lucid-software-center-ui-improvements 5 of 7]

The “Installed Software” section should have its own home screen, and screens for individual software items. It should not include screens for each department or subsection.

Whenever you are in the “Installed Software” section, the “View” > “All Software” and “View” > “Canonical-Maintained Software” items should be sensitive. Changing the selection should determine whether all software or just Canonical-maintained software is shown. The selection should persist regardless of which screen in the “Installed Software” section is being displayed.

Regardless of which screen is being displayed, the section should should have a location bar containing a path button.

In the navigation pane, “Installed Software” should have an icon of a computer. It may have an extra icon at the trailing end for a broken software catalog.

installed-software.jpg

The top level of the “Installed Software” section should show a categorized list view screen listing all the software items currently installed, with its title being “Installed Software”, and its status text being of the form “1047 items installed”.

Software list view in “Installed Software”

When (and only when) a row is selected, it should be expanded to reveal “More Info” and “Remove” buttons (and, if add-on handling is implemented and the item has add-ons, a “Change Add-Ons…” button).

item-row-installed-unselected.jpg

item-row-installed-selected.jpg

The “More Info” button should have Enter as its access key. Activating it should navigate to the software item screen.

The “Remove” button should not have an access key (because that would interfere with typing letters to navigate the list). Both it, and “File” > “Remove”, should be insensitive if the item is either being removed or scheduled for removal. Activating the button or the menu item should remove the software item.

As with the “Get Software” section, when an item is being removed or is queued for removal, its row should have a progress bar at the trailing end, and its secondary text should be status text rather than the item summary. If the item is successfully removed, the progress bar should remain full for one second before the row disappears altogether (because the item is no longer installed).

item-row-installed-removing-unselected.jpg

item-row-installed-removing-selected.jpg

Software item screen in “Installed Software” section

Whenever a software item screen is being displayed in the “Installed Software” section:

Individual software sources

[foundations-lucid-software-center-ui-improvements 6 of 7]

get-software-channels.jpg

In the navigation pane, the top-level “Get Software” and “Installed Software” sections should present the aggregate of available or installed software items, respectively, from all enabled software sources.

Meanwhile, those individual software sources should be presented as separate child items of the “Get Software” item and the “Installed Software” item. “Get Software” should have child items for each software source that is enabled, plus an item for any source represented by an X-AppInstall-Channel in app-install-data). “Installed Software” should have child items for each source from which any software is currently installed, plus an item containing all installed packages with an unknown source.

Both “Get Software” and “Installed Software” should be collapsed on first launch, but their expanded or collapsed state should persist between sessions. If an software source disappears while it is selected, the parent item should become selected.

The icon, label, and sort order for individual software sources inside each of “Get Software” and “Installed Software” should be as follows:

  1. Main, Universe, Restricted, and Multiverse for the current Ubuntu version should be aggregated into a single first item, with the Ubuntu logo as its icon, and the label “Provided by Ubuntu”.
  2. Next should be any sources represented by an X-AppInstall-Channel attribute in app-install-data, sorted alphabetically. The Canonical partner repository for the current Ubuntu version should have the Canonical logo as its icon, and the label “Canonical Partners”. Any others should have a generic repository icon, and should have a label equal to the contents of the Label: field from the Release file.

  3. Next should be any PPAs, sorted alphabetically. Each should use the same PPA icon that Launchpad uses, and should have a label equal to the contents of the Label: field from the Release file. Until this label has been retrieved from Launchpad, a PPA item should use the same naming scheme as any other non-CD source.

  4. Next should be any other network sources, sorted alphabetically. Each should use a generic repository icon, and a label consisting of its URI with the protocol stripped, e.g. “packages.example.org/ubuntu/”. (We don’t use the Label: here because we don’t trust third-party repositories as much as we trust PPAs.)

  5. Next should be any volumes (such as CDs, DVDs, or USB sticks) containing packages, sorted alphabetically. Each should have the same icon as it has in the file manager. If a volume contains a /.disk/info file, its label should be of the form “{OS version}”, where the OS version is the contents of /.disk/info up to but not including the first " character nor any spaces immediately preceding it. Otherwise, the label should be the same as it is in the file manager.

  6. Finally, in “Installed Software”, the section for packages with an unknown source should have a question mark as its icon, and the label “Other”.

The screen for each individual software source should present a software list view of all the items in that source. Whenever this screen is being displayed, the status bar text should be of the form “141 items” (as appropriate for the number of items in that source).

Test case: (sc-013)

  1. With “Get Software” collapsed and “Installed Software” expanded, close the Ubuntu Software Center and reopen it. The state should be remembered.
  2. Expand the “Get Software” item. Add a PPA in Software Sources. The PPA should appear immediately as a child item of “Get Software”, and should soon be relabelled from its URL to its display name.
  3. Install a package from that PPA. When it finishes installing, the PPA should appear immediately as a child item of “Installed Software” too.
  4. Select that new child item. Remove the package. When it finishes uninstalling, the PPA should disappear as a child item of “Installed Software”, and that parent item should become selected.
  5. Select the PPA inside “Get Software”, then remove the PPA from Software Sources. The PPA should disappear immediately as a child item of “Get Software”, and that parent item should become selected.

Test case: (sc-014)

  1. Download and install the Skype package.
  2. Expand the Ubuntu Software Center “Installed Software” section. it should have an “Other” child item that lists the Skype package.
  3. Expand the “Get Software” section. It should not have an “Other” child item.

Software list view for individual software sources

When any individual software source inside “Get Software” is selected, the main pane should show a software list view of all the packages that source contains, with a single-segment path button using the same label for the source as the navigation pane does, and status text of the form “17 items available”.

When any individual software source inside “Installed Software” is selected, the main pane should show a software list view listing all the packages currently installed (or in the process of being removed) from that source, with a single-segment path button using the same label as the navigation pane, and status text of the form “3 items installed”.

For all sources except “Provided by Ubuntu”, the items in the “View” menu should be insensitive, because they do not apply.

“In Progress” section

in-progress.jpg

The “In Progress” section should be visible only when items are being installed or removed, or when the last installation or removal finished less than two seconds ago. If the section disappears while being displayed, the Center should return to the section that was previously being displayed.

In the navigation pane, the section should have an animated icon of two green semicircular arrows chasing each other clockwise. After the words “In Progress” should be, in brackets, the number of tasks yet to be completed.

Whenever the “In Progress” section is being displayed, the status bar text should be of the form “2 items remaining” or “All items completed”, as appropriate.

The section itself should list the items requested for installation or removal, earliest first. The rows in the list should be based on a software item list view, with these differences:

1.0-in-progress-row.jpg

The cancel button for an individual item should be sensitive only when the item has not yet started or is still downloading.

If you try to close the Center while an item is installing or being removed:

  1. All items in the navigation pane, other than “In Progress”, should become insensitive.
  2. The Center should switch to displaying the “In Progress” section.
  3. When installation is completed or cancelled, the Center should close.

Status bar

The status bar should contain status text, and, in the trailing corner, a resize handle.

The status text should be centered within the status bar, both horizontally (as if the resize handle was not present) and vertically.

Determining software item information

[foundations-lucid-software-center-repository-based-index 1 of 1]

For any software item (a package, or an application with a .desktop file inside a package), there a variety of fields that are derived from the item’s entry in the app-install-data package, the archive index, the Debian control file for the package, or a combination of these.

Icon

The icon should be the icon supplied for the application by your current theme, if there is one; otherwise the icon provided by app-install-data, if there is one; otherwise the generic package icon. This may be enhanced later for more specialized generic icons.

Title

[foundations-lucid-non-applications-in-software-center 4 of 4]

The title should be the application Name, if there is one; otherwise the package synopsis (the first line of the Description field). If this leaves multiple packages with the same title, the package name should be appended in brackets to the title of each of them: “{Previous Title} ({package name})”. (This is the same approach used for disambiguating account names in Ubuntu’s session menu.) Test case: (sc-015) Search for the “backintime-gnome” package. The item should have the title “Back In Time (backintime-gnome)”.

Summary

The summary should be the application Comment, if there is one; otherwise the package synopsis, if the application has a Name but not a Comment; otherwise the package name (because if you’re looking at a non-application package in the first place, you’re fairly likely to be the sort of user who wants to know the package name).

Genre

[foundations-lucid-software-center-subcategories 2 of 2]

Every item has a genre represented by a primary department, and sometimes also by a primary subsection and/or a secondary department. If an item has a secondary department, it may also have a secondary subsection. Each department, and each subsection, should have its own icon.

As used elsewhere in this specification, an item’s department means its primary department, and its subsection means its primary subsection.

These are the departments and subsections, in the order in which they should be presented when presented together:

Department

Equivalent menu spec categories

Equivalent sections

Package name pattern

Show non-application packages by default

- Subsection

Accessories

Utility, System

-

-

Education

Education

-

-

Fonts

-

-

(t,o)tf-*

yes

Games

Game, Sports

-

-

- Board Games

BoardGame

-

-

- Card Games

CardGame

-

-

- Puzzles

LogicGame

-

-

- Role-Playing

RolePlaying

-

-

- Sports

SportsGame

-

-

Graphics

Graphics

-

-

- 3D

3DGraphics

-

-

- Drawing

VectorGraphics

-

-

- Painting

RasterGraphics

-

-

- Photography

Photography

-

-

- Publishing

Publishing

-

-

- Scanning & OCR

Scanning, OCR

-

-

- Viewers

Viewer

-

-

Internet

Network

-

-

- Chat

InstantMessaging, IRCClient

-

-

- File Sharing

FileTransfer

-

-

- Mail

Email

- (not mail)

-

- Web Browsers

WebBrowser

- (not web)

-

Office

Office

-

-

Science & Engineering

Science

science

yes

- Astronomy

Astronomy

-

-

- Biology

Biology

-

-

- Chemistry

Chemistry

-

-

- Computing & Robotics

ArtificialIntelligence, ComputerScience, Robotics

-

-

- Electronics

Electronics

-

-

- Engineering

Engineering

-

-

- Geography

Geography

-

-

- Geology

Geology, Geoscience

-

-

- Mathematics

DataVisualization, Math, NumericalAnalysis

math, gnu-r

yes

- Medicine

MedicalSoftware

-

- Physics

Electricity, Physics

-

Sound & Video

AudioVideo, Audio, Video

- (not sound or video)

-

Themes & Tweaks

Settings

-

- Background Pictures

-

-

*-backgrounds, *-wallpapers

yes

- Themes

-

-

*-theme

yes

Universal Access

Accessibility

-

Developer Tools

Development

devel

yes

- Debugging

Debugger

- (not debug)

-

- Graphic Interface Design

GUIDesigner

-

-

- Haskell

-

haskell

yes

- IDEs

IDE

-

-

- Java

-

java

yes

- Libraries

-

libdevel (not libs or oldlibs)

yes

- Lisp

-

lisp

yes

- Localization

Translation

- (not localization)

-

- Mono/CLI

-

cli-mono

yes

- OCaml

-

ocaml

yes

- Perl

-

perl

yes

- Profiling

Profiling

-

yes

- Python

-

python

yes

- Ruby

-

ruby

yes

- Version Control

RevisionControl

vcs

yes

- Web Development

WebDevelopment

-

-

System

-

-

yes

Librarians

For 3.0, we will be refining this new classification scheme for the Center. For example, what subcategories could the “Games” department have? And how could the items in the “Internet” menu be redistributed? Tell us your ideas on the Classification page. Thanks!

The algorithm for determining an item’s primary department and subsection should be:

  1. If it has a .desktop file with at least one Category: value that matches one of the subsections listed above, then:

    1. Use the first recognizable Category: value to determine the subsection from the table.

    2. Determine the department from the subsection’s location in the table.
    3. Stop.
  2. If it has a Section: that matches one of the subsections listed above, then:

    1. Use the Section: value to determine the subsection from the table.

    2. Determine the department from the subsection’s location in the table.
    3. Stop.
  3. If it has a .desktop file with at least one Category: value that matches one of the departments listed above, then:

    1. Use the first recognizable Category: value as the department.

    2. Stop.
  4. If it has a Section: that matches one of the departments listed above, then:

    1. Use the Section: value to determine the department from the table.

    2. Stop.
  5. Use “System” as the primary department, with no primary subsection.

The algorithm for determining an item’s secondary department and subsection should be:

  1. If the .desktop file has at least one X-Ubuntu-Category-Secondary: field that matches one of the known departments, then:

    1. Use the first X-Ubuntu-Category-Secondary: value as the subsection.

    2. Determine the department from the subsection’s location in the table above.
    3. Stop.
  2. The item has no secondary department or subsection.

Test case: We should have a test repository containing packages with various combinations of Category: and/or X-Ubuntu-Category-Secondary:.

License label

If the relevant package for an item is in:

If you want this to be less crude, do what you can to get DEP-5 implemented.

Custom package lists

For ease of sharing lists of software, and as a first step towards replacing apturl, the Center should allow “searches” that return ad-hoc package sets.

From the top-level “Get Free Software” screen, whenever a search string consists entirely of characters allowed in package names, interspersed with commas (and no spaces), and optionally followed by a comma:

Test case: (sc-016) On a machine that has Gobby and Orca installed but neither 9base nor abcde, with “View” > “All Software” selected:

  1. Navigate to the main “Get Software” screen and enter “gobby,orca” (without quotes) in the search field. The path button should show “Get Software” > “Custom List”, the rest of the main pane should list “Gobby” and “Orca”, and the status bar should say “2 items”.

  2. Add “,9base” to the search text (“gobby,orca,9base”). The list should change to “Gobby”, “Orca”, and “Plan 9 userland tools”, in that order; an action bar should appear offering to “Install 1 Item”; and the status bar should say “3 items”.
  3. Add a comma to the end of the string (“gobby,orca,9base,”). Nothing should change.
  4. Add the letters “abcd” to the end of the string (“gobby,orca,9base,abcd”). A greyed-out item should appear at the end of the list: “Not found”/“abcd”. The button should still say “Install 1 Item”, and the status bar should still say “3 items”.

    custom-list.jpg

  5. Finally, add the letter “e” to the search string (“gobby,orca,9base,abcde”). The “Not found” item should change to “A Better CD Encoder”/“abcde”, and “Install 1 Item” should change to “Install 2 Items”.

Future work: Consider whether it makes sense to use custom lists within “Installed Software”, or within individual software sources.

Handling a broken apt cache

Whenever the Center detects that the apt cache of packages is currently broken:

catalog-broken-alert.jpg

The broken-catalog alert should have the primary text: “Nothing can be installed or removed until the software catalog is repaired. Do you want to repair it now?” and the secondary text “Once Update Manager has finished the repairs, you can close it and return to the Center.”.

The alert should have “Cancel” and “Repair” buttons, where “Repair” is the default. Choosing “Cancel” should cancel any installation or removal that produced the alert. Choosing “Repair” should launch Update Manager in repair mode.

A future version of the Center should be able to repair the catalog itself.

Handling an externally-changed apt cache

catalog-changed.jpg

Whenever the Center detects that the apt cache of packages has been changed by another process, the contents of the main pane (including location bar, if any) for every section except “In Progress” should temporarily be covered by a curtain.

The curtain should have at least two lines of centered text: “Another program has changed the software catalog.” and “One moment, please…”. Below the text should be a determinate progress bar for the process of rebuilding the Center’s database.

When the process is complete, the curtain should be raised, and all sections should return (as much as practical) to their previous display.

Whenever you choose to copy a Web link for a package, the Center should copy to the clipboard text of the form http://apt.ubuntu.com/p/package-name (without a leading or trailing line break).

Installing software

When you request to install a software item:

  1. The “Install” button should be made insensitive for that item, and remain insensitive until the installation has been completed or cancelled.
  2. The Center should handle a broken apt cache if necessary.

  3. If the relevant package cannot be installed, an error alert should appear: transaction-error-uninstallable.jpg
    The alert should have the primary text “Sorry, {title} can’t be installed at the moment. Try again in a day or two.”, and a secondary “Details” expander control that reveals a text frame containing the dpkg error. It should have an “OK” button which is the default.

  4. If necessary, a PolicyKit alert (with the USC window as its parent) should appear to enter authentication details.

  5. The Center should begin blocking session exit.
  6. The item should appear in the “In Progress” section. If the item is queued waiting for another package manager to close, the status text for the item should be “Waiting for {Application Name} to exit”. If the item is queued waiting for any other activity to complete, the status text for the item should be “Waiting”.
  7. While the download is taking place, the status text should be set to “Downloaded {X} of {Y}”.

  8. While the installation script is running, the status text for the item should be set to the normal text issued by dpkg.

  9. If at any point installation is blocked by a debconf question, the status text for the item should be set to “Waiting for your response…”

  10. When installation completes, the Center should stop blocking session exit.
  11. The “installed” emblem should be applied to the item icon, and the status text should be set to “Installation complete”.
  12. Five seconds later, the item should disappear from the “In Progress” section.

For an item being installed, 50 % of the progress bar length should be allocated to the downloading process, and 50 % to running the installation script.

Packagers (and testers)

Wait, what? Fifty percent? That’s not accurate! Perhaps not, but even a progress bar that varies a bit in speed is infinitely more accurate than one that fills up completely only to jump back to zero for the next step. And you can help us make it even better.

Removing software

When you request to remove a software item:

  1. The “Remove” button should be made insensitive for that item, and remain insensitive until the removal has been completed or cancelled.
  2. The Center should handle a broken apt cache if necessary.

  3. If the relevant package is part of the ubuntu-desktop metapackage, the Center should put up a confirmation alert: “{title} is a core item in Ubuntu. Removing it may cause future upgrades to be incomplete.” The alert should have “Cancel” and “Remove Anyway” buttons; neither button should be the default.

  4. If you request to remove a package that is part of any other metapackage, the Center should put up a confirmation alert: ‘If you uninstall {title}, future updates will not include new items in the “{metapackage title}” set.’ Again, the alert should have “Cancel” and “Remove Anyway” buttons; neither button should be the default.

  5. If you request to remove a package that is depended on by any other package, or an application that shares a binary package with any other application, the Center should put up a confirmation alert: “To remove {title}, these items must be removed as well:” — with any affected applications, followed by any other affected packages, listed alphabetically in an inset software list view that does not allow selection but is focused by default. The alert should have “Cancel” and “Remove All” buttons; neither button should be the default.

    remove-depended-alert.jpg

  6. The Center should, if necessary, ask for authentication details in a PolicyKit alert with the USC window as its parent.

  7. The Center should begin blocking session exit.
  8. The item should appear in the “In Progress” section. If the item is queued waiting for another package manager to close, the status text for the item should be “Waiting for {Application Name} to exit”. If the item is queued waiting for any other activity to complete, the status text for the item should be “Waiting”.
  9. If at any point removal is blocked by a debconf question, the status text for the item should be set to “Waiting for your response…”

  10. When removal completes, the Center should stop blocking session exit.

Help

The help should cover these topics:

About window

The About window should be a standard window (not a dialog) following the standard Gnome About window layout, using the appropriate application summary.

Ubuntu Software Center 3.0

Once 2.0 is released, these changes will be merged into the main specification.

Ratings and reviews

[foundations-lucid-ratings-and-reviews-in-software-center]

Reviewing software involves three software components:

  1. Ubuntu Software Center itself
  2. the Ubuntu Single Sign-On service
  3. an Internet server that receives, stores, and publishes reviews.

A branch implementing this feature should not be merged to trunk until the server side is implemented and reliably maintained.

Submitting reviews

This process begins when you activate the “Review…” button on an “Installed Software” item screen.

If necessary, the Center should go through the Ubuntu Single Sign-On authentication/registration process, using the summary text “To review software, you need an Ubuntu Single Sign-On account.”.

This dialog should eventually be specified and implemented as a separate library. Compare with the Ubuntu One control panel specification.

review-single-sign-on.jpg

Whenever the computer is not connected to the Internet while the authentication dialog is open, the bottom leading corner of the dialog should feature a mini error icon and the text “Not connected to the Internet.”, and the “Continue” button should be insensitive. (The appearance or disappearance of the error message should not resize the dialog; it should always have been large enough to show the whole message.)

review-single-sign-on-offline.jpg

Test case: In a session where you have not signed in, choose “Write a review”; the sign-in dialog should appear. Disconnect from the Internet; the “Not connected to the Internet” error message should appear, and “Continue” should become insensitive. Reconnect to the Internet; the error message should disappear, and “Continue” should become sensitive.

When you activate “Continue”, a spinner and the text “Signing in…” should appear at the bottom leading corner, the “Cancel” button should become “Stop”, and the “Continue” button should become insensitive. (The change in label should not change the size of the button; it should always have been large enough for either label.)

review-single-sign-on-progress.jpg

If the sign-in process stops unsuccessfully, either because you activated “Stop” or because of an error, the spinner and progress text should disappear, “Stop” should change back to “Cancel”, and “Continue” should become sensitive (unless there is no Internet connection). Then:

Once you are signed in, a dialog without a parent window should appear for submitting the review.

review-submit.jpg

This dialog should be resizable; resizing it should resize only the review text field. That field should be focused by default.

The dialog’s title should be of the form “Review {Item Title}”.

Within the dialog, first should be displayed the icon, title, and version number of the software.

Next should be a “Review by:” item showing your name as registered with the Single Sign-On service (as a subtle hint that you are accountable for your words).

The review text field should accept multiple paragraphs, and should use automatic spell-checking. It should be unlabelled, but have the accessible name “Review text”, and the visible caption: “Be brief and informative. Don’t post bug reports.”

The “Summary:” field should accept a single line of text.

The “Rating:” field should consist of five stars plus a caption. By default, no stars should be filled. Whenever the field is focused, the Left and Right keys should increase or decrease the rating in one-star increments, and the 1 through 5 keys should change the rating to that many stars. The caption should reflect the star you are mousing over, if you are, or otherwise the rating you have currently set: “” (no rating yet), “Awful” (1), “Poor” (2), “Adequate” (3), “Good” (4), or “Excellent” (5). Setting a rating level, whether using a pointing device or a key equivalent, should highlight the new rating in a similar visual style as when clicking a checkbox or radio button.

The “Cancel” button should have Esc as its keyboard equivalent.

The “Publish” button should have Enter as its keyboard equivalent. It should be sensitive only if you have entered text in both the review field and the Summary field and set a rating. Activating “Publish” should submit the review.

Whenever there is no Internet connection, this should be shown with an error message and an insensitive “Publish” button, exactly as for the sign-on dialog.

When you activate the “Publish” button, progress should be shown using a spinner and the text “Submitting review…” in the bottom leading corner, exactly as for the sign-on dialog.

review-submit-progress.jpg

Stopping and errors should similarly be handled exactly as for the sign-on dialog, but with the text “Couldn’t connect to the review service.” for HTTP errors.

review-submit-error.jpg

Submitting a review should send this information to the review server:

Review service

Presenting reviews

The median rating, and the number of reviews, for all items in a software source should be updated and cached whenever the Center updates the list of software in that source. The median rating, and the five most recent reviews, for an individual item should be updated and cached whenever you visit the screen for a software item and there is an Internet connection.

Throughout the “Get Software” section, a list view item should have at its trailing end a hyperlink consisting of stars for the median rating for the item, plus text of the form “17 reviews”. Activating the hyperlink should navigate to the software item screen and scroll to its “Reviews” section. In addition, text of the form “ (X stars from Y reviews)” should be present at the end of the item’s accessible description — for example, “An application for managing botanical collections (4 stars from 3 reviews)”.

item-row-available-unselected.jpg

When an item is being installed or removed, the progress bar in the list view should replace any rating/reviews link.

Similarly a software item screen should have in its top trailing corner a hyperlink of exactly the same form, which does the same thing. In the “Installed Software” section, this area should instead have a “Rate & Review…” button that begins the review process.

The software item screen in the “Get Software” section should also contain a “Reviews” section.

get-software-item-reviews.jpg

(Omitting reviews in the “Installed Software” section should discourage, without preventing, people from biasing their ratings and reviews based on the ratings and reviews already submitted. They can still refer to the same item in the “Get Software” section if they want to see the current ratings and reviews.)

In the “Get Software” section, an item that has any reviews in a software list view should have a link consisting of (a) stars representing the average rating and (b) light text of the form “7 reviews”. Activating the link should navigate to the software item screen and scroll to its Reviews section.

Flagging reviews as inappropriate

Below each review should be a “Flag” link. Activating the link should invoke the Ubuntu Single Sign-On authentication/registration process, if necessary, using the summary text “To flag a review as inappropriate, you need an Ubuntu Single Sign-On account.”. The dialog should also feature a “Just Hide It” button; activating this button should cancel the process, but Ubuntu Software Center should then also immediately hide the review and remember indefinitely that you do not want to see that review again.

review-report-sign-on.jpg review-report.jpg

Once you are signed in, a parent-less dialog should appear for flagging the review.

It should have a “Why is this review inappropriate?” menu with choices “Unspecified”, “Offensive language”, “Infringes copyright”, “Not about this software”, and “Other”.

The “Cancel” button should have Esc as its keyboard equivalent.

The “Flag” button should have Enter as its keyboard equivalent. It should be sensitive only if the reason is not “Unspecified” and you have entered text in the details field.

This dialog should handle progress and HTTP errors in the same way as the review dialog.

Single-pane department screen

department-3.0.jpg

Popularity

Purchasing software

History section

[foundations-lucid-software-center-history-of-packaging-transactions 1 of 1]

The “History” section should display all installations and removals, in reverse chronological order.

history.jpg

Below the navigation bar, a filter bar should have items for “All Changes”, “All Installations”, “Purchases”, and “Removals”.

Copying installations across computers

[implementation: contact DidierRoche]

see OneConf

“Where Is It?” button

GTK/Clutter hackers

In the screen for a graphical application in the “Installed Software” section, there should be a “Where Is It?” button. Clicking the button should:

  1. over two seconds, draw a ring around the menu (e.g. “Applications”) in which the application resides

  2. wait for you to open the menu
  3. instantly remove the previous ring
  4. over two seconds, draw a ring around the application, or around the submenu that contains the application
  5. wait for you to select the item or open the submenu
  6. instantly remove the previous ring, etc.

At any time, focusing another window or pressing any key should cancel the process and make any ring disappear.

As a less sophisticated solution, the menus and items should — for a few seconds — slowly throb in a different color.

Announcing newly-installed applications

Dragging installed applications from USC to a launcher

Features you can implement

These are mini-specifications for new features and other changes that anyone is welcome to implement for the Ubuntu Software Center. Some are more important than others; some are more difficult than others. If you would like to implement any of them, please do so in a branch and propose it for merging. Thanks! (Once a feature is implemented, the mini-specification here will similarly be merged into the main specification.)

Minimum pane sizes

The minimum width of the navigation pane should be just enough to display the icons of the top-level sections listed within it. How much is this, exactly?

The minimum width of the main pane should be 8 em.

Auto-sizing the navigation pane

Double-clicking the splitter between the navigation pane and the main pane should move it so that the navigation pane is exactly wide enough to fit the widest text currently being displayed in it.

Smarter ellipsis of software list view items

In a software list view, if the secondary text is wider than the space available, it should be ellipsized in the middle, not the trailing end (because unique parts of package names are often at the trailing end).

Copying software list view items to the clipboard

Whenever an item in a software list view is selected, “Edit” > “Copy” should be sensitive. Choosing it should copy to the clipboard the item’s title and summary as plain text separated by one line break. If the item has a custom icon, it should also be copied as both a bitmap and as a vector image if available.

Copying software item text to the clipboard

Whenever text is selected in a software item screen, “Edit” > “Copy” should be sensitive. Choosing it should copy the selected text to the clipboard.

Back and Forward menu items and keyboard equivalents

There should be Back and Forward actions, which the Back and Forward buttons (when present) should be linked to. All references in the specification to the Back and Forward buttons being sensitive or insensitive should be changed to refer to the actions in general.

The “View” menu should contain, at its end, a separator and two items:

---------------
  Go Back    [
  Go Forward ]

“Go Back” and the [ key should be linked with the Back action, while “Go Forward” and the ] key should be linked with the Forward action.

Add-on packages

add-ons.jpg

First: Package A should be treated as a recommended add-on of package X if either of these are true:

Package A should be treated as a suggested add-on of package X if any of these are true:

What about where X depends on a virtual package that A1 or A2 provide? Perhaps show a menu of the options? This applies not just to add-ons but to dependencies too. Also consider the possibility that installing A1 requires uninstalling something else, while installing A2 does not…

Next: If a software item has any add-ons, it should have an add-ons section in the place specified in its “Get Software” item screen or “Installed Software” item screen. If the item is not installed already, the section should have the heading “Choose add-ons”; if it is installed already, the heading should be “Change add-ons”.

The list of add-ons for the item should be presented as a series of checkboxes. The label for each checkbox should be a text-sized version of the add-on’s icon, followed by its title. Recommended add-ons should be listed first alphabetically, then suggested add-ons alphabetically.

If the main package is not installed already, the checkboxes for recommended add-ons should be checked by default, while the checkboxes for suggested add-ons should be unchecked by default. If the main package is installed already, the checkboxes for add-ons that are currently installed should be checked by default, while those that are not should be unchecked by default.

The “Total size:” text should update immediately whenever checking or unchecking a checkbox. For an item that is already installed, whenever the current state of the checkboxes is different from the installed state of the add-ons, the text should change from Total size: {amount} on disk ({amount} available)”:

If the main package is already installed, the “Total size” text should be followed by an action bar with “Cancel” and “Apply Changes” buttons. Both buttons should be sensitive only when the current state of the checkboxes is different from the installed state of the add-ons themselves. Activating “Apply Changes” should install and/or remove the add-ons as specified.

In the “In Progress” section, when installing an item, installing any of its add-ons should be presented as part of the same task. But changing add-ons for an installed item should be presented as a separate task for each add-on.

Next: Throughout the “Get Software” section, whenever the selected item in a software list view is an item that has add-ons, it should have a button to the left of the “Install” button: “Choose Add-Ons…” if the item is not yet installed, or “Change Add-Ons…” if it is. (The button should not have an access key, because that would interfere with typing letters to navigate the list.) The purpose of this button is to alert users that there are options they might want to consider before choosing to install the item. Activating the button should navigate to the relevant software item screen and scroll to its add-ons section.

[foundations-lucid-software-center-ui-improvements 7 of 7]

Opening an apt: URL should launch the Ubuntu Software Center directly to the appropriate screen; or if it is already open, focus it, wait until any currently-open alerts or dialogs have been dismissed, and then switch to the appropriate screen. What that “appropriate screen” is depends on the URL and installation status, as follows.

apt:package-name

apt:package-name?minver=1.0

apt:package1,package2,…

apt:package-name?section=multiverse

apt:package-name?channel=lucid-partner

Exactly the same appearance and behavior as for apt:package-name?section=multiverse, but enabling a whitelisted repository as listed in /usr/share/app-install/channels/, rather than a section.

Replacing apturl

When this feature is fully implemented, the software-center package should be marked as Replaces: apturl.

Date installed

installed-software-item-with-date.jpg

In the software item screen for an item that is installed, instead of just saying “Installed”, the bar containing the “Remove” button should say “Installed {date}”, e.g. “Installed 2008-10-04”.

Cancel bar in “In Progress” screen

At the bottom of the “In Progress” section should be a panel of the same general appearance as the location bar, but containing only a “Cancel All” button.

The “Cancel All” button should be sensitive only when any items have not yet started or are still downloading.

If you try to close the Center while an item is installing or being removed, as soon as the Center switches to displaying the “In Progress” section, at the left end of the panel containing the “Cancel All” button, this text should be displayed: “The Center will close when these tasks finish.” (The “Cancel All” button should retain its usual sensitivity and effect.)

Maybe a “Pause” button would be even more useful in this bar.

More informative text for waiting tasks

When you request to install an item and it is waiting for other tasks in the “In Progress” queue, its status text should be “Waiting to install”.

When you request to remove an item and it is waiting for other tasks in the “In Progress” queue, its status text should be “Waiting to remove”.

Whenever an item is selected in the “In Progress” section, “Edit” > “Copy Web Link” should be sensitive. Choosing it should copy a Web link for the selected package.

Animation of the main pane

GTK/Clutter hackers

Whenever you navigate from within the lobby screen to a department screen, over 0.5 seconds the left and right halves of the lobby screen should split in two halves sliding out of the pane to the left and right — like a pair of lift/elevator doors opening — to reveal the department screen underneath.

lobby-animation.jpg

When navigating from a department screen back to the lobby screen, the reverse should happen: over 0.5 seconds, the left and right halves of the lobby screen should slide in from their respective sides of the main pane, eventually covering the department screen.

GTK/Clutter hackers

Whenever you navigate from within a department screen to a software item screen, over 0.5 seconds, the icon of that package that was visible in the department screen should simultaneously zoom and move linearly to become the icon of the software item visible in the software item screen. At the same time, the rest of the contents of the department screen should linearly crossfade into the rest of the contents of the software item screen. Both of these effects should also happen when navigating the reverse direction, from the package screen back to the department screen.

Roadmap

October 2009

In Ubuntu 9.10, we shipped Ubuntu Software Center 1.0. This includes:

April 2010

For Ubuntu 10.04 LTS, we plan to:

October 2010

For Ubuntu 10.10, we plan to:

April 2011

For Ubuntu 11.04, we plan to:

Eventual scope

This is a tentative mockup of version 4:
future-lobby.jpg

And this is a laundry list of desired features, for the purpose of designing an interface for version 2.0 that will scale to include those features later. It is not a list of features scheduled for 2.0.

You should be able to:

User stories

Similar efforts

Yet-to-be-specified features

Launching via inserting an Ubuntu CD

The Center needs to be able to tell whether a CD containing packages is:

You should also be able to eject the CD from the navigation pane, just as you can eject a music CD from Rhythmbox’s side pane.

Launching via .deb package (replacing gdebi)

Launching via file of unknown type

The Center needs to be able to display applications that handle a particular filetype, i.e. an equivalent to gnome-app-install --mime-type text/html. (Maybe distinguish between file viewers and editors?)

Nautilus then needs to be able to launch the Center to this search.

Subcategories

Wine integration

License information

Developer tools

Eliminating the “{title} can’t be installed at the moment” alert

Instead of an impossible installation causing an alert saying “Sorry, {title}” can’t be installed at the moment. Try again in a day or two.”, the task should show its error status inline in the “In Progress” section somehow, and sit there across Center launches until you retry it or cancel it. The “In Progress” arrows would need to stop spinning for cases like this, because nothing is actually happening.

Unresolved issues

Unsorted ideas

SoftwareCenter/2.0 (last edited 2010-05-17 13:35:18 by eth0)