Hendrix Test Plan

• Philips SA5285 (8GB)
• Philips SA5245 (4GB)
  
• Sansa e260 (4GB)
• SanDisk Fuze (4GB)

Updates (using an 1.0.0 profile)

• Verify 1.0.0 final > 1.1.0rc1
• Re-verify from 1.0.0 final for any subsequent 1.1.0rc builds
• Verify 1.1.0rc1 > 1.1.0rc2
• Verify subsequent rc upgrades as required
• Verify 1.0.0 final >1.1.0 final

Updates must be verified as working within one week of code complete.

Install Types

Installation testing scenarios will include:

• Partials: Updates using snippets instead of complete downloads.
• Complete: Updating from an older version which downloads a 'complete' mar file (i.e. 1.0.0 > 1.1.0)
• Fallback: Replacing the string from pending to 'failed' in the update.status file. Restart the app and ensure user gets another copy of the update.

First Run Bundles

First run Add-Ons for 1.1.0 will be the following, in this order:

Language Support

The following foreign languages will be tested to ensure that they load/view correctly:

• French (France)
• Italian (Italy)
• German (Germany)
• Spanish (Spain)
• Chinese (China)
• Japanese (Japan)

Preferences

songbird.metadata.artwork.enableWriting (default: true)

• When set to true, Songbird will attempt write any artwork it locates to the headers of the associated mp3 track.
• When set to false, Songbird will not attempt to write artwork to the headers of any mp3 tracks.

songbird.albumart.file.base_names (default: cover,folder)

• The Local Filesystem Fetcher will look for artwork in files with any one of the names specified in this preference (when combined with the songbird.albumart.file.extensions preference).

songbird.albumart.file.extensions (default: jpg,jpeg,png,gif,bmp,tif,tiff)

• The Local Filesystem Fetcher will combine these extensions with the file names in the base_names property to create the list of filenames it will search for.

songbird.albumart.maxsize (default: 16777216)

• The maximum size, in bytes, for an album artwork image.

songbird.albumart.file.enabled (default: false)

• Enable or disable the File fetcher.

songbird.albumart.file.priority (default: -1)

• The priority of the File fetcher.

songbird.albumart.metadata.enabled (default: true)

• Enable or disable the Metadata fetcher.

songbird.albumart.metadata.priority (default: 0)

• The priority of the Metadata fetcher.

songbird.albumart.lastfm.enabled (default: true)

• Enable or disable the Last.FM fetcher.

songbird.albumart.lastfm.priority (default: 1)

• The priority of the Last.FM fetcher.

Priorities

• Priorities are ordered from lowest number to highest, so a fetcher with a priority of 1 will be used before a fetcher with a priority of 5.
• A priority of less than 0 indicates that there is no priority for the fetcher, commonly we will use -1 to indicate this. A fetcher with this priority will be appended to the end of the fetcher list.

Track Metadata Fetcher

• Images already embedded in a track's metadata will be located and used as the track's art. 
• Songbird will not look any further for art if it is located in the track.
• Songbird will look for art marked as "front cover" ($03) or "other" ($00). Any other embedded art will be ignored.
• If artwork is found for both "front cover" and "other", the "front cover" art will be the art used by Songbird.
• If artwork is found in "other" ($00) and the enableWriting preference is set to true, Songbird will add another copy of the cover art to the track and mark it as "front cover" ($03) data.
• Songbird does not enter a failure mode when encountering corrupted data in an APIC tag.
• If the Fetcher does not locate art in the track metadata, the next Fetcher will begin searching for art.

Local Filesystem Fetcher

• The Local Filesystem Fetcher is not used by default to find artwork, it must be enabled to allow it to be used during a scan. This is because we get unexpected results when a user does not have an organized library on the file system.
• Using the comma-delimited values in the songbird.albumart.file.base_names preference as one set and the comma-delimited values in the songbird.albumart.file.extensions preference as another set, the Local Filesystem Fetcher will search through the Cartesian Product of the two sets to find a matching file, i.e.
  
  {cover,photo} x {jpg,png} = {cover.jpg,cover.png,photo.jpg,photo.png}
   
• The Fetcher will stop searching for artwork when it locates a matching filename with valid artwork.
• Found artwork will be written to an APIC tag in the track's id3v2 header with a type of $03 (front cover).
• The Fetcher will continue searching for artwork if it locates a matching filename with invalid artwork.
• Songbird does not enter a failure mode when the Fetcher locates a matching filename with invalid artwork.
• If the Fetcher does not locate art in the track metadata, the next Fetcher will begin searching for art.

Last.FM Fetcher

• The Last.FM Fetcher will be used by default if artwork is not found using the Metadata Fetcher.
• We use the Last.FM REST api to locate a tracks artwork under the track.getInfo method. This method is not a write method so we do not require the user to log into thier Last.FM account.
• The Fetcher will search the images returned in the following order ['Large', 'Medium', 'Small'] and stop searching for artwork when it locates a url to an image.
• The Fetcher will download images it finds to the profile cache folder, if this fails then the search fails and it will move on to the next fetcher.
• If the Fetcher does not locate art online the next Fetcher will begin searching for art.

---

TXXX ID3v2 header (mp3)

foobar2000 stores Replay Gain information using the id3v2.3 TXXX field.

replaygain_album_gain (lower numbers = softer playback)
replaygain_album_peak
replaygain_track_gain (lower numbers = softer playback)
replaygain_track_peak

See also: TXXX (user-defined text information frame, see section 4.2.6 at http://www.id3.org/id3v2.4.0-frames)

Vorbis comments (flac, ogg)

vorbisgain, flac 1.1.3, and probably other encoders/Replay Gain calculators store Replay Gain information for Ogg and FLAC files in Vorbis comments fields.  The fields are the same as those for mp3s, except in all caps:

REPLAYGAIN_TRACK_GAIN
REPLAYGAIN_TRACK_PEAK
REPLAYGAIN_ALBUM_GAIN
REPLAYGAIN_ALBUM_PEAK

It appears that there are deprecated tags named RG_RADIO, RG_PEAK, and RG_AUDIOPHILE.  These are probably not implemented and will not be tested.

The source code for vorbisgain defines NO_PEAK as -1.f and NO_GAIN as -10000.f.  It appears that values greater than the NO_PEAK and NO_GAIN are valid peak and gain values.

All of these assumptions are based on the source code found here: http://sjeng.org/vorbisgain.html

ID3v2.* Relative volume adjustment tags (RVAD/RGAD/XRVA/RVA/RVA2)

RVA: Implemented in id3v2.0.  Allows per-channel relative volume adjustment for the left and right channels only.

RVAD: Implemented in id3v2.3.  Allows per-channel relative adjustment for left, right, center, left back, right back, and bass channels.  Testing will only cover adjustments to the left and right channels.  See Section 4.12 of the id3v2.3.0 specification at http://www.id3.org/id3v2.3.0#head-d3...2bb676653d3604.

RGAD: Labeled as an "Unofficial Frame Seen in the Wild" by id3.org.  See http://www.id3.org/Replay_Gain_Adjustment and http://replaygain.hydrogenaudio.org/...mat_id3v2.html.  If this is in use in the wild, its prevalence is very limited.

XRVA: Labeled as an "Unofficial Frame Seen in the Wild" by id3.org.  See http://www.id3.org/Experimental_RVA2 and http://normalize.nongnu.org/.  This tag is created by the normalize program and is used to back-port RVA2 data from id3v2.4 tags to id3v2.3 tags.

RVA2: Implemented in id3v2.4.  See section 4.11 of http://www.id3.org/id3v2.4.0-frames.

LAME header information stored within the Xing tag

Replay Gain information can also be stored within a LAME header inside an Xing header.  The authoritative page seems to be this one: http://gabriel.mp3-tech.org/mp3infot...tml#replaygain.

iTunes Sound Check

Songbird will use iTunes Sound Check information, when available, to normalize playback volume.  iTunes stores Sound Check data inside an id3v2.2 COMM (comment) tag using the tag iTunNorm.

---

Testing of Special Rules

In addition to the introduction of Unicode Collation, Songbird will begin omitting certain characters and words when sorting.  Testing will ensure that the following characters/words, when appearing at the beginning of a name, do not determine the sort order of that particular item:

• From English: the words "A", "An", "The" (case-insensitive)
• From French: the words "Un", "Une", "L'", "La", "Le", "Les" (case-insensitive)
• From Spanish: the words "El", "La", "Los", "Las", "Un", "Una", "Unos", "Unas" (case-insensitive)
• From German: the words "Der", "Die", "Das", "Ein", "Eine" (case-insensitive)
• From Italian: the words "Lo", Il", "L'" (also in Fr), "La" (also in Fr), "Gli", "Un" (also in Fr), "Una", "Un'" (case-insensitive)
• From Portugese: the words "O", "A" (also in En), "Os", "As", "Um", "Uma", "Uns", "Umas" (case-insensitive)
• Punctuation characters
• Whitespace characters

Items beginning with digits should sort numerically.  The exception to this rule is negative numbers; items beginning with a negative number will sort as though the number is positive.

Secondary Sort

Secondary Sort rules determine how items in the library are sorted based upon which column is the Primary Sort column.  See the Secondary Sort Column Rules section of the Hendrix Sorting feature document for a full list of secondary sorting behavior.

Unicode Collation Testing

Code charts from Unicode should be used to test correct sorting.  Note that we are using OS-specific implementations of the Unicode Collation algorithm, so sorting should be tested thoroughly on all Tier 1 platforms. The test effort should cover the following:

Unicode Collation Charts for English, French, German, Italian, and Spanish:
Basic Latin
Latin-1

Language-specific Collation Charts (locale-specific subsets of Latin and Latin-1):
English: http://developer.mimer.com/charts/english.htm
French: http://developer.mimer.com/charts/french.htm
German: http://developer.mimer.com/charts/german.htm
Italian: http://developer.mimer.com/charts/italian.htm
Spanish: http://developer.mimer.com/charts/spanish.htm

Unicode Collation Charts for Japanese:

Hiragana
Katakana

Unicode Collation Chart for Chinese and Japanese:

CJK Unified Ideographs

In addition to the Tier 1 Languages, the community has expressed gratitude for the fact that Songbird sorts Hebrew and Cyrillic properly.  A spot-check should be performed on these languages to ensure we didn't regress.

Hebrew
Cyrillic

N.B.: The Swedish language will be a good way to quickly verify that locale-specific sorting is occurring, because the characters å, ä, and ö should be sorted at the end of the alphabet.  See http://developer.mimer.com/charts/swedish.htm for a full Swedish collation chart.

Product Impact

Search: Songbird's library search functionality currently piggybacks off of the existing sorting data.  We should expect search to be affected by the modification to the existing sorting data.

Database: Part of the upgrade from the 1.0 product will be a database migration that updates the existing sorting data. See bug 14271 for details.
 

---

Invoking Songbird from URLs Project Page

---