files necessary to build dmg

osx/Install/Read Me First!.rtfd/TXT.rtf

@@ -0,0 +1,186 @@
+{\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf410
+{\fonttbl\f0\fswiss\fcharset77 Helvetica;\f1\fswiss\fcharset77 Helvetica-Bold;\f2\fswiss\fcharset77 Helvetica-BoldOblique;
+}
+{\colortbl;\red255\green255\blue255;}
+{\*\listtable{\list\listtemplateid1\listhybrid{\listlevel\levelnfc0\levelnfcn0\leveljc2\leveljcn2\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{decimal\}.}{\leveltext\leveltemplateid0\'02\'05.;}{\levelnumbers\'01;}}{\listname ;}\listid1}
+{\list\listtemplateid2\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc2\leveljcn2\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{disc\}}{\leveltext\leveltemplateid0\'02\'05.;}{\levelnumbers\'01;}}{\listname ;}\listid2}
+{\list\listtemplateid3\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc2\leveljcn2\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{disc\}}{\leveltext\leveltemplateid0\'02\'05.;}{\levelnumbers\'01;}}{\listname ;}\listid3}
+{\list\listtemplateid4\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc2\leveljcn2\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{disc\}}{\leveltext\leveltemplateid0\'02\'05.;}{\levelnumbers\'01;}}{\listname ;}\listid4}
+{\list\listtemplateid5\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc2\leveljcn2\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{disc\}}{\leveltext\leveltemplateid0\'02\'05.;}{\levelnumbers\'01;}}{\listname ;}\listid5}
+{\list\listtemplateid6\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc2\leveljcn2\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{disc\}}{\leveltext\leveltemplateid0\'02\'05.;}{\levelnumbers\'01;}}{\listname ;}\listid6}}
+{\*\listoverridetable{\listoverride\listid1\listoverridecount0\ls1}{\listoverride\listid2\listoverridecount0\ls2}{\listoverride\listid3\listoverridecount0\ls3}{\listoverride\listid4\listoverridecount0\ls4}{\listoverride\listid5\listoverridecount0\ls5}{\listoverride\listid6\listoverridecount0\ls6}}
+\margl1440\margr1440\vieww12180\viewh16560\viewkind0
+\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
+
+\f0\fs24 \cf0 {{\NeXTGraphic ff_logo_final_300.tif \width6000 \height1560
+}¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
+\cf0 \
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+\cf0 \
+\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
+
+\f1\b \cf0 Welcome to the Firefly Music Server!\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f0\b0 \cf0 \
+This is the 1.0b3 release of Firefly for Macintosh.  When you install this package, the Firefly server software will be installed, along with a System Preferences pane that allows for easy configuration of the server.\
+\
+Although we have tested this software and don't anticipate problems, please keep in mind that it is considered a beta release.  It is always a good idea to have a current backup before installing new software.\
+\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 VERY IMPORTANT\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f0\b0 \cf0 If you have run a previous version of Firefly for Macintosh, it must be un-installed before installing 1.0b3.  If you do not uninstall the previous version, Firefly will not work properly.  See the section "Installing Firefly" below for details.\
+\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 System Requirements
+\f0\b0 \
+This 1.0b3 release of Firefly runs on PowerPC and Intel Macintosh computers running MacOS 10.3.9 or later.\
+\
+
+\f1\b Features of Firefly
+\f0\b0 \
+The Firefly music server makes it possible to share your music library over the network with other computers, and with compatible devices like the Roku\'aa SoundBridge\'aa and Pinnacle\'aa SoundBridge\'aa.  \
+\
+The server runs in the background (with no menus or windows) when you are logged in to your computer, and does not require your music library software to be open in order to function.  All common configuration options are available from the Firefly icon that will be available in System Preferences after installation.\
+\
+If you share the folder containing your iTunes library file, Firefly will read all of your playlists from the library and make them available, including your iTunes Smart Playlists and any playlists that contain Internet radio stations (SoundBridge software version 2.5.173 or later is required to play Internet radio stations displayed by Firefly).\
+\
+As an option, users may enable a Status Item in the menu bar (a small icon near the right end of the menu bar) to check Firefly's status and start and stop the server.\
+\
+
+\f1\b Installing Firefly
+\f0\b0 \
+Previous versions of Firefly for the Mac used Apple's installer, and put multiple files in multiple locations.  This process was error-prone, and caused problems for non-administrative users.  Installation of b3 is dramatically simpler.  Please follow these two simple steps:\
+\
+\pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
+\ls1\ilvl0\cf0 {\listtext	1.	}Please double-click the "Uninstall Firefly" item.  This is a compiled AppleScript that will shut down your existing Firefly installation and move all of its components to a folder called "firefly-uninstall" in the Trash.  If you were not running a prior version of Firefly, you don't need to run this script, but it won't hurt to do so.  
+\f1\b Users of previous versions 
+\f2\i must
+\f1\i0  run this script
+\f0\b0 , or 1.0b3 will not work properly.  If for some reason an error occurs when using the script, and if you had a previous version of Firefly installed, you must follow the manual uninstallation instructions, which appear later in this document.\
+{\listtext	2.	}Double-click the Firefly.prefPane icon.  This will launch the System Preferences application, which will then offer to install the Preferences pane.  The System Preferences application will ask you to choose whether to make the pane available to just the current user, or to all users.  This choice is up to you.  If you choose to make it available to all users, then any user who logs into the system will be able to configure and run Firefly for their own library.  Otherwise, only the user who installed the software will be able to run it.\
+\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+\cf0 After installation, the System Preferences application will open the Firefly pane, so that you may configure Firefly before starting it.  By default, Firefly will choose the name "<your name>'s Firefly on <your computer>", and will look for music in the Music folder in your home directory.  It will not require a password for devices or computers to play music from your library.  And, it will be set to run whenever you are logged in.  You may change any of these options at this time, before running Firefly for the first time.  If you decide to change them later, just open System Preferences and make your changes, then click the Apply Now button.\
+\
+Once you have confirmed Firefly's settings, click the Start Firefly button.  If you have set Firefly to automatically start when you are logged in, you will only need to do this step this one time.  If you choose to start Firefly manually, you will need to click this button whenever you want to start Firefly.\
+\
+Note that a user must be logged in for his/her library to be shared (although, if using Fast User Switching, they need not be the active user).\
+\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 A note to users of earlier versions\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f0\b0 \cf0 Because this installation is so different from previous beta versions of Firefly, it was not feasible to try to preserve the settings from earlier versions.  Therefore, the uninstall script removes all previous Firefly files, including your stored settings.  You will need to re-enter your configuration choices after installing Firefly for Macintosh 1.0b3.  Happily, this is a very simple process that takes only a few seconds.  \
+\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 Features added since 1.0b2
+\f0\b0 \
+This release has some exciting new features:\
+\pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
+\ls2\ilvl0\cf0 {\listtext	\'a5	}Apple Lossless audio files can now be played to SoundBridge client.  Firefly will "transcode" (convert on the fly) these files to uncompressed audio with no loss in quality.  You will notice if you get an Apple Lossless song's information on the SoundBridge's display that they show up as "WAV audio file".  This is expected, because Firefly is transcoding to WAV format.\
+{\listtext	\'a5	}Added the ability to show a Firefly Status Item (a small icon/menu at the right side of the menu bar) to check Firefly's status and start and stop the server, without opening the Preferences pane.  This is controlled by a check-box in the Preferences pane.\
+{\listtext	\'a5	}Added a "Log" tab to the Preferences pane to allow viewing the detailed log information from the server (helpful to diagnose any problems that may arise)\
+{\listtext	\'a5	}Much simpler installation process -- all Firefly server components reside within the single Firefly.prefPane file.  Please carefully follow the installation instructions above.\
+\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 Issues fixed since 1.0b2\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f0\b0 \cf0 This release fixes several issues that were present in 1.0b2:\
+\pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
+\ls3\ilvl0\cf0 {\listtext	\'a5	}The release now works on 10.3.9 as well as 10.4.  Although we had hoped to provide support on MacOS 10.2, that is no longer planned.  So much changed on MacOS between 10.2 and 10.3 that maintaining compatibility with that old system is not practical.\
+{\listtext	\'a5	}The server installation is now one file (as noted above).\
+{\listtext	\'a5	}The server can now be installed either for all users of the computer, or for individual users.\
+{\listtext	\'a5	}The server can now be installed by non-admin users.\
+{\listtext	\'a5	}The server will now work properly even if multiple users are logged into the same Macintosh,  each running their own copies of Firefly.\
+{\listtext	\'a5	}The default name for the library now includes the user's name, in order to make it unique in cases where multiple users are logged in.\
+{\listtext	\'a5	}The server will now return playlist contents in the correct track order\
+{\listtext	\'a5	}Generally, the communication between the Preferences pane and the server is much more robust and tolerant of errors.  The correct status should be displayed even if the server were to be shut down by means other than the Preference pane, and so on.  The server's state is also correctly shown as "starting" during the initial scan, before the server has registered itself on the network.\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 \
+Issues fixed since 1.0b1\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f0\b0 \cf0 1.0b2 fixed several issues that were present in 1.0b1, so if you are updating from 1.0b1, the following issues are also fixed:\
+\pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
+\ls4\ilvl0\cf0 {\listtext	\'a5	}Fixed a bug that caused the Preferences pane crash if the user's library name contained a non-ASCII character.\
+{\listtext	\'a5	}Fixed a problem where clicking the Firefly logo in the Preferences pane failed to open the fireflymediaserver.org web page.\
+{\listtext	\'a5	}Eliminated a spurious "restarting" message if the Preferences pane was closed with unsaved changes, but the server was not running.\
+{\listtext	\'a5	}Fixed a problem in the installer that prevented installation in non-admin accounts.  Installer now requires administrator password to install.\
+{\listtext	\'a5	}This version of Firefly, combined with the RC3 (2.5.171) release of SoundBridge software, now properly handles protected AAC files, and will properly skip files un-checked in iTunes if that option is enabled on the SoundBridge.\
+{\listtext	\'a5	}This version features improved performance when scanning the iTunes library XML file.\
+{\listtext	\'a5	}The server features a new and updated web user interface.\
+{\listtext	\'a5	}Server does not attempt to transcode Apple Lossless files when playing to an iTunes client.\
+{\listtext	\'a5	}Various other fixes.\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+\cf0 \
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 Known Issues
+\f0\b0 \
+There are a small number of known limitations and issues with this version that will be addressed in a later release:\
+\pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
+\ls5\ilvl0\cf0 {\listtext	\'a5	}The System Preferences pane is currently only localized into English.  Now that the UI is stabilized, localization has begun.\
+{\listtext	\'a5	}If you manually edit the configuration file to add multiple music directories, the System Preferences pane will display incorrect information in the Library Location.  However, it should not disturb your settings if you don't try to use the pane to change the location.\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+\cf0 \
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 What is Running?
+\f0\b0 \
+If you look at the list of running processes on your computer while Firefly is running (for example, by using the "Activity Monitor" utility) it is normal to see three Firefly-related items.  There should be a program running called "Firefly Helper", and two processes called "firefly".  These all run completely in the background, and will not show up in the Dock.  They are normally only visible in the Activity Monitor utility.\
+\
+
+\f1\b Uninstalling Firefly\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f0\b0 \cf0 If you should decide that you want to uninstall Firefly, the easiest way to do so is to simply re-run the "Uninstall Firefly" script that is on the installation disk image.  If, however, you need to uninstall it manually, then please follow the steps in the next section.\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 \
+Manually Uninstalling Firefly 1.0b1, 1.0b2 or 1.0b3
+\f0\b0 \
+If you should decide that you want to uninstall Firefly, please follow these steps:\
+\pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
+\ls6\ilvl0\cf0 {\listtext	\'a5	}Open System Preferences and click on the Firefly icon\
+{\listtext	\'a5	}If Firefly is running, click "Stop Firefly"\
+{\listtext	\'a5	}If you are running Firefly 1.0b3, un-check the "Show Firefly menu in menu bar" box\
+{\listtext	\'a5	}Change the "Start Server" option to "Manually", and click Apply Now\
+{\listtext	\'a5	}Close System Preferences\
+{\listtext	\'a5	}In the Finder, open your home folder\
+{\listtext	\'a5	}Open the folder called Library\
+{\listtext	\'a5	}Open the Application Support folder\
+{\listtext	\'a5	}Drag the Firefly folder inside Application Support to the Trash\
+{\listtext	\'a5	}If you installed 1.0b3 for the current user only, or if removing 1.0b1 or 1.0b2:\
+\pard\tx720\tx740\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
+\ls6\ilvl0\cf0 {\listtext	\'a5	}Go back up one level to your Library folder\
+\pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
+\ls6\ilvl0\cf0 {\listtext	\'a5	}If you installed 1.0b3 for all users:\
+\pard\tx0\tx740\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+\ls6\ilvl0\cf0 {\listtext	\'a5	}Open the window for your hard disk drive, and within that window, open the Library folder\
+\pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
+\ls6\ilvl0\cf0 {\listtext	\'a5	}Open the PreferencePanes folder\
+{\listtext	\'a5	}Drag Firefly.prefPane to the Trash\
+{\listtext	\'a5	}Restart your computer, or log out and log in again\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+\cf0 \
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+
+\f1\b \cf0 A Note to Expert Users
+\f0\b0 \
+Expert users who have made manual changes to their configuration file may do so again.  If you want to refer to your old configuration file, it's in the "firefly-uninstall" folder in the Trash.\
+\
+Please note that the layout of files on disk has changed significantly.  The configuration file (now called "firefly.config"), the songs database and the log file (now "firefly.log") still live in ~/Library/Application Support/Firefly, and the pane itself is either in ~/Library/PreferencePanes or /Library/PreferencePanes, depending upon whether you chose to make Firefly available to the current user or to all users, respectively.  \
+\
+However, the plugins folder and the transcoding scripts and binaries are now built into the Preference pane's bundle.  To find them, open the folder containing the preference pane and either right-click or control-click on the Firefly.prefPane icon.  Choose "Show Package Contents".  Open the "Contents" folder in the resulting window.  You should see the Firefly Helper application.  Repeat this process with the Firefly Helper, to view its contents.  Within the Firefly Helper's Contents folder, in a folder called "Server", you will find all of the components of the Firefly server itself, as well as the plugins and helper binaries.  Please be careful when modifying the contents of these bundles.\
+\
+}