BerryTunes 2.2.4

System Requirements
-------------------
* BlackBerry 8100, 8300 or 8800 series with OS 4.2+
* Windows XP/2K with Microsoft .NET Framework 1.1+
* BlackBerry Desktop Software installed
* SD card or 16MB of internal memory for MP3 files
* MP3 files for transferring to your BlackBerry

*** DISCLAIMER ***
Please download the trial version of this software
to ensure compatibility with your device and any other
software or accessories you may be using. If your BlackBerry
is password protected you must enter you password correctly
when transferring files via USB.  If your password is not
entered correctly within 10 attempts you risk losing all of
the data on the device.  This is a security measure implemented
by RIM.

Version 2.2.4
-------------
Added handling for Unsupported Operation Exception on certain devices

Version 2.2.2
-------------
Workaround for bug introduced in BlackBerry OS 4.2.2 which
caused an Exception when saving files to internal memory

Version 2.2
-----------
* Ability to add and edit your own stations
* Select between Wifi and Mobile Network
* Status bar scrolls full station name 

Overview
--------
Turn your BlackBerry into a portable sound machine with BerryTunes!

Want to liven up a dull evening?  Just startup BerryTunes and you
can be the life of the party!

Got some new tunes you want your friends to hear?  It's no problem
with BerryTunes!

Maybe you just want to relax on the beach and listen to your favorite
songs...

BerryTunes allows you to transfer MP3 files via your USB cable 
and listen to them on your BlackBerry.  You can output the music
through the speaker, a wired headset, or even through Bluetooth.

The BerryTunes MP3 Browser for Windows allows you to easily select
the MP3 files you want to send to your BlackBerry.  Multiple selections
can be sent at one time.

You can even preview your songs in the MP3 Browser before transferring
them to your BlackBerry.

BerryTunes can store your songs on a SD memory card (recommended) or
use the internal memory of the BlackBerry.

For ease of use, we enabled several keyboard shortcuts in BerryTunes to
control playback and change the order of the songs on the BlackBerry.

Features:

* NEW! Listen to Internet Radio Stations
* Store files on SD card or internal memory
* Transfer via USB cable
* Preview music before sending
* Easy to use MP3 Browser for Windows
* Automatically converts files to optimal format
* Two Quality Options (Normal or High)
* Faster file transfer via USB
* Supports industry standard MP3 Files
* Fast Forward / Rewind using the trackball
* Time Counter displayed on screen
* Player pauses on incoming phone call

Note: Bluetooth support can be problematic on certain devices

Registration: Please be sure to correctly enter your BlackBerry PIN when
purchasing this product.  The PIN is an 8 digit code that can be found by
choosing Options>Status or Tools>Settings>Status from the BlackBerry Home
Screen. The characters "B, 8" and "O, D, 0" look very similar so please
double check your PIN. If you do not enter your PIN correctly your
registration code will not work!


Installing BerryTunes on Windows
---------------------------------
NOTE: The previous 1.x verious of BerryTunes is NOT compatible
with the 2.0 version.  Please uninstall the 1.x version first.

You must have the Microsoft .NET Framework 1.1 or 2.0 installed
in order to use the BerryTunes MP3 Browser.  A link to the .NET
Framework version 1.1 is included should you need to install it.
The .NET Framework is also available via Windows Update.

You must also have the BlackBerry Desktop Software installed as this
contains the USB driver necessary to communicate with the BlackBerry.
You can download the BlackBerry Desktop Software from your carrier or
install it using the CD that came with your BlackBerry.

To install BerryTunes MP3 Browser double click on the file "BerryTunesSetup.msi".

Make sure that you have unzipped the zip file to a folder before trying to install
the above setup file.  If you are using Windows XP your can right click on the zip
file and select "Extract All..." to unzip it or you can use a 3rd party unzip tool.

Follow the prompts to install the program to the default location.  When
finished you should see a BerryTunes icon on your desktop and an entry under
Program Files that you can access via the Start menu.

Uninstall from Windows
----------------------
Use the standard Add/Remove Programs icon in the Windows Control Panel to 
uninstall the BerryTunes MP3 Browser and associated shortcuts.


Installing BerryTunes on the BlackBerry
---------------------------------------
Please remove any previous 1.x versions of BerryTunes before installation

1. Start the BlackBerry Desktop Manager
2. Open the Application Loader and follow the Wizard.
4. Choose the "Add..." button and browse to the location of the .alx file. 
5. Choose the "BerryTunes2.alx" file to begin the installation.

Make sure that you have unzipped the zip file to a folder before trying to install
the above .alx file.  If you are using Windows XP your can right click on the zip
file and select "Extract All..." to unzip it or you can use a 3rd party unzip tool.


Uninstall from BlackBerry
-------------------------
We recommend you use the BlackBerry desktop software to remove the
program by unchecking BerryTunes in the Application Loader.  Uninstalling
will remove the program and all the songs from the BlackBerry.  If you are
going to upgrade BerryTunes and you want to keep the songs you have already
loaded, don't uninstall the program, just do an upgrade instead.

To uninstall directly from the BlackBerry, you will need to go to
one of the following screens depending on your model:

* Options > Applications
* Tools > Settings > Applications
* Options > Advanced Options > Applications

Select the program, and then choose "Delete" from the menu.


Using BerryTunes MP3 File Browser on Windows
--------------------------------------------
The MP3 File Browser is similar to the Windows Explorer file viewer.
You can view either icons or a list of files and folder by selecting
the appropriate option from the "View" menu, or by using the toolbar.

The MP3 File Browser will only display MP3 files, and folders that can
be opened.  To open a folder double click on it.  To go up one level from
where you are, click the icon with the yellow folder and green up 
arrow.  The current folder that is open is displayed in the Status bar.

When you first start BerryTunes on Windows, the MP3 File Browser
will open to the Windows "My Music" Folder.  This folder is located
in "My Documents".  The full path to this folder is typically something
like this:  C:\Documents and Settings\~username~\My Documents\My Music
If for some reason the "My Music" folder does not exist, the browser
will open to the desktop.

You can set the default "My Music" folder by selecting the *folder* you want
to use and then choose "Set My Music" from the File menu.  You can also
right click on the folder you want to use and choose "Set My Music" from
the context menu.


Previewing MP3 Files
--------------------
Select the MP3 file you want to listen to with your mouse and use the
green "Play" button on the toolbar to start the song.  Use the red "Stop"
button to stop the sound.  You can also right click on an MP3 file and
select "Play" or "Stop" from the context menu.

Make sure your speakers and sound card are setup correctly, etc.  
The MP3 file will be played out of the default Windows sound device.  


Testing the USB Connection
--------------------------
The "Device" menu of the MP3 Browser contains an option that will allow
you to test the USB connection between the BlackBerry and Windows.  You
can use this feature before you transfer files to ensure that everything
is working properly.  This option also displays your BlackBerry PIN.

The Device menu also allows you to "Reset" the BlackBerry.  This is useful
to reset the USB connection and also to recover unused space on the BlackBerry.
The "Reset" option is the same as pressing ALT-CAP-DEL on the BlackBerry 
or removing the battery from the BlackBerry.


Setting up the SD Card
----------------------
In order to use the SD card you may have to disable the mass storage mode.

This is normally located on the BlackBerry under "Options > Media Card"
or "Options > Advanced Options > Media Card"

Scroll to the Mass Storage Mode and disable this feature.

If you don't disable the mass storage mode you may end up transferring
files to internal memory instead of the SD Card.



Transferring MP3 Files
----------------------
First, connect the USB cable to the BlackBerry then start BerryTunes on the
BlackBerry and leave it open.

Next, open the BerryTunes MP3 Browser on your Windows computer.

The browser will open to the Windows "My Music" Folder by default.

Using the MP3 File Browser, navigate to a folder and find the MP3 file(s) that
you want to transfer to the BlackBerry.  Your files must be in MP3 format or
they will not show in the browser.  If your music files are not in MP3 format
you will need to use another program to convert them to MP3 format.

A sample MP3 file called "BerryTunes.mp3" is included with the software
that you can use for testing if you don't have any MP3 files on hand.

There are a few ways to transfer files, but they generally have the same result.

To transfer a single file you can either double click it or select it and then
choose the "Transfer" icon in the toolbar.  You can also right click on a file
and choose the "Transfer" option from the context menu.

To transfer multiple files, select the first file you want to transfer by
clicking it once with the mouse.  Then hold down the Ctrl key and select
the individual files you want to transfer.  To select a range of files,
do the same as above except hold down the Shift key and then click on the
last file you want to transfer.  All the files in the range will be selected.
With all the files you want selected, click on the "Transfer" button on the
toolbar to start the transfer to the BlackBerry.  

We recommend you start by transferring your files one at a time until you get
the hang of it.

If you prefer to use a traditional file dialog you can use the File menu to
"Open and Transfer" but you will lose the ability to preview files.  You can
also drag and drop MP3 files directly on the to MP3 Browser to transfer them
to the BlackBerry.

Transfer can take a minute or two depending on the size of the file as the
files are converted to a format that is compatible with the BlackBerry.

Files are stored on the SD card if one exists or to internal memory if not.

You can cancel a transfer but do not interrupt the process when a file is
saving to the BlackBerry. It's better to wait until the file has finished
saving and then delete it if you don't want it.

If your BlackBerry is password protected a dialog will be displayed requiring
you to enter your password.  You must enter your password within 10 attempts
or you risk losing all the data on the Handheld.  If you forget your password
do not try to guess it; contact your system administrator.  You will have to
enter your password each time you transfer a file or attempt to make a USB
connection.  If possible, you may want to disable password protection while
transferring files and then turn it back on after you have finished.


Size Limits
-----------
There is no size limit for files transferred to the SD card but
there is a limit of 2.8 MB for files transferred to internal memory.


Using BerryTunes on the BlackBerry
----------------------------------
The MP3 files that you have transferred will be displayed in a list
on the BlackBerry with a yellow speaker next to each song.  When a song
is played the yellow speaker icon will change slightly to indicate this.

To play a song, use the trackball to select the song you want to play
and then push in the trackball to bring up the menu and select "Play".
You can also use the spacebar on the BlackBerry to start and stop the
selected file.

To fast forward or rewind move the trackball left or right.

The songs will play one after the other until the end of the list is reached.

Use the "Volume" menu option to adjust the speaker volume.  The default
volume is set at 60.  After you adjust the volume to the desired level
it will be saved.  To close the Volume dialog press the Escape key.

Use the "Output" menu option to select the desired audio output.  You
can choose from Speaker, Handset, Wired Headset or Bluetooth.  Note that
some models do not support all options correctly.  Bluetooth can be
problematic on early versions of the BlackBerry 4.2 software but appears
to have been fixed in newer versions.  To use Bluetooth pair your devices
as you normally would with the BlackBerry and choose the Bluetooth option.

The "Shuffle" menu option will randomize all of the songs in the list.
This can be used to give your songs a fresh sound if you are tired of
the order they are played in.  This order will not be saved and the files
will be sorted alphabetically the next time you start BerryTunes.

The "Hide" menu option will send BerryTunes to the background.  This
is useful if you want to play songs and perform another task on the BlackBerry.
To get back to BerryTunes, click on the BerryTunes icon just as you did when
you first launched the program.

The "Get Info" menu option will display basic information about the files
such as the name, time and size of the file.

Use the "Register" menu option to register BerryTunes.  See the section
below for additional details.

Use the "Delete" menu option to delete a single song.  See the section
below for additional options.

To change the order of the songs on the BlackBerry first select the song
you want to move. Then hold down the ALT key while using the trackball
to move the song up or down in the list.  This order will not be saved and
the files will be sorted alphabetically the next time you start BerryTunes.


Internet Radio
--------------
Internet Radio provides a variety of stations to listen to streaming
music on your BlackBerry.  Choose the category you wish to listen to
and select "Get Stations" to see the available stations.  You can then
choose the station you want to listen to. It may take a minute or so
before the stream begins to play. If one station doesn't work, please
try another.  We can not guarantee the availability of any one station.

You must set the APN in the BlackBerry TCP settings if you are using Direct TCP.
More information on the APN is available in the BlackBerry FAQ on our website.
Failure to set this correctly may result in an "Open Tunnel" error.

To add a station, highlight the "My Stations" tree and select "Add Station"
from the menu.  You will need to enter the name of the station and the URL
to the stream or .pls file.  We recommend 32Kb streams if you are using your
carriers mobile network.  The stream will start faster if you enter the direct
URL to the stream instead of the .pls file but either should work.  Entering
"http://" at the beginning of the URL is optional.  To edit or delete a station,
highlight the station and choose "Edit Station" or "Del Station" from the menu.

Devices with built in WiFi can connect to the stream by selecting "WiFi Connection"
from the "Network" menu option.  If your device does not have Wifi, you will
receive an error such as "Max Tunnel Timeout".

NOTE: Internet Radio may not work with all carriers - some carriers may limit
the amount of data you can receive at one time or they may block this feature
all together.


Registration
------------
The trial version lasts for 3 days or 30 song plays, whichever comes first.
After that you will need to purchase a registration code to continue
using the program.  After you have received your registration code,
enter your registration code and choose the "Register" button.

If you find that your registration code doesn't work, please email
us your name, order number, and your BlackBerry PIN.  To locate the
PIN, go to the BlackBerry home screen and the select Options>Status
or Tools>Settings>Status (depending on your model).


Deleting Songs from the BlackBerry
----------------------------------
There are two ways to delete songs from BerryTunes.  You can either
delete them one by one on the BlackBerry or you can delete all the
songs at once using the MP3 Browser.

To delete a single song, highlight it on the BlackBerry and use the
"Delete" option from the menu.

To delete all the songs, connect the USB cable and use the "Device"
menu to "Delete All".

The BlackBerry can be slow to recover unused storage space.  If you
find this is the case, reset the BlackBerry by pressing ALT-CAP-DEL
or use the "Reset" option in the MP3 Browser while the BlackBerry is
connected via the USB cable.  You could also remove the battery. ;-)


BlackBerry Keyboard Shortcuts
-----------------------------
Spacebar = Play/Stop
Del = Move Up
Enter = Move Down
Alt+Scroll = Move selected song up or down

Volume buttons on the side of the BlackBerry can be used to adjust volume.

Troubleshooting
---------------
Problem:
You can't connect to the BlackBerry via USB

Solution:
Make sure that you have BerryTunes open on the BlackBerry.  It's not
enough to have the program installed, the BerryTunes screen should
be visible on the BlackBerry when transferring files.

Problem:
You get an error when trying to convert the MP3 file

Solution:
BerryTunes can read most MP3 formatted files except for files encoded
in "Free Format".  If you have a free formatted MP3, you will need to
use another program to convert it to a more conventional format.

Acknowledgments
---------------
LAME MP3 Encoder - mp3dev.org
Nuvola Icons - icon-king.com

Software Developer
------------------
Virtual Views
Copyright (c) 2006
All rights reserved.
berrytunes@virtualviews.com