README for iDance

Authors: 
	* Charlie Hsu
	* Conor McLaughlin
	* David Zeng
	* Vidya Ramesh
	* Wei Yeh

Contact Information: 
	cs160-igroup@lists.berkeley.edu

Introduction: 
	iDance is a revolutionary iPhone and iPod Touch application that allows users to create clips of their native iPod Library songs and merge these clips together into dance routines. Music is an integral part of the dance process, but dancers often use music in specific ways that conventional music players do not address. We aim to address this problem and create an experience for dance choreographers and dance group leaders that they will never forget. 
	
Operating Instructions: 

	Creating A Clip: 
		The user starts off on the Songs Tab of the application and is presented with a list of the user's songs. The user then chooses a song for which the user wants to create a clip of. This leads the user to a new view, where they are presented with the option to create a new clip. When the user clicks on this button, a new clip is generated and they are brought to a view where they can edit the start and end times for the clip. This view also allows them to play-back the clip from the new start and end times as well as rename the clip. The user also has the option to either save the clip or to cancel the entire action of creating a new clip. 
		
	Editing A Clip: 
		The user starts off on the Songs tab of the application and is presented with a list of songs. The user finds the song that the clip belongs to and clicks on the song. This presents them with a list of the clips belong to the song, where the user can select the particular clip desired. The clip is then presented in its play and edit mode so the user can make the necessary changes to the clip. The start and end icons can be dragged anywhere within the song and the values for the clip are updated accordingly. The change is saved automatically. 
		
	Creating A Routine: 
		The user starts off on the Songs Tab of the application and is presented with a list of the user's songs. The user must then click on the Routines tab of the application. The view presented contains all the routines that already exist as well as the option to add a routine on the upper left corner of the view. Clicking on that brings the user to the new routine where the user can add clips to the routine, edit the routine, rename the routine, as well as play the clips in the routine. The routine is currently named "Unnamed Routine", but the user has the option of changing the routine name. 

Limitations of Current Version: 

	Creating favorite clips and routines
		We omitted this because designating "favorite" clips and routines was more of a bonus usability feature than a task-critical feature. The user can still access songs and routines relatively quickly, even without the convenience of the Favorites page.

	Repeat and prompt-to-play functionality
		Playback of clips and routines is important, and enhanced features such as repeat and prompt-to-play were important features to our experimental users, but we felt these were supplemental convenience features whose absence would not detract from the core utility of the application.

	Persistent data storage 
		This functionality was omitted in particular with regards to the Clip data type that we support in our application. The routines are persistent and stored across uses of the application if they do not contain clips, but the clips within them must be recreated during each use. Therefore the routines with clips are not saved. 

	Routine play-back
		This functionality is the ability to play a routine so that all the clips are played in the correct order, immediately one after another. Since we already decided not add persistent data storage of the clips, it seemed logical to also leave this functionality for the next iteration. 

	General aesthetic and graphic design
		General aesthetic design was very limited, and we hope to create more eye-friendly color schemes/interfaces in the next few iterations. 

Images:
	We do not claim any ownership of the images used within this application. All the images for the tab icons are from http://glyphish.com/ and the initial image representing this application is from http://danceaa.org/mitsi%20dancing%20school.jpg. 
	
Usage License:
	This application is licensed under the MIT License (also known as the X11 license). 
	Details about the license can be found here: 
	
	Copyright (c) <2010> <Charlie Hsu, Conor McLaughlin, David Zeng, Vidya Ramesh, Wei Yeh>

	 Permission is hereby granted, free of charge, to any person
	 obtaining a copy of this software and associated documentation
	 files (the "Software"), to deal in the Software without
	 restriction, including without limitation the rights to use,
	 copy, modify, merge, publish, distribute, sublicense, and/or sell
	 copies of the Software, and to permit persons to whom the
	 Software is furnished to do so, subject to the following
	 conditions:

	 The above copyright notice and this permission notice shall be
	 included in all copies or substantial portions of the Software.

	 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
	 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
	 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
	 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
	 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
	 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
	 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
	 OTHER DEALINGS IN THE SOFTWARE.