Document Sample
documentation Powered By Docstoc
					MIT Player User‟s Guide
     Written by Neil Rosen

                   Table of Contents
3.    Main window view                         27.   Choosing Country or Choreographer Display
4.    About this Program                       28.   Determining Program Finish Time
6.    Program Requirements                     28.   Setting Between Dance Pause Time
6.    Legal Mumbo Jumbo                        29.   Saving Dances to Your Favorites List
7.    Installation of the Player Software      29.   Selecting Dances From Your Favorites List
9.    First Use of Player                      30.   Viewing Other Programmers Favorites Lists
10.   Normal Use of Player                     31.   Editing Your Favorites List
11.   Queuing Dances                           32.   Teasing Dances
12.   Un-queuing Dances                        33.   Teaching and Announcement Stops
13.   Limiting Search to Certain Repertoires   34.   Using a Dance Floor Display CRT or Projector
14.   Searching by Country or Choreographer    35.   Configuring Your Player
15.   Defining Country Hierarchies             39.   Editing a Dances Database Parameters
16.   Searching by Last Play / Taught Date     41.   Renaming or Moving a Music File
16.   Searching by Choreographed Date          42.   Adding Individual Dances to the Player
17.   Queuing a Dance for Teaching             43.   Adding a Group of Dances to the Player
18.   Searching by Complexity / Energy         44.   Using the Playlist Editor and Auto-play Feature
19.   Searching by Type / Style                47.   Using the Database Health Check Utility
20.   Searching by Name or Substring           48.   Playing Tracks From CDs
21.   Exiting the Player                       49.   Generating Frequency Counts
21.   Saving Session Playlists                 50.   Using the Magic Programmer
22.   Setting Preferred Versions of Dances     53.   Saving Tone Presets
22.   Quick View of Database Values            53.   Adjusting the Tone Control.
23.   Duplicate Dance Warning                  53.   Deleting Tone Presets
24.   Player Controls                          53    Histograms
26.   Documenting Live Music in Playlist       55.   Tabular View of Database
26.   Swapping 1 Playing Dance for Another     56.   Editing Database Parameters in the Tabular View
                                               59.   Registering the Player
Main Screen        Played dances       Player Controls    Repertoire Selector     Finish Time

                                                                                    Set Time


                                                                                    By Name
                                                                                    or Sub-


Queue    Holding Area              Search Results               Search Criteria
dances                                                                                  3
         Pop-up info on mouse-over dance                 Record Teaching Date
                About this Program
This program will allow you to run your dance session while maximizing your time
on the dance floor. No more searching through multiple directories to find just the
right dance for the level of your dancers. With just a few clicks, you can find exactly
the dance you are looking for. Search by speed, complexity, type, style, country,
choreographer, choreographed date, last played date, last taught date, comments, and
alphabetically. Dances that match your selections are displayed for easy queuing.
Simply drag the dance from the search window into the program window. The player
software remembers your preferred volume and speed settings of each dance and also
allows changing these during a dance session. Once adjusted, you will never have to
run back to the computer to lower the volume on a particularly loud dance. You no
longer need to write each dance in your log book. Each session‟s playlist is saved to a
computer file and can be later printed or combined with other playlists to produce
frequency counts. The player allows you to queue dances for teaching. When a dance
is queued for teaching, the player will automatically stop, saving you the trouble of
leaving the dance floor to stop the player yourself. Read on for many more features.
                                             Aside from the initial setup of the MIT
                                             Player, the only work you must do to use
                                             this software is to convert your music into
                                             digital format (make mp3s etc.) and build
                                             your database. The more accurate your
                                             database is, the more useful the player
                                             features will become.
                About this Program
I wrote this program immediately after learning Visual Basic in order to practice some
of what I learned. I never expected it to turn into such a large program and I never
expected it to turn into something anyone else might want to use. This program
contains no bugs. It may however contain unfortunate consequences of the fact that I
was up many nights until way past 2:00 AM trying to make one feature or another
work properly. This program is my gift to the MIT Folkdance Club. Any one else
that would like to use it may do so for free but if you are still happy with it after using
it for 6 months, it would be nice if you would send me $35. Receiving some cash will
make me less sad that I missed so much sleep writing the program. Registration of the
program is free. The code number that I send you after registration will eliminate a
few use restrictions. The program comes "As Is" and is definitely not intended to
look or function like a professionally available software package. I cannot promise to
fix any bugs you find but I would be interested in hearing about them. I will also
consider some feature requests as long as they do not require major coding . Due to
being very over extended, I must reserve the right to refuse to make changes.
                                            If you would like to send money go to
                                   and click on the send
                                            money link. You will have to sign up or log
                                            into the paypal site. Use
                                   as the recipient‟s e-
                                            mail address. You can also e-mail me at the
                                            same address to learn where to send a check.
Program Requirements
Visual Basic runtime files (available for free from Microsoft)
Two additional .dll files from (I have paid Un4seen so
that I can distribute those .dll files with this this shareware MIT Player)
DirectX 8.0 or higher (available for free from Microsoft)
PC running Windows (not NT)
250MHz processor or faster (faster preferred)
Enough disk space for the this software, the Visual Basic runtime files
and all of your .mp3 files.

        Legal Mumbo Jumbo
        Though I am not expecting anyone to have any of these problems,
        use of this software is completely at your own risk. This includes
        any damage to hardware, other software, wasted time, wasted effort,
        money lost, or health problems associated with the installation, use
        or misuse of this program. It is your responsibility to have legally
        purchased all music used with this software. This software does not
        turn CDs into .mp3 or any other type of music file.
       Installation of the Player
       There are two ways to install this player. You may either copy the .exe and .dll
       files into a directory of your choosing or you may run the MIT_setup.exe file. In
       either case, you will need to have DirectX 8.0 or higher installed on your computer.
       Many computers already have DirectX. When you run the MIT Player, you will
       be informed if you need to install DirectX.

       If you are installing with the MIT_setup.exe file:
       1)   Download the MIT_setup.exe file the setup.lst file,
            and the MIT Player.CAB files to your desktop.
       2)   Double click the the MIT_setup.exe file .
       3)   Follow the instructions given by the install software.
       4)   When you first run the player,you may be informed if you need
            to install DirectX. If so, go to the website listed below and
            follow the directions there to install it.
       5)   If you have successfully installed the player, skip the next page.
Directx 8
    Installation of the Player
    If you are installing the MIT Player.exe and the .dll files yourself:
    1)    Make a directory in the c:\Program Files directory called mit_player
    2)    Copy the MIT Player.exe, bass.dll and basscd.dll files to this directory.
    3)    Add the Pictures sub-directory as well as the favorites directory.
    4)    The directories I have called Sunday and Wednesday could be anywhere you
          want and named anything you want (One file for each of the two databases.
          These are used for storing session playlists.). Your setup screen will direct the
          program to them.
    5)    Do not worry about the mit_player.ini file or the two dance_data.txt files. The
          software will create these for you when begin using the player.
    6)    If you do not already have the Visual Basic6.0 runtime files, go to the website
          listed below and follow the directions there to install them.
    7)    When you first run the player,you
          may be informed if you need to
          install DirectX. If so, go to the
          website listed below and follow
          the directions there to install it.
VB runtime:;en-us;q192461
Directx 8                                                                                     8
First Use of the Player
The first time you launch the MIT Player by double clicking on the
MIT Player.exe icon you will be informed that there is no mitplayer.ini
file. This is because you need to set your preferences in the program.
Click the OK button on the message box and you will be taken directly
to the main screen, skipping the splash screens.

Once the main screen appears, go to the
Options menu and select Setup Screen. From
the window that appears, you can configure
all of the search buttons and other behaviors
of the MIT Player software See the section
describing use of the Setup Screen window
later in this manual.

The information on the following page describes the use of this program
after configuring the program using the Setup Screen
Double clicking on the MIT Player.exe icon launches the splash screen.
A button will appear for each programmer whose name has been added on the
setup screen. A maximum of 16 programmers may be specified. When exiting the
                                    player, the programmer‟s (person choosing
                                    the sessions dances) name is stored in the file
                                    containing the current session‟s dances along
                                    with the session start time and session finish
                                    time. Selecting a programmer changes the
                                    splash screen which now displays two
                                    buttons. Each button opens a completely
                                    independent database.

The two databases might be used by a group
that sponsored International dance and Contra
dance and there is very little or no overlap of
dances between the sessions. The captions of
the buttons may be set from the setup screen
choice under the options menu on the main
program screen.
Queuing Dances
                                                    Dances in the Program
                                                    window (1) are automatically
                                                    played in the order displayed.
                                                    Dances may be dragged to
                                                    the Program from the Holder
                                                    window (2) or the Selector
       1               2                 3          window. (3) Dances may also
                                                    be queued in the Program
                                                    window by single clicking on
                           4                        the box (4) which is next to it
                                                    in the Selector window.
                                                    Note: When dragging and dropping
                                                    anywhere in this program, the cursor
                                                    must be over the drop target.

Dances you are thinking about playing but are not sure about may be dragged from
the Selector window to the Holder window. They will remain there until dragged
to the Program window or unprogrammed. All dances taught in the last „N‟ weeks
can be added to the Holder window at once by clicking on the Recently Taught
Button (5) at the top of the Holder window. A maximum of 29 dances may be
queued in the Holder windows at one time. The program can hold 229 dances, but
only the top 29 are visible. Dances can be dragged up or down in either window to
reorder them. The dance name will follow the cursor when a dance is dragged.
Un - Queuing Dances
                                                              A dance may be
                                                              deleted from the
                                                              Program (1) or
                                                              Holder (2) window by
                                                              dragging it back to the
       1                2                      3              Selector (3) window.

                                                              The entire Program (1)
                                                              or Holder (2) window
                                                              may be cleared by right
                                                              clicking on the word
                                                              Program or the word
                                                              Holder. Confirmation
                                                              will be requested.
Dances may also be deleted from the Program (1) window by right clicking
on the dance (name will turn to bold typeface) and pressing the computer‟s
Delete key. A block of dances may be deleted from the Program (1) window
by right clicking on the first dance to be deleted and Shift – right clicking on
the last dance to be deleted. Again, hit the computer‟s delete key to delete the
block. The same is true for the Holder (2) window.                               12
Limiting Dance Searches to Certain Repertoires
                                          All dances are displayed in the Selector for each
                                          repertoire (6) checked. Dances may be included in more
                                6         than one repertoire. If no repertoire is selected, all dances
                                          in the database are displayed in the Selector window. The
                                          Repertoire chooser is useful if you run several nights of
                                          dancing and need to limit the dances displayed to a subset
                                          or several subsets of the entire database. The repertoire
                                          selections can be changed in the middle of the session.
                                          Right click on a dance in the selector to add or delete a
                                          dance from a repertoire category. Check the repertoires
                                          desired on the screen which appears.
                                          The repertoire selector names are changeable by selecting
                                          Setup Screen from the Options menu on the main screen.

                                          Note: Dances in the database might not have any repertoires specified. If this is the
                                          case, they will only show up in the Selector when none of the repertoires are checked.

One might have repertoire categories such as Sunday Session, Wed Session, Simcha
Dances, International, Israeli, Contra, English, etc.
Note: Only two Repertoire selectors are available until the program is registered. You may still associate any dance with any
of the 8 repertoires, but you will only be able to select the first two of them. After registration, all 8 repertoires retrievable.
Search for dances by Country / Choreographer and Time Period
                   7                   Click the drop-down tab to select from a list
                                       of countries (7). Only dances from the
                                       selected country are displayed in the Selector
                                       (3) window. The number of matching dances
       3                               is displayed at the top of the Selector window.
                                       New countries are automatically added to the
                                       drop-down as dances from additional countries
                                       are added to the database. One country per
                                       line. Clicking the All Countries radio button or
                                       selecting ALL from the drop-down will reset
                                       the selector to to display dances from all
                                       countries. The country selector is also reset by
                   8                   clicking on the Clear All Selections button at
                                       the bottom of the search panel.
The choreographer selector (8) works the same way. When more than one search
criteria is used, only dances that match all criteria are displayed in the Selector
Both of these selectors can scroll directly to items starting with a certain letter by
pressing its key on the computer keyboard. Pressing that key multiple times will
scroll through all choices starting with that letter.
Country Hierarchies
Regions may also be added to the country drop down
selector. All dances whose country is in the defined region
will appear in the selector window.
To add new regions, select Country Hierarchy from the
options menu. The screen below will appear. Select a row.
It will turn white. Enter a region name. Use the dropdown
selector at the far right to add countries to the region.

                                                         To remove a country from
                                                         a region, simply backspace
                                                         over it. To remove the entire
                                                         region, delete all of the text
                                                         from the region and the list
                                                         of countries in region fields.

                                                         When done, click the
                                                         Save Hierarchy button.
Search for Dances by Last Play/Taught Date or Choreographed Date
                                      To search for dances by when they were last
                                      played or taught, type a number into the text
                                      boxes (9) . The MIT Player automatically
                                      remembers the last played date for a dance.
                                      The MIT Player can assume a dance was taught
                                      if it is played two or more times in one 24 hour
                                      period. (Check the check box on the setup
                                      screen window). Taught dates can also be set
                    9                 by queuing the dance via dragging if from the
                                      selector window to the Queue for Teaching
                   10                 window (11). This will cause the dance to be
                                      displayed in the Program window (1) as well
                                      as insert a STOP before it. Finally, the last
                                      taught date can be edited by right clicking on a
                                      dance in the Selector (3) window.
   Choreographed time periods are specified using the horizontal sliders (10).
   Only dances whose choreographed dates are between the “From” and “To”
   values will be displayed in the selector window. The max and min values for
   the sliders is specified by selecting Setup Screen from the Options menu. The
   Time Period search is disabled unless the Use specified range box is checked.
Queuing a Dance for Teaching

                                    When dances are dragged to the Drag
                                    Dance Here to Queue for Teaching box (11).
                                    from the Selector (3). or Holder a STOP will
                                    be dropped into the Program queue.
                                    Immediately following the STOP, the dance
     3                              to be taught will be dropped into the
                                    Program queue. Finally, the dance‟s taught
                                    date will be updated to the current date. A
                                    dance may also be dragged to this box from
                                    the Program queue. The dance will be
                                    queued as described above, but in this case, it
                                    will be removed from its original location in
                                    the queue.

Note: In the rare instance that the Program queue is full when a dance is dragged
to the Drag Dance Here to Queue for Teaching box, the last two dances in the
Program queue will be pushed down into the invisible part of the queue. The dance
that was selected to be taught will be dropped into the queue preceded by a „STOP.
It is done this way because it is assumed you will want to drag this dance and its
associated stop to a point higher in the Program queue. As dances are played, the
dances in the hidden part of the Program queue will reappear automatically. 17
Search for dances by Complexity or Energy Level

                            Search for dances by complexity or energy
                            level. Click the radio buttons (12). to select
            12              from easy, medium, or difficult for
                            complexity or low, medium-low, medium,
    3                       medium-high, or high for energy.
                            Matching dances are displayed in the
                            Selector window (3).
                            The number of matching dances is
                            displayed at the top of the Selector window
                            (3). The settings for a particular dance may
                            be changed by right clicking on a dance in
                            the Selector window.
                            All search criteria can be reset by clicking
                            on the Clear All Selections button (13) or
                            <control> C on the keyboard.

Search for Dances by Type or Style
                                                    Click the radio buttons to select from 8
                                                    user definable choices in each category
                                                    (Type (14) and Style (15)). Matching
                               14         15
                                                    dances are displayed in the Selector
                                                    window. The number of matching
                                                    dances is displayed at the top of the
                                                    Selector (3) window. The type and
                                                    style category captions can be set in the
                                                    Setup Screen found under the options
                                                    menu on the main screen.
                                                    The settings for a particular dance may
                                                    be changed by right clicking on a dance
                                                    in the Selector (3) window.
Dances of a given type are color coded using 8 preset colors when viewed in the
Selector, Holder, Program, Played Earlier windows and on the second monitor.
The colors are selectable by selecting setup screen from the Options menu. It is
recommended that these type captions and colors be set before adding the first
dances to the database and not changed afterward.
Note: Until the Player is registered, only the first two Types the Styles will be searchable. You may still
configure these types and styles using the setup screen, and you may still designate dances to these types
and styles, you will however, only be able to search on the first two.                                  19
Alphabetically Searching for Dances by Name or Sub-String
Typing the first few letters of a dance
name will scroll the top of the selector
window to the first dance which begins
with the same letters. Only dances which
match any previously selected repertoires      Typing an “*” followed by three or more
or search criteria are displayed.              letters will empty the Selector window of
                                               all dances except for dances containing
                                               the search string anywhere in the name.
                                               Backspacing or clicking the Clear All
                                               Selections button will reset the Selector.
                                               Again, only dances which match any
Dances containing a certain string in its      previously selected repertoires and search
comment can be found by typing a “?”           criteria are displayed.
followed by three or more letters. Any
dance matching the currently selected
repertoires and search criteria which also
contain the search string in their comments
are displayed in the Selector window.
                                           When the check box is checked, the alphabetical
                                           search will behave like a combination of the ?
                                           And * searches described above, without having
                                           to type the characters before the search string.
Note: Searches are not case sensitive.                                            20
Exiting the Player & Saving Playlists                Viewing Past Programs
Exiting the program will write the list
of dances played this session to a file.
This file is in a directory specified by
clicking on the Setup Screen selection
under the Options menu on the main
screen. The file will be named using
the following format:                     P ast programs can be viewed during a
Monday_2003_7_14.txt                     session by clicking the View a Past Program
                                         button. The screen at left is launched and
                                         automatically scrolls to the program stored
                                         one week ago. Double clicking on a program
                                         displays it in the text area of the form.
                                         Clicking on a single dance name in this
                                         window will queue that dance in the player.
                                         Clicking on the red Auto-Play button will
                                         queue this entire program in the Program
                                         window. Past programs auto-played can be
                                         as long as 229 dances. Selecting auto-play
                                         will overwrite any dances currently in the
                                         Program queue. The player will start playing
                                         the dances immediately.
Preferred Versions of Dances & Quick Access to Database Info

A bold dance name in the Selector window indicates
that this is the preferred version of a dance. The
preferred setting can be made by right clicking on a
dance in the Selector window and setting the preferred
parameter in the data
window that appears.

A quick view of all
database parameters for
a given dance may be
viewed (but not changed)
with a left click and hold
on the little box next to
the dance name.

When the cursor is moved over a dance which has a comment in the database, the
comment is displayed under the Selector window. Comments can be added by right
clicking on a dance in the Selector window. Complexity, Energy, Country, Type and
Duration are also displayed. Mouse-over info is available in any window.
Duplicate warning
You can be advised of which dances have already been played in the current
session. Dances already played appear “crosses out” in the Selector window.
Whether or not the dance is crossed out, it can still be queued to either the Program
or the Selector. You can turn this duplicate warning on using the Options menu on
the main screen. The default for this can be set by choosing Setup Screen under the
Options menu on the main screen and checking the check box.

                                                               This feature is
                                                               useful if you are
                                                               running a dance
                                                               marathon with many
                                                               people programming
                                                               dances. The
                                                               duplicate warning can
                                                               prevent subsequent
                                                               programmers from
                                                               repeating a dance
                                                               played earlier in the

Player Controls
Press play (17) to begin playing the queued dances.      Skip (18) will cut off the
currently playing dance and begin playing the next dance in the play list. Prev (19)
will replace the currently playing dance in the top of the Program queue and begin
playing the previous dance. Clicking the Play (17) button while a dance is currently
playing will restart the dance from the beginning.

The play button will begin playing the
current dance immediately. The small            19
clock (20) button inside the play (17)
button will wait the “between dance”            17
pause time before starting or restarting   20                               22
a dance.
To jump ahead or back in the
currently playing dance you may click           Pause (21) will stop a dance in the
in the progress bar. (22) Indicators at         middle but allow restarting at the same
the top of the progress bar show the            point when pause is clicked a second
current position and total duration of          time. While paused, the other buttons
the currently playing dance.                    are disabled.
Player Controls
Slide the volume slider (24) to adjust the volume of the Now Playing dance. This
volume setting is remembered each subsequent time the player is used. Over time,
if you adjust the volume of the dances using this slider, you will have all dances
at the same relative volume and will never have
to rush back to the player to adjust the volume
in the middle of a session. Clicking on the
buttons at the end of the slider changes the
volume by a little. Clicking in the slider track                  25    26
will change the volume by a larger amount.                                        23

The tempo control (23) can also                                                  24
be adjusted in .2% increments.
                                                              Function keys can be
The tempo setting is not stored in
the database unless the Save this
                                     Function keys            used to control some of
tempo (26) button is clicked.        F1 – Play                the features. This is
Clicking in the slider track will    F2 - Stop                useful if you have a
change the tempo of the dance by     F3 - Previous            remote control for your
1 percent. Clicking on the           F4 - Next                computer. Just program
buttons at the side of the tempo                              the remote control
                                     F5 - Pitch reset
control will change the tempo by                              software so that the
                                     F6 - Pitch up            buttons you desire
0.2%. The reset button (25) will
                                     F7 - Pitch down          correspond to the function
reset the tempo back to the tempo
at which the music was recorded.     F8 - Pause/Unpause       keys indicated above.
Documenting Live Music in Saved Playlists &
Replacing the Currently Playing Dance in the Player
Live music can be documented in the stored playlist in two ways.   You may type
directly in the Played Earlier (16) window or you may drag a dance directly from the
Selector window to the Played Earlier window. It will not be played by the computer,
but it will be recorded as having been played. You may also delete text from the
Played Earlier window to prevent dances from being written to the stored playlist.


                                                               Dance can also be
                                                               dragged from the
                                                               Selector (3) window
                                                               directly to the Now
                                            3                  Playing (17) window to
                                                               replace the currently
                                                               playing dance with a
                                                               different version or
                                                               different dance.
Displaying the Country or Choreographer on the Main Screen
Under the Now Playing box (27) you can display either the country where the
dance is from, or the choreographer‟s name. This setting is made by selecting
Setup Screen under the options menu on the main screen and selecting country or
choreographer from the radio buttons on the form which appears.

                                    Bosmat         27


Program Finish Time & Between Dance Pause Time

 The current date and time is displayed on the main screen as well
 as the projected program finish time. The finish time is adjusted as
 dances are added and removed from the Program window.

 The pause time between dances is determined by the number in the
 text box under the program finish time. The default value for the
 pause time can be set by clicking on the Options menu and selecting
 Setup screen. You can also type a new value in the pause time box
 during a session. This new value will be used for the current session,
 but it will not be remembered next time the player is used.

Saving Dances to Your Favorites List
By left clicking on the penguin logo
(28) you can see just your personal
favorite dances in the Selector window.
Dances can be dragged from the Selector                                       28
window (3) to the penguin logo (28).
This action will add the dance to the
current programmer‟s favorites file.
Favorite dances for each programmer are
saved into a file in the favorites directory
(under the application directory). There
is a unique file for each programmer.
Clicking on the Clear All Selections
button (13) will reset the Selector
window (3) to display all of the dances
in the currently selected repertoires
Note: When you display your favorites, they will be filtered according to the
last search criteria specified. To see all your favorites, clear all criteria first.
Note: When dragging favorites to the penguin, the cursor arrow must be over
the penguin (28) when you release the mouse button.
Note: The penguin will reject duplicate entries in the favorites file. Watch
the penguin for feedback when adding dances.
Note: A new file will be automatically created if one does not already exist.
Viewing Other Programmer‟s Favorites
Favorite dances for any programmer may be viewed in the Selector window (3)
by clicking on the Favorites menu (29) and selecting the desired programmer
name. All dances on the programmer‟s favorites list will be displayed in the
Selector window (3), but only if they fall into the current repertoire and match
any other chosen search criteria. You can reset
the Selector (3) to display all dances by clicking
on the Clear All selections button (13) on the
main screen or use the Favorites menu (29)
which has a Show All Dances selection.                28



Editing You Favorites List
                                You may right click on the penguin logo to remove
                                dances from your (the current programmer) favorites
                                file. The screen pictured on the left will appear.

                                Simply click on a dance name in the editor window
                                and click the Remove Selected button. Exit; No Save
                                will exit the editor screen without making any of your
                                current edits. Save will update your favorites file.

Changing Programmers
You may change programmers in mid-program using the Change
Programmer item on the Options menu. The programmer selector
window will appear. The original programmer‟s name will appear in
the saved playlist along with any additional programmers selected in
this manor. The time of each programmer change is also recorded.                   31
Teasing Dances

Dances that require sets to be formed often require starting the music to let
dancers know what is coming, then stopping the music to give the dancers
time to form their sets. The “Teaser” function can allow the programmer to
set this up in advance in the program. Click the teaser button (30) to add the
word TEASER to the program queue (1). The program is arranged so that
the word TEASER is just prior to the dance which needs to be “teased”.
After the usual pause time, the teased dance will play for a specified period of
time (teaser play time). The dance is then stopped for a different specified
period of time (teaser hold-off time) and restarted for normal play. These
specified periods of time can be set by choosing Setup Screen from the
Options menu. In the below screen capture, BARE NECESSITIES will be



Teaching Stops & Announcements Stops

                  31        The programmer need not return to the computer to
                            stop the player prior to teaching a dance. Simply
                            click the Insert Stop button (31) to place the word
                            STOP in the program queue (1). The dance after
                  1         the word STOP will be loaded into the player when
                            its turn comes, however the player will stop
                            automatically before playing it. After teaching the
                            dance, click the play button to resume the program.
                            In the screen capture at left, the player will stop
                            before playing Belasicko Oro.

Right clicking on the Insert Stop (31) button will place the word
ANNOUNCEMENTS in the Program. This will behave just like STOP,
however if you are using the second monitor option, STOP before a dance
will cause the second monitor to indicate that the dance will be taught.
ANNOUNCEMENTS will show up as such on the second monitor.

 Dance Floor Monitor
 If your computer has dual monitor hardware (not just an additional monitor output),
 you can display the next 6 dances and previous 5 dances on a monitor facing towards
 the dance floor. The currently playing dance is displayed in large text in the middle
 of the screen with either the Country or Choreographer. The setting of choreographer
 or country will follow the setting for the main screen.

 A picture of the choreographer or map of the country can be displayed on this screen
 as well. If a .jpg or .gif file exists (in the pictures directory under the applications
                                                         Directory) whose name exactly
                                                         matches the choreographer or
                                                         country in the database the picture
                                                         will be displayed. If no picture file
                                                         name matches, a picture which is
                                                         named default.jpg will be displayed
                                                                              The color key used on this screen
                                                                              matches the color key used on the
                                                                              main screen.

                                                                              Turn this feature on by selecting
                                                                              Playlist on Monitor2 from the
                                                                              Options menu on the main screen.
Note: If you do not have dual monitors, you can still turn on this feature. Simply place this screen directly over the main screen.
It will come to the front after 50 seconds of inactivity on the main screen. Moving the mouse will bring the main            34
screen back to the front. Use a projector, or face your computer towards the dance floor.
Setup Screen
Initial settings and options can be changed by selecting   Check this box (2) if you
the Setup Screen choice under the Options menu on the
main screen. The screen below will appear..                would like the program to
                                                           record any dance played
Specify up to 16 programmers (1). Each                     twice in a 24 hour period
                                                           as having been taught on
programmer will get his or her own button on the
startup screen.                                            that day.
                                             3       4
                                                           Save these settings (4)
        1                                                  and exit this screen, or just
                                                           exit without saving (3).

            6                                              Check here (5) if you
                                                           want the current repertoire
                                                           settings to be
                                                           remembered next time the
                                                           player is used.

                                                           If you have a CD drive,
                                                           set the letter here (6).
                                                           Tracks from a CD can be
                                                           added to the Program.
Setup Screen
The two databases each have names of your choosing.       The names you assign here
(1) will appear on the database buttons on the splash screen

                                                                  You may choose from
                                                                  several drag icons (21).

                 8                                      21        You may set whether
                                                                  the country or the
                                                              7   choreographer is
                                                                  shown under the dance
                                                        11        name on the main
                                                                  screen and the second
                                                             10   monitor screen (11)
                                                                  The default pause time
                                                              7   between dances may be
                                                        11        set here (10). The value
                                                                  can also be changed on
                                                             10   a per use basis on the
                                         9                        main screen.
 Teaser play and hold-off                    The default can be set for
 times are set here (8).                     the duplicate warning (9).           36
Setup Screen
The Recently Taught button above the Holder on the main screen will add any
dance taught within the last „N‟ weeks to the Holder. „N‟ can be set between 1
and 99 in this box (12).
                                                           If you choose to register
                              13                           the program, you will be
              12                                           sent a registration code.
                                                    17     Enter it in these boxes
                                                           (13). When a correct
                                                           code is entered, the
                                                           background of the boxes
                                                           turns green. Registration
                                                           gives you full
                                                           functionality of all
                     14     15     16                      repertoires, types and
                                                           styles as well as
                                                           unobstructed use of the
                                                           tabular view. The player
                                                           is otherwise fully

The type (14), style (15), and repertoire selector (16) captions can be set here.
The colors can be set for the dance types by sliding the RGB color sliders (17)
above after clicking in one of the boxes. The dance names that match your
captions will be displayed in the color shown when viewed on the main screen.       37
Simply type the desired captions in the boxes.
Setup Screen
Set the initial path for where the mp3 files will be stored here (18). The mp3s
do not need to be in this directory, but the database manager window will always
default to this directory. You can always add music from different directories
on the add dance screens. Setting it here just saves you some clicks later.

Set the directory where you would like to save the playlists (19) from each.
                                                         session. While the two
                                                         databases can store the
                                                         files in different
                                                         directories, within one
                                                         database, the different
                                                         repertoires all store the
                                                         playlists into the same
                                                         directory. The name of
                                                   20    the playlists in this
                                                         directory is sorted by
                                                         week day, however.
  18        19

                                                         Set the max and min
                                                         values for the year
                                                         sliders here (20).
Changing a Dances Database Parameters
To update a dance‟s database parameters, right click on that dance in the Selector
window on the main screen. This database manager screen will appear. The
database parameters for the dance will be displayed. Any parameter may be
changed. Clicking the Close Window button will exit this screen and save the
changes to the current dance. You can listen to the selected dance by clicking on the
Listen button. Stop listening by clicking the Stop button.
                                               You can make edits to other dances by
                                               using these scroll buttons or by using
                                               the page up and page down buttons on
                                               the keyboard. The up and down arrow
                                               keys on the keyboard also work the
                                               same way, but if the last thing you did
                                               was click a button, the arrow keys will
                                               tab to the next field rather than scroll.
                                               Scrolling to the next dance WILL save
                                               any changes you have made to the
                                               current dance even if you return to this
                                               dance and click the Undo current edits
                                               to this dance button. You can either
                                               scroll through all dances in the database
                                               or just the ones in the Selector window.
Changing a Dances Database Parameters
You may also make edits to other dances by selecting them via the file selector
windows (1 & 2). If the dance is in your database, its name and database values
will be seen in this window. If the dance is not in your database it will not be
selected. If you would like to add the dance, select the add dance options from the
options menu on the main screen.
Note: If you change dances via the file   T   he dance name seen in the player may be
selector, any changes made to the previous changed by editing it in the Name box (3), but
dance will be saved.                       if you duplicate a dance name already in your
                                           database, the program will add a “_%” to the
                    3                      name. Dances will be re -alphabetized. The
                                           mp3 file name will not be changed.

                                          To remove a dance from the database, right
                                          click on that dance in the Selector window
                                          on the main screen. The Update a Dance
   1                                      window will appear. Verify that the dance
                                          named at the top of this window is the dance
                                          you would like to remove and click the
   2                                      Remove dance named at top button (4).
                                          The dance will be removed from the
                                          database, but it will NOT delete the mp3
                                          music file from your computer.          40
Changing a Dance File‟s Name or Directory

 If you would like to change
 the file name or directory
 location of an mp3 file on your
 computer‟s hard disk click this

       Bannielou Lambol            The above window will appear
                                   showing the old name and directory
                                   location. Type in a new name or
                                   directory path. The dance will be
                                   renamed and/or moved on your
                                   computer‟s hard disk. Note that if
                                   you are using the two databases in
                                   this program and you change the
                                   name of a file that is in both
                                   databases, the other database will no
                                   longer be able to access that dance.
                                   To fix this, just delete the dance
                                   from the other database and add it
                                   again as if it was a new dance.
Adding Individual Dances to Your Database
To add new dances to the database one at a time, use the Add
Dances menu on the main screen and select Add individual
dances. The window seen below will appear with some
defaults filled in. Using the directory and file selector boxes,
(1 & 2) choose a music file to add. The dance name (3) at the top of this window
will be the same as the file. You may edit the dance name if you wish, but if you
duplicate a name already in the database, the program will add “_%” to the name.
Set the other database parameters and click the Add Selected Dance button (4) to
                                                 add this dance to the database.
                  3                              The dance will be added in the
                                                 correct alphabetical order.

                                             Select already existing values
                                             from the dropdowns or type in
   1                                         new values.

                                             When you are done adding
   2                                         individual dances, click the Done
                                             Adding Dances button to dismiss
                                             this window and return to the
                                             main screen.
Adding All the New Dances in a Directory to Your Database
To add all the dances in a directory to the database, use the
Add Dances menu on the main screen and select
Add a group of dances.
This window seen below will appear with some defaults filled in. Using the
directory selector boxes (1 & 2), choose a directory to add. You must specify
database parameters to be applied to all of the added dances. You may choose to
edit individual dances later by right clicking on the dances in the Selector
window. The dances will be added in the correct alphabetical order.
                3                           Note: Files with names that duplicate
                                            existing dance names will not be added.
                                            Use the Add individual dances screen if
                                            you would like to do this.

                                            Once you have chosen the
                                            directory and set the database
   1                                        values, click the Add all new dances
                                            in selected directory (4) button.

   2                         4              When you are done adding groups of
                                            dances, click the Done Adding Dances
                                            button to dismiss this window and
                                            return to the main screen.        43
Editing, Saving, and Playing Auto-Playlists
                           The Program queue on the main screen is
                           designed for interactive dance programming.
                           This means that the programmer may respond to
                           requests and build the dance program during the
                           session to suit the constantly changing skill level
                           of dancers on the floor. Dances are not usually
                           being queued too much faster than they are being
                           played (which removes the dance from the
                           Program queue). There may be times however,
                           when a session leader will want to pre program
                           the whole session‟s dances before the session and
                           save this list for later use. With a visible length of
                           only 29 dances and no scroll bar, the program
                           queue is not very conducive to creating programs
                           in advance.

                           The Auto-play                                Ctrl + L

                           Playlist Editor is
                           designed to set up
                           longer playlists.

                           Select Auto-play Playlist Editor from the Utilities
                           menu to launch the editor window seen above.
Editing, Saving, and Playing Auto-Playlists
                               Dances may be dragged into the playlist
                               editor (1) from the Selector window. You
                               may rearrange the dances by dragging them up
                               or down. You may scroll up and down using
       4                       the vertical scrollbar. You may delete dances
                               by dragging them back to the Selector window
                1              or by first right clicking on them and then
                               pressing the computers delete key.

                               In the bottom left corner (2) you can see how
                               many dances are in the play list and the
                               duration of the program you are creating.

                               The green dot (3) under the Quit button will
                               turn red to indicate that there are unsaved edits
                               to this play list.
                               Once you are happy with the playlist, you
       2                       can save it to a disk file. Simply select the
                               directory and enter a file name. Click the Save
                               Playlist button (4).                      45
Editing, Saving, and Playing Auto-Playlists
Saved playlists can be recalled by
selecting the directory and then clicking
on the file name in the file box (4). The
playlist will open in the Playlist Editor
window (1). Dances can then be added,
removed, or rearranged.

Click the Autoplay this playlist button
(5) to queue all of the dances in this
playlist in the player. The player will      4   1
show only the first 29 of these dances,
but as the dances finish playing, the
bottom of the queue will be refreshed
from this playlist. The player will start
playing the playlist immediately.            5
Quit (6) will exit the playlist editor. If
there are unsaved edits, you will be
given an opportunity to save the playlist
Recalculating Dance Durations and Database Health Check
Dance durations are used to              In addition to updating the dance durations,
calculate your session‟s end time.       the dance duration utility also verifies that
Durations are stored in your dance       the music file for this dance is still in the
database. When you add new               correct place on your hard disk. If a music
dance to the MIT Player, accurate        file has been moved or deleted, you will be
durations are input to the database      informed of this. The utility will also write
only if the player is not currently in   a file to disk in the MIT Player directory
use. If the player is playing, the       listing all dances which are not found.
duration for any new dance you add       While this utility is working, the green
is estimated to be 3 minutes. It will    progress bar on the main screen will
remain this way until the dance is       indicate how many dances have been
played. Once the dance is played         checked. It is recommended that you let the
your database is updated with the        utility finish before attempting to do any
correct duration. Until that time,       other operations with the MIT Player.
there could be small errors in the
session end time calculated by the
player. You may force the player to
                                                                        The utility
                                                                        should finish
recalculate all dance durations by                                      in under two
selecting Recalculate Dance                                             minutes
Durations from the Utilities menu.
Playing CDs
You can add a track from a CD to your      The CD must be placed in the
program. Click the Play CD button and      cd drive before adding the CD
click the track you would like to add to   track to your program and the
your program.                              CD must remain in the drive until
                                           after the track has played. The
                                           Prev button ignores previously
                                           played CD tracks. Only tracks
                                           from one CD at a time can be
Track 1.cda                                placed in the program queue.
Track 2.cda
Track 3.cda
Track 4.cda
Track 5.cda
                                           The track name will be recorded
Track 6.cda                                in your program, but you can
Track 7.cda                                make edits in the Played Earlier
Track 8.cda
                                           window on the main screen
                                           before exiting the player and
                                           saving the playlist.

                                           This program can not “rip” CDs
Frequency Counts
Have you ever wondered which dance you play the most? Which dances have been
losing popularity? The frequency counter utility can help you answer these questions.
Its output is a list of all dances that have been played between the specified dates,
ordered by how frequently the dance has been played.
                                      To see frequency counts of
                                      dances played between any
                                      two dates, invoke the
                                      frequency counter by
                                      clicking on the menu item.
                                  Fill out the from and to date fields and click the Go
                                  button. The frequency count appears in the output
                                  window. Clicking the Save button will write an
                                  output file to the MIT Player directory.
                                  Optionally, you can limit the frequency count to
                                  certain days of the week. Select one or more of
                                  the check boxes.
                                  Double clicking on any file in the file window will
                                  display the program from that day in the output
                                  Certain characters such as - _ , are used as   49
                                  delimiters by the frequency counter.
Magic Programmer
Don‟t feel like thinking about which dances to play today?
Let the magic programmer do it for you. The magic
programmer will automatically pick dances and drop them in
the program queue. Dances will be chosen at random, but the
average complexity will increase as the session progresses.
To use this feature, select Magic Programmer from the Utilities menu.

                                        If you have not recently run the frequency
                                        count function described on the previous page
                                        and saved the results to a file, do so now by
                                        clicking on the large button at the top of the
                                        Magic Programmer screen. This button is
                                        another means of launching the frequency
                                        counter window.
                                        The magic programmer picks dances from the
                                        frequency count file. If the frequency count file
                                        does not contain several months worth of
                                        dances, there may not be enough dances for the
                                        magic programmer to choose from.
Magic Programmer
Enter the session end time in the dropdown boxes.    The magic programmer will keep
choosing dances until the session end time displayed in the main window exceeds the
time specified here .
Set the slider to force the magic programmer to
choose only commonly played dances, or to allow
the magic programmer to select from less
commonly played dances along with the more
commonly played ones. The slider setting makes
sure that dances have been played at least the
specified number of times over the frequency
count period. This number is shown under the
Note: It is possible that if the slider is set too far toward the “More
Common” side, not enough dances will be available for the magic
programmer to choose. If this is the case, you will be asked to select a
setting which allows more obscure dances to be chosen.

The types of dances chosen is random, but it is possible to cause the magic
programmer to choose more dances of a certain type and less dances of other types.
Choose the relative probabilities that each type of dance will be selected by adjusting
the sliders higher or lower. The lowest probability setting is 0 when the slider is all
the way to the left. All of the types probabilities are relative to each other.         51
Note: If these sliders are not manually adjusted, they will be automatically set to the ratios present in the frequency count file.
Magic Programmer

                    Click the Run button in the Magic
                    Programmer window. The player will
                    automatically be started.

                   The magic programmer will keep about ten
                   dances in the program queue at any one time.

Tab Stops
It is sometimes useful to be able to start a dance at a predetermined place in the
music during teaching. The tab feature is used to set these points and to start the
music at them.
Click the F9 key while a dance is playing to set a tab point at that exact place in the
music. The tab point will show up under the progress bar as a small orange square.
During future plays of this dance, the tab points
will automatically show up in the same places. You
can click on a tab point to start the music at these
The tabs are named “tab stop N” by default (where N is a number between 1 and 8).
This name pops up when the mouse is placed over a particular tab. If you would like a
custom name instead, simply type that text in the search window before pressing the F9
key. (The dance selector window will scroll to some dance that starts with these
characters, but who cares?)

When the F9 key is pressed,       Chorus
the tab will have this name.
Caution: Each press of F9
will insert a new tab!                                                                53
Tab Stops
There is a tab editor which can be launched
by pressing shift and F9 or by selecting
Tab Editor from the Utilities menu.
Alternately, you can edit the tab file for a
particular dance to change the labels. The
files are stored in the tabs directory under
the directory where the player resides.
The tabs directory & the tabs files are created automatically.
 2.796757," Tab Stop 0 "           The tab files are named with the same name
 26.46125," Tab Stop 1 "           that the dance uses in the database.
 72.05952," Tab Stop 2 "           The files are text files.
 116.6737," chorus "
 90.20909," Tab Stop 4 "           To remove individual tabs for a dance, right
                                   click on the tab while holding down the shift
                                   key. To remove all tabs for a dance, just delete
                                   the file.
                                   There are a maximum of 8 tabs per dance.

Tone Control
                       Tone control is available under the
                       Utilities menu. When selected the tone
                       control window appears.
                       The tone settings can be saved and later
                       recalled. To save a preset tone setting,
                       adjust the settings (1) as desired. Enter a
                       preset name (2) and click the Save Preset
                       button (3). One of the 6 preset buttons (4)
                       will now display the name of the new
               1       preset. A file by this name will also be
                       created in the MIT Player directory. Only
                       alpha-numeric characters and the ~ (tilde)
                       character are allowed in preset names.

   4               2   To recall the preset, click the desired
                       preset button (4). The first preset button is
                       always loaded when the player first starts.

Tone Control

                             The presets (4) are always in alphabetical
                             order on the buttons. To insure that the preset
                             you want for a default is first, use a ~ (tilde
                 1           character) as the first letter of the preset name.

                     6       To remove a preset, click its button (4) and
                             then click the Delete Preset button (5) . The
         3               5
                             button caption will be reset to blank, and the
   4                 2       preset file will be deleted.
                             The Reset button (6) will always put the tone
                             controls (1) back to the mid point and set
                             reverb to 0.

                             When finished click the Done button (7) to
                             close the tone control window.

Histograms                Tabular View
Histograms allow          Clicking on the Tabular View button (31)
you to check the          removes the Selector, search buttons and
balance of your           histograms from the main screen, replacing it with
program. These            a tabular view of all the dances in the database.
histograms are not        Once having selected the Tabular view, the button
configurable              caption changes to Normal View (32) . Clicking
except in that you        on this button again restores the Selector, search
may determine             functions, and histograms. You may switch back
whether to display        and forth between the two views during a session.
histograms of only
what is queued up
in your Program
window, only
dances which have
already been
played, or both at
once. Simply
check either or
both of the check
boxes above the
histograms.          31
Tabular View
In the Tabular view, you may drag a dance from the Dance Name column to the
Program or Holder windows. You may also right click on a dance name to queue it
at the end of the Program window. You lose the search buttons, but retain the ability
to do the search by name or sub-string. In this view, you may sort the dances by
clicking on the column name. The + in the repertoire columns indicate that a dance
is in that repertoire.
                                                There is not enough room on the
                                                screen to display the comments,
                                                however clicking on the arrow
                                                buttons at the top of the Tabular
                                                display allows replacing the
                                                choreographer, year and country
                                                columns with the comments.

                                                The name, sub-string, or
                                                comment search is still available
                                                in this mode. Matching dances
                                                percolate to the top of the list, but
                                                all dances are still displayed in it.

Making Changes to the Dance Database in the Tabular View
To make database edits in the tabular mode, click the edit button. The top row of
the view will turn red and the button caption will change to lock. You may now
make edits by right clicking on a data cell. During this time, the sorting ability of
the column headers is disabled.

                                                                  Note that in some
                                                                  cases, multiple
                                                                  clicks on column
                                                                  headers will sort in
                                                                  the reverse order
                                                                  and in other cases
                                                                  multiple clicks on
                                                                  the column headers
                                                                  will bubble the next
                                                                  value to the top of
                                                                  the list.

Making Changes to the Dance Database in the Tabular View
Right click on Type, Energy, complexity, or style cells. View the current setting
in the blue text window which appears. Select a new setting from the list.
                                                     Click lock to exit the edit mode.
                                                     Right click Country or
                                                      Choreographer cells. The
                                                      current setting appears in the
                                                      drop down window which
                                                      appears. Select a new choice
                                                      from the dropdown. Click the
                                                      OK button to keep the current
                                                      Right click on Year cells.
                                                      Select a new year value by
                                                      sliding the slider until the
                                                      correct year is pictured in the
R  ight click a repertoire box to toggle the setting. blue cell. Click the OK button
                                                      on top of the slider to keep the
R  ight click a Dance Name to change a dance to current value and return the
preferred (bold) or back to normal (not bold).        cell background to white.
Right click on a comment cell (not pictured). Type or edit
the comment displayed and click the OK button.                                     60
Registering the Player
Launch the about screen by selecting About from the Help menu.

If you choose to register the program, send me the number
that appears in this box on your computer. I will send you
a registration code to enter on the setup screen form.
        Database Structure
"Aba.mp3","C:\Israeli Dances",1,-1200,95.58204,"Israel",1,1,1,#1976-11-06#,"",1111,0,"1/1/1900",3,0,"","Aba"
"Abba Shimon.mp3","C:\Israeli Dances",1,-608,212.6367,"Israel",3,1,1,#2004-03-24#,"Israel Yakovee",1990,0,"1/1/1900",0,0,"","Abba Shimon"

The database file is just a text file.    The only thing that makes
editing the database outside the program tricky is the fact that
VB sometimes sticks in # characters around certain fields and some
fields also require double quotes (") around the data.

Here is a list of the fields in the database:

name As String     'This is the file name (no path) (with file extension)
path As String     'This is the path to the file
speed As double    'This probably should be a double.   1 means normal speed.
                   'Less than 1 means play slower.   Greater than 1 faster.
volume As Integer 'Playback volume . More negative is quieter.     I think the program defaults to -1200
duration As double 'This should probably be a double.   It is the duration of the dance file
                     'in seconds.   It does not need to be accurate.   The program will update
                     'it as dances are played.   The only thing that will suffer if the number
                     'is wrong is the program end time.    There is a utility that will update
                     'all dances duration field under the utilities menu.
country As String    'Country where dance is from.   Could be an string.
complexity As Byte   'How difficult is the dance to do.   1 = easy 3 = difficult
type As byte          'Type of dance.   Integers from 1 to 8.   Corresponds to types in order
                      'that they are specified on the main screen.
energy As byte        '1 to 5, but be careful with this one.   Since I added medium-fast and
                      'medium-slow afterwards, the numbers do not go in order.   This was to
                      'maintain backwards compatibility for previous users.    1 = slow 2 = medium
                      '3 = fast, 4 = medium slow, 5 = medium fast.
last_date As date     ' Last date a dance was played. This gets # characters around it.
choreographer As String     ' Choreographers name.   Text string. Does not matter if it is
                            ' first name first or last name first, but you should be consistent.
                            ' If you use the second screen picture option, you need to name
                            ' the gif or jpg files exactly as they appear in this field.
year_choreograhped As integer ' this should probably be an integer.   It is the year the dance was choreographed.
style As byte                 ' 1 to 8 for the dances styles.   Follows the order that the styles appear on the main program screen.
taught_date As date           ' Last date a dance was taught. This gets " characters around it.
repertoire As Byte            ' Which repertoire does a dance show up in. Integer in the
                              ' range of 0 to 255.   If number is shown in binary form, a
                              ' 1 in position 1 through 8 means that a dance is in that repertoire .
                              ' MSB is the first repertoire .   LSB is the last repertoire .
                              ' Goes in order that the repertoires are shown on the main program screen.
preferred As byte             ' 1 or 0 I should probably make this a Boolean. 1 means the dance
                              ' is a preferred version and will show up in bold text in the selector window.
comment As String             ' Text string   (don't use double quotes INSIDE this string.)   The whole string is inside double quotes.
file_name As String           ' Name of file as it appears in the selector window.   This is usually the same
                              ' as the file name, but does not have to be.