8306

Sync it!

When Songbird syncs, it should transfer media items (music and video), playlists, media list ordering, and media list sort ordering.

Music files should go in the appropriate location in the device and so should video files.

Media items that have completed transfer should appear in the device where ones in progress or in queue should not. (Experiment with adding style to the row later)

Sync metadata to device metadata under the hood

All metadata that is transfered between Songbird DB and the device DB should happen without any status display to the user. If the user wants to update the metadata on file for media items on the device then they need to trigger a sync.

NOTE: Maybe enhance this in the future, somehow.

8317

8318

8320

8321

8323

8324

Multiple ways to trigger and cancel a sync

Both the user and system can trigger a sync:

• User:
  • click [Sync] button in summary page progress display widget
  • select "Sync" in device node contextual menu
• System:
  • when sync settings are saved - where "Sync" is selected
  • sync source media list definition has changed
  • metadata for media items contained in the sync source media list has changed
  • when a device is connected and the sync settings is set to "Sync"

Questions: Do we need a timer or something for this? Is there a problem if every little change is reflected in the device atomically?

Maybe wait n seconds for a command before grouping it as a unit of transaction?

User can cancel sync:

• User:
  • click [Cancel] button in summary page progress display widget
  • select "Cancel $(action)" in device node contextual menu

Service Pane Contextual Menu Wireframe

Multiple ways to trigger and cancel a manual file transfer

Both the user and system can trigger a sync:

• User:
  • drag media items from a media list to the device node, device library, or device playlist, or media view
  • drag media items from OS to the device node, device library, or device playlist, or media view
  • contextual menu item - "Add to device" - from the main library or playlist

User can cancel sync:

• User:
  • click [Cancel] button in summary page progress display widget
  • select "Cancel $(action)" in device node contextual menu

Service Pane Contextual Menu Wireframe

Daisy-chain sync/transfers smartly

Need to talk to engineering to see what the "smartly" means...

NOTE: This happens now - test to see if implemented behavior is ok.

Songbird should deal with requests for transfer/sync that are submitted during a transfer/sync in progress...

Transfer album art so that the device can display it

Transfer whatever artwork Songbird has for the media item and transfer it to the device.

DEPENDENCY: Songbird needs to support album art before this story can be worked on.

QUESTION: Do we have the ability to detect what image file format a given device supports and not transfer if the one in the DB is not supported?
ANSWER: I think we have enough information (at least for MTP), but do not know how easy it would be to hook up. --Mook 23:40, 13 March 2008 (PDT)

8325

User is able to configure how Songbird manages the device through an iTunes-like interface in the device summary page

"Sync" and "Manually manage" are mutually exclusive.

"All music, video, and playlists" and "Selected playlists" are only enabled when "Sync" is selected.

"All music, video, and playlists" and "Selected playlists" are mutually exclusive.

A list of all playlists - excluding the "Web Media History" and "Downloads" - should be selectable by the user as sources for device sync. The selection made by the user should be saved even if the configuration does not use the selection.

• [Cancel] Should revert any changes made between the last time changes were committed to the time when the [Cancel] button was clicked.
• [Save] If either the "All music, video, and playlists" or the "Selected playlists:" options are selected then Songbird should kick off a sync immediately.

If a factory setting device is connected to Songbird then Songbird should select the "Manually manage" settings.

If a device that Songbird recognized for the first time is connected then Songbird should select the "Manually manage" settings.

Wireframe

Progress status are reflected through strings, better

The progress display widget has 3 strings - the summary message, the detailed message, and the button label. These strings should update to reflect the state of sync/file transfer.

If the sync/transfer completes with errors then the user should be able to view details about the error in the form of a dialog that is invoked from the progress widget's summary message.

Table of strings and statuses

Addition of a button that invokes sync

User is able to invoke a sync manually by clicking a button in the progress display widget.

NOTE: Maybe this is not useful - I'm told it's easy to implement so lets and remove it if there is no value in it.

Wireframe

The progress display widget should not wiggle

Currently the widget wiggles when it is asked to display messages that are longer than the width of the progress bar. Let's set a static width to the progress bar and labels. The labels should crop the strings they display at the right side. A tooltip should appear when the user hovers over a cropped string.

Wireframe

Confirmation dialog if device not empty

If a sync is triggered but the device contains music, video, or playlists that will be deleted by the sync then the "Sync Confirmation" dialog should be displayed.

• If [Yes] then the Songbird should go ahead with the sync.
• If [No] then Songbird should take no action and select the "Manually manage" setting.

Wireframe

Auto-generate a playlist containing a random selection of media items if not enough free space

If a sync is triggered but the sum of file size of the media items in the sync source is more than that of the device then Songbird should display the "Insufficient free disk space" dialog to prompt the user for action:

• If [Yes] is chosen then Songbird should create a new playlist titled "$(device display label) playlist" which is filled with a random selection of media items from the main Library. Songbird should then automatically set "Sync" mode to "Selected playlists:" and select the newly created playlist. Finally, Songbird should kick off a sync.
• If [No] then Songbird should take no action and select the "Manually manage" setting.

Wireframe

Confirm sync if device is coupled with another Library

If sync is invoked but the device is the sync destination of another Library then a "Sync confirmation" dialog should be displayed.

• If [Yes] then sync should be performed. Songbird should create some coupling between the device and the Library for future use.
• If [No] then Songbird should take no action and select the "Manually manage" setting.

If the user

1. configures the device to sync with Songbird
2. disconnect device
3. edits the contents of the device using another media player
4. reconnects device to Songbird

...then...

1. Songbird should change settings to be manual mode
2. Songbird should invoke sync which will display the confirmation dialog

Wireframe

Display prompt when device does not have enough free space for manual transfers

If a manual media item transfer is triggered but the sum of file size of the media items in at the source is more than that of the device then Songbird should display the "Insufficient free disk space" dialog to prompt the user for action:

• If [Yes] is chosen then Songbird should transfer as much of the files as possible. The order of media items should be defined by the media list that is the source.
• If [No] then Songbird should take no action.

Wireframe

A single error dialog for all transfer errors

Modify the "Incompatible files detected" dialog to make it a more generic dialog that can handle all sorts of errors that are collected during file transfers. This dialog is accessible from the "errors" link in the progress display widget.

Wireframe

Maybe f there are any errors then the dialog should automatically display after transfer is complete? (this might be super-annoying) Maybe add a "[x] tell me next time" option to the dialog? (this adds the requirements for a [Reset warning messages] button somewhere)

Dialog for when user tries to close Songbird while the device is busy

If the user tries to close Songbird (or if Songbird tries to close tiself) then a confirmation dialog should appear to ask if the user would like to:

• Cancel all transfer and quite Songbird
• Continue with transfer and cancel quitting Songbird

TODO: Wireframe pending.

Read-only mode for playlists/libraries

If "Sync" is set then any playlists and libraries under the device node should be in read only mode. Read only mode means:

• "Remove", "Edit", "Add to playlist" are disabled in the contextual menu
• Media items can not be dragged and dropped to the node
• Media items can not be reordered through drag and drop (defined by the source media list)
• Tree headers can not be reordered (defined by the source media list)
• Tree headers can not be clicked to change sort order (defined by the source media list)
• Metadata editor can be invoked but displays in read-only mode
• Media items can not be dragged and dropped to the media view loaded in the content pane

Wireframes

Transferring media item(s) from the main Library and playlists to a device via contextual menu

The user is able to transfer selected media item(s) in the main Library to devices via a contextual menu.

The contextual menu should list all devices recognized by Songbird. If no device is connected to Songbird then the menu item should be disabled.

Note: It's going to be difficult to implement this while we have the new and old device API. Let's revisit when we have deprecated the old APIs. Aus said this is stupid easy!

Wireframe

Display generic device type specific icons when the device does not provide an icon.

We have the ability to detect 5 unique device types:

• Generic
• Camera
• Media Player
• Phone
• Video
• PIM (Personal Information Manager)
• Audio Recorder

Feathers should include icons for each device type so that if the device does not provide an icon for itself then Songbird should displays these in the summary pane and in the service pane. See Windows for examples.

Refine visual design of device summary page

Spiff up the visual design of the summary page. See discussion about visual design for details

DEPENDENCY: Can't do much till the summary page and all assets/CSS are migrated to core/feather.

Communicate "in transit" state at a media item level

Media items that are scheduled to be transfered should be styled the same.

The media item that is being transfered should be styled.