FireFly Setup (iTunes)
FireFly (iTunes Server) Setup (Joe's version)
Minimum Requirements: FreeNAS 8.0.3-MULTIMEDIA, establish your iTunes media directory.
NOTE: pool = your pool name, change it, don't just cut and paste unless your pools name really is "pool".
If you have upgraded your FreeNAS software with a newer or older version you may skip steps 1 and 5.
1. Setup a user for this event, I will use 'iTunes' as the user name:
Username: iTunes
Primary Group ID: wheel
Home Directory: /mnt/pool/home/iTunes
Shell: csh
Full Name: iTunes
2. SSH or use console for the remainder.
3. Log in as iTunes. You should be in the "/mnt/pool/home/iTunes' directory.
4. Type 'echo $HOME' and verify the path is correct '/mnt/pool/home/iTunes'. If not, go back and fix it.
5. Type (hit RETURN) after each line
Code:
mkdir -p "$HOME/var/db/mt-daapd"
chown iTunes "$HOME/var/db/mt-daapd"
6. Now because you cannot execute the next command without being root, let's log in as SU.
7. Now that we are root you need to change your HOME directory so the rest or the code will need to be entered manually and I like simple. Cut & paste & edit the pool section
Code:
set HOME="/mnt/pool/home/iTunes"
8. Verify it by typing "echo $HOME" and it should match up with the previous one we did.
8a. If this is an upgrade then you already have mt-daapd.conf however you should still copy the newer version over. Before proceeding you should write down your settings that we change in step 10. Go ahead and type ee mt-daapd.conf and you will be able to view this file. Press Escape to exit. Now continue on to step 9 to copy the correct version over to your hard drive.
9. Do these two lines, hitting return after each one
Code:
mount -wu /
cp /conf/base/etc/local/mt-daapd.conf .
10. You now need to make some changes to the mt-daapd.conf file
Type
Change:
admin_pw=root password
runas = iTunes
db_parms = /mnt/pool/home/iTunes/var/db/firefly
mp3_dir = /mnt/pool/music
NOTE: Remove the hash "#" from in front of the mp3_dir=/mnt/pool/music if it exists.
admin_pw : administrator password.
db_parms : path for the where the iTunes/Firefly database should be.
mp3_dir : directory for where the mp3s, etc can be found.
servername : name of the iTunes share.
------
Activation
11. Now lets set it up to run on reboot... Type:
Code:
cd /conf/base/etc
ee rc.conf
Depending on what version you are running (8.0.4 does not have mt_daapd_enable)
Locate mt_daapd_enable="NO" and change it to "YES". (NOTE: If this parameter does not exist, it's not needed)
If firefly_enable does not exist, add firefly_enable="YES"
Locate mtdaapd_flags="-c /mnt/tank/home/myuser/mt-daapd.conf" and change to "-c /mnt/pool/home/iTunes/mt-daapd.conf"
OR Locate firefly_flags="-c /mnt/tank/home/myuser/mt-daapd.conf" and change to "-c /mnt/pool/home/iTunes/mt-daapd.conf"
Press Escape and save the file.
12. Now lets enable the current running files, similar to the previous step.
Type:
Depending on what version you are running (8.0.4 does not have mt_daapd_enable)
Locate mt_daapd_enable="NO" and change it to "YES". (NOTE: If this parameter does not exist, it's not needed)
If firefly_enable does not exist, add firefly_enable="YES"
Locate mtdaapd_flags="-c /mnt/tank/home/myuser/mt-daapd.conf" and change to "-c /mnt/pool/home/iTunes/mt-daapd.conf"
OR Locate firefly_flags="-c /mnt/tank/home/myuser/mt-daapd.conf" and change to "-c /mnt/pool/home/iTunes/mt-daapd.conf"
Press Escape and save the file.
13. We must alter the boot restored mt-daapd file to make it run properly.
Code:
cd /conf/base/etc/local/rc.d
ee mt-daapd
Now you must change command_args="-c /mnt/pool/home/iTunes/mt-daapd.conf"
And change required_files="/mnt/pool/home/iTunes/mt-daapd.conf"
Press Escape and save the file.
14. We must alter the current mt-daapd file so we can test run the system.
Code:
cd /etc/local/rc.d
ee mt-daapd
Now you must change command_args="-c /mnt/pool/home/iTunes/mt-daapd.conf"
And change required_files="/mnt/pool/home/iTunes/mt-daapd.conf"
Press Escape and save the file.
15. Last is to add the user daapd (NOTE: Not needed for 8.0.4, should not be needed for 8.0.3 but not tested without it)
16. Close the protected flash drive files, type
-----
Testing
17. Type
Code:
service mt-daapd start
and cross your fingers. You should see the service running. I don't use iTunes so I could test to see how it functioned so I would appreciate some feedback.
18. If it all worked, type reboot and see if it still works.
Extra Configuration Information
The following is some additional configuration information for the mt-daapd.conf file. This comes from the original notes in the config file before it was slimmed down. Keep in mind that we did change some of these values above.
Code:
[general]
#
# web_root (required)
#
# Location of the admin web pages.
#
# If you installed from .RPM, .deb, or tarball with --prefix=/usr, then
# this is correct.
#
# If you installed from tarball without --prefix=/usr, then the correct
# path is probably /usr/local/share/mt-daapd/admin-root.
#
web_root = /usr/share/mt-daapd/admin-root
#
# port (required)
#
# What port to listen on. It is possible to use a different
# port, but this is the default iTunes port
#
port = 3689
#
# admin_pw (required)
#
# This is the password to the administrative pages
#
admin_pw = mt-daapd
#
# db_type (required)
#
# This is what kind of backend database to store the song
# info in. Valid choices are "sqlite" and "sqlite3".
#
db_type = sqlite3
#
# db_parms
#
# This is any extra information the db needs to connect.
# in the case of sqlite and sqlite3, this is the name
# of the directory to store the database in
#
# If you installed from RPM or .deb, this path likely already
# exists. If not, then you must create it. The directory itself
# must be writable by the "runas" user.
#
db_parms = /var/cache/mt-daapd
#
# mp3_dir (required)
#
# Location of the mp3 files to share. Note that because the
# files are stored in the database by inode, these must be
# in the same physical filesystem.
#
mp3_dir = /home/media/music
#
# servername (required)
#
# This is both the name of the server as advertised
# via rendezvous, and the name of the database
# exported via DAAP. Also know as "What shows up in iTunes".
#
servername = Firefly %v on %h
#
# runas (required)
#
# This is the user to drop privs to if running as
# root. If mt-daapd is not started as root, this
# configuration option is ignored. Notice that this
# must be specified whether the server is running
# as root or not.
#
# This is also ignored on Windows.
#
runas = mt-daapd
#
# password (optional)
#
# This is the password required to listen to MP3 files
# i.e. the password that iTunes prompts for
#
#password = mp3
#
# extensions (optional)
#
# These are the file extensions that the daap server will
# try to index and serve. By default, it only indexes and
# serves .mp3 files. It can also server .m4a and .m4p files,
# and just about any other files, really. Unfortunately, while
# it can *attempt* to serve other files (.ogg?), iTunes won't
# play them. Perhaps this would be useful on Linux with
# Rhythmbox, once it understands daap. (hurry up!)
#
# Failing that, one can use server-side conversion to transcode
# non-standard (.ogg, .flac) music to wav on the server side.
# See the ssc_* options below.
#
# To be able to index .ogg files, you'll need to have configured
# with --enable-oggvorbis. For .flac, --enable-flac, for .mpc,
# --enable-musepack.
#
extensions = .mp3,.m4a,.m4p,.ogg,.flac,.mpc
#
# ssc_codectypes (optional)
#
# List of codectypes for files that the daap server should
# perform internal format conversion and present to clients
# as WAV files. The file extensions that these codectypes correspond
# to must also be present in 'extensions'
# configuration value, or files are not probed in the first
# place.
#
# Valid codectypes:
#
# mp4a - for AAC (.aac, .mp4, .m4a, .m4p)
# mpeg - for mp3
# wav - for wav
# wma - for wma
# ogg - for ogg
# flac - for flac (.flac, .fla)
# mpc for musepack (.mpc, .mpp, .mp+)
# alac for alac (.m4a)
#
# Not needed because ffmpeg is enabled (all file types transcoded to wav.
# If this behavior is undesired, see the [plugins] section and disable it,
# or selectively disable codecs below with the never_transcode option.)
# -joshk
# ssc_codectypes = ogg,flac,alac
# never_transcode (optional)
# Comma separated list of formats to never transcode. (Nothing by default)
# never_transcode = ogg
#
# ssc_prog (optional)
#
# Program that is used in server side format conversion.
# Program must accept following command line syntax:
# ssc_prog filename offset length ...
# Parameter filename is the real name of the file that is
# to be converted and streamed, offset is number of bytes
# that are skipped from the beginning of the _output_ file
# before streaming is started, length is length of the song
# in seconds (or zero). All other possible arguments must
# be ignored. The resulting wav file (or the rest of
# the file after initial seek) is written to the standard
# output by the ssc_prog program. This is typically
# a script that is a front end for different conversion tools
# handling different formats.
#
# ssc_prog = /usr/bin/mt-daapd-ssc.sh
#
# logfile (optional)
#
# This is the file to log to. If this is not configured,
# then it will log to the syslog.
#
# Not that the -d <level> switch will control the log verbosity.
# By default, it runs at log level 1. Log level 9 will churn
# out scads of useless debugging information. Values in between
# will vary the amount of logging you get. However, you must log
# to a file to see this debugging information (debug information will
# not appear in syslog.)
#
#logfile = /var/log/mt-daapd.log
#
# rescan_interval
#
# How often to check the file system to see if any mp3 files
# have been added or removed.
#
# if not specified, the default is 0, which disables background scanning.
#
# If background rescanning is disabled, a scan can still be forced from the
# "status" page of the administrative web interface
#
# Setting a rescan_interval lower than the time it takes to rescan
# won't hurt anything, it will just waste CPU, and make connect times
# to the daap server longer.
#
#
#rescan_interval = 300
# always_scan
#
# The default behavior is not not do background rescans of the
# filesystem unless there are clients connected. The thought is to
# allow the drives to spin down unless they are in use. This might be
# of more importance in IDE drives that aren't designed to be run
# 24x7. Forcing a scan through the web interface will always work
# though, even if no users are connected.
# always_scan = 0
#
# scan_type
#
#
# This sets how aggressively mp3 files should be scanned to determine
# file length. There are three values:
#
# 0 (Normal)
# Just scan the first mp3 frame to try and calculate size. This will
# be accurate for most files, but VBR files without an Xing tag will
# probably have wildly inaccurate file times. This is the default.
#
# 1 (Aggressive)
# This checks the bitrates of 10 frames in the middle of the song.
# This will still be inaccurate for VBR files without an Xing tag,
# but they probably won't be quite as inaccurate as 0. This takes
# more time, obviously, although the time hit will only happen the
# first time you scan a particular file.
#
# 2 (Painfully aggressive)
# This walks through the entire song, counting the number of frames.
# This should result in accurate song times, but will take the most
# time. Again, this will only have to be incurred the first time
# the file is indexed.
#
scan_type = 2
#
# compress
#
# Whether to use gzip content-encoding when transferring playlists etc.
# This was contributed as a patch by Ciamac Moallemi just prior to the 0.2.1
# release, and as such, hasn't gotten as much testing as other features.
#
# This feature should substantially speed up transfers of large databases
# and playlists.
#
# It will eventually default to 1, but currently it defaults to 0.
#
#compress = 0
[plugins]
plugin_dir = /usr/lib/mt-daapd/plugins
plugins = rsp.so,ssc-ffmpeg.so
[scanning]
# should playlists be processed at all?
#
process_playlists = 1
# should itunes xml files be processed?
#
process_itunes = 1
# should m3u files be processed?
#
process_m3u = 1
-Joe
