I wrote about the Firefly Media Server when we all had firmware 1.1.2. I love the server. In fact, I feel Apple should include such as server by default in every iPod touch!

Unfortunately Firefly (version svn1586-r1) cannot be installed via the Installer successfully as it hasn’t been updated to work in firmware 1.1.3/4. I missed it so much! Fortunately I figured out how to get it installed, and it’s pretty simple.

Requirements:

  • iTunes with the SHARING option enabled.
  • Ulctl by Erica Sudan (it’s in the Installer, under the “Utilities” category)
  • BSD Subsysten (It’s in the Installer, under the “System” category)

 

PART A: INSTALLATION

  1. Launch Installer and go to the “Multimedia” category. You should find the “FireflyMediaServer” package in it. If you can’t find it, then go to the “Sources” category and install the “Community Sources” package first, and try again.
  2. Tap on the “Install” button to start installation of the server — Do *NOT* add it to the queue.
  3. Installation should proceed normally, until this pop-up message appear on the screen. At this point, installation of the server is actually complete. Hit OK to acknowledge the message, and it will start indexing your music… but bang, the Installer returns the “Main script execution failed” error message!

    What’s going on? Well, the Installer went looking for your media files in the var/root/Media folder, but in firmware 1.1.3/4 it’s moved to the var/mobile/Media/ folder! The Installer isn’t expecting the change and halted the entire process!

PART B: RESUMING AND COMPLETIING INSTALLATION

I mentioned the server was actually installed. It’s only the second half of the installation process, indexing your media, that broke and prevented the full completion. So let’s resume it.

  1. Tap “OK” to dismiss the error message.
  2. Exit the Installer and return to the Springboard.
  3. Go to Settings -> General and set “Auto-Lock” to “Never”.
  4. Tap on “Ulctl” to launch it. A blank white screen will show up. Patiently wait for about 5 to 8 seconds and you’ll see a lists of (command-line) apps. Scroll down, look for, and tap on  org.fireflymediaserver.mt-daapd  After that, a slide-up window with 4 options appear; tap on “load -w” and then just “Do it”.
  5. Launch your browser (Firefox, Safari, Internet Exploder) and surf to http://192.168.123.88:3689/ (you must replace “192.168.123.88″ with your own iPod touch IP address and append “:3689/” after it.)
  6. Momentarily your browser will ask you for a user name and password. They are “root” and “dottie” respectively.
  7. You are now at the Media Server status screen. Click on the “Configuration” link on the left sidebar.
  8. At the said configuration screen, look for
    /var/root/Media/iTunes_Control/Music
    and change it to:
    /var/mobile/Media/iTunes_Control/Music
    Click the “Save” button to save the new configuration. (Ignore the “Error: 500general:mp3_dir” message)
  9. At this point, you may change both Admin & Music’s Passwords too if you want to but please leave everything else as is.
  10. Alright, we are ready to index your media! Woohoo! Go back to status screen and click on the “Start Full Scan” button.
  11. Notice the “File Scanner” is running after you click the button. Once it returns to “Idling”, indexing of your meda is complete!
  12. Your iPod touch should show up under the SHARED category in your iTunes. Click on it and enter the Password (default is “dottie” unless you changed it.)
  13. It’s Hammer Time!

 

Checklist:

You can’t uninstall the server via the Installer because as far as the Installer is concerned, it was never (completely) installed! :P

* For those who might wonder, the word “redux” does not mean what it would appear to. It is a Latin word that means “brought back”, “revisited”.

77 Comments

    • momott
    • Posted 1 March 2008 at 19:23
    • Permalink

    Uh… Sorry but what exactly is this fireflymediaserver? I mean what does it do? It does look cool though!

    • RupertGee
    • Posted 1 March 2008 at 20:20
    • Permalink

    @momott

    The Firefly Media Server installed in your iPod touch lets you stream your music to any Mac or PC with iTunes installed. A room full of guests can thus listen to your iPod touch’s music library played through the receiving computer’s speakers.

    It never fails to impress my friends.

  1. Aah so it is installed! I ended up installing it via ssh / sftp to get it working :-)

    Just one thing if you do use the above method - installer may or may not put firefly in ‘uninstall’, so taking it off again will be loads of fun.

    Another tip for this is add ‘BossTool’ and the ‘Firefly’ addin, and you’ll be able to disable/enable it with a quick swipe, instead of using ulctl.

    And one last thing - make a webclip of the control panel on your iPhone/iPod Touch, makes it much easier to return to / edit settings / scan for new files :-)

    • thegpc
    • Posted 1 March 2008 at 21:33
    • Permalink

    Awesome as always! I didn’t know what this was before- I always was just reminded of the show Firefly and would pass over it- but now I really like it.

    One thing you may want to take note of: it actually says before installation starts that you should “install Ulctl to enable/disable Firefly”.

    • RupertGee
    • Posted 1 March 2008 at 21:48
    • Permalink

    @Beau

    Thanks for the great tips!

    I forgot to write about the fact it can’t be Uninstalled via the Installer because as far as the Installer is concerned, it’s never installed. Ha ha. I’ll add this note in later.

    • RupertGee
    • Posted 1 March 2008 at 21:53
    • Permalink

    @thegpc

    I believe Beau was referring to the BossPref app (not BossTool). It’s a handy switch to turn on or off the server.

    But you know what? I never turn it off. It doesn’t seem to kill the battery. Somehow I guess it’s like the OpenSSH package’s ssh where it is smart enough not to do anything until called into action.

    It’s fun to let it just run — I once walked into an Apple Store and the Salesperson ask me how on earth did “Rupert’s iPod touch” showed up in their Mac’s iTunes. Heeheehee. They didn’t even realised it’s connected to iTunes wirelessly and thought it’s ready to sync via the usb cable!

    • thegpc
    • Posted 2 March 2008 at 00:03
    • Permalink

    Rupert-

    I know. I was talking about as Firefly itself was installing, it actually told me to use Ulctl before it downloaded.

    • Phil
    • Posted 2 March 2008 at 00:55
    • Permalink

    thank you verrrrrry much for this article… its an awesome feature!! i love it.

    i didn’t have to make those steps… just installed it from installer and it worked without complications…

  2. Rupert,

    Great blog, mate. Picked up some useful stuff. Keep up the good work.

    gfl

    • noopha
    • Posted 2 March 2008 at 03:35
    • Permalink

    Noob question: In this case, my iTunes can only detect my ipod touch only if my PC has wi-fi right?

    • thegpc
    • Posted 2 March 2008 at 05:24
    • Permalink

    @noopha:

    Yea, you need Wi-Fi for your iPod Touch and Internet access for your computer for this to work. Otherwise, there’s no way to hav any shared music at all on iTunes.

    • momott
    • Posted 2 March 2008 at 10:32
    • Permalink

    Oooooo cool! One question, I can do this with MonkeyMedia without having wifi, just an iPod cable, so how is this better? I am not trying to be annoying, just wondering?

    • thegpc
    • Posted 2 March 2008 at 10:35
    • Permalink

    @Momott:

    Well, if you’re at a party, and you don’t happen to have a cable on you, it’s useful. You don’t have to carry that extra piece of equipment, just the iPod. It’s a bit more convenient that way.

    Also, I don’t think you should need MonkeyMedia to play your iPod’s music from a computer with a USB cable… That’s been a standard feature on iPods since their inception…

    • RupertGee
    • Posted 2 March 2008 at 15:38
    • Permalink

    @momott

    I’m a Mac user and not familiar with MonkeyMedia. I got curious and found MediaMonkey via google instead. I think you’re refering to the later?

    I can’t quite figure out what MediaMonkey actually does. But it looks like it’s not something that’s as popular as iTunes. So in this sense, Firefly will work on more PC than MediaMonkey. Best of all, it’ll just works as long as the PC has wifi or connected to a wifi router and a copy of iTunes and on practically every modern Mac.

    Hmm… I wonder programs like MM is the culprit many pc users can’t jailbreak easily…. They seem to try to outsmart Apple and probably breaks a couple things doing it… resulting in a non-standard compliant setup. Sigh.

    • momott
    • Posted 2 March 2008 at 20:23
    • Permalink

    Oh, I see! Thanks guys. MediaMonkey lets you “reverse sync” so the music would stay on the computer, but only if you had an iPod cable. I see what FireFly is about though and it looks great!

    • momott
    • Posted 2 March 2008 at 22:16
    • Permalink

    Ugh… It says page can not be found. I did all of the earlier steps as you said…

    • thebot
    • Posted 3 March 2008 at 02:31
    • Permalink

    Hey RG, I know this has nothing to do with the topic, but I don’t where to post it.

    On my touch, when i tap the albums list in music, you see all the albums with a thumbnail of the album art on the left right? Well, it seems somehow there’s a mix-up and the wrong art is being show with the album. Like I have Elvis, and it’s showing an album art from Greenday! BUT, when you turn the iPod to the side and view coverflow mode, it reverts back to the right album. Note, that this is only on a dozen or so albums. I checked iTunes and the songs each have the right album art.

    Is this a bug of iTunes? Would installing iTunes 7.6.1 fix this? Damn…

    • RupertGee
    • Posted 3 March 2008 at 09:50
    • Permalink

    @thebot

    That’s something new. My suggestion is you go to Settings -> General -> Reset and tap on “Erase All Content and Settings”. Regrefully that means you’ll have to re-setup everything (email accounts/weather… everything!).

    So… how about try this. The point is we want to erase the media only to get rid of whatever error iTunes accidentally made with regards to album covers. So, change your sync, such that it now sync just one new song. That should make iTunes erased everything in the iPod touch, and add a new song. After that, re-sync your real playlist to put every songs back. Hopefully it’ll work and you don’t have to re-setup everything.

    • RupertGee
    • Posted 3 March 2008 at 09:53
    • Permalink

    @momott

    Did you missed Step B4?

    • Pierre
    • Posted 4 March 2008 at 00:46
    • Permalink

    Thanks a lot dude!

    • noopha
    • Posted 4 March 2008 at 16:53
    • Permalink

    @thebot

    I’ve encountered this problem before having the wrong album artwork for all my albums on my iPod, even in cover flow mode.

    For previous versions of iTunes, you simply need to uncheck the option of syncing album artwork to your iPod and sync it again. However, I don’t see this option anymore in the latest versions of iTunes, so using the 2nd method outlined by Rupert will do.

    • momott
    • Posted 4 March 2008 at 20:07
    • Permalink

    I did that but turned it off later, now I have it working thanks!

    • noopha
    • Posted 5 March 2008 at 01:21
    • Permalink

    @Rupert

    Not very related to the post, but I see in one of the pics here that you have a different ‘now playing music’ icon on the top right hand corner of the status bar.

    May I know what app you used to change it?

    • Joshua
    • Posted 6 March 2008 at 09:15
    • Permalink

    I have just installed this- and it works! But I have noticed that when you power off and turn it back on the music doesn’t show up in iTunes. So you have to go into Ulctl, select org.fireflymediaserver.mt-daapd and then “load-w” then “Do It!”

  3. This is a very good blog…best ever… Btw, i’ve install Ultcl and firefly with BDS sub, but when i open the ULtcl, it shows up a blank screen and then go back to Springboard. Could sumone please tell me wut happens there ? Much appreciate!!

    • RupertGee
    • Posted 8 March 2008 at 08:16
    • Permalink

    @noopha

    Grin. I didn’t change that. You’ll get that button only in some mode of view. Try navigating in the Music Player and it should show up. :)

    • RupertGee
    • Posted 8 March 2008 at 08:18
    • Permalink

    @ Joshua

    The “-w” command is suppose to make the server stay alive across booting, but I think it’s broken in 1.1.3/1.1.4. Unfortunately I don’t know how to fix it. It seems alrite though; it saves us the hassle of turning off the server.

    • RupertGee
    • Posted 8 March 2008 at 08:20
    • Permalink

    @Leo

    Maybe you have to reboot your iPod touch first?

    Give me a tinker if that doesn’t work. I have an alternative method to activate it.

  4. I rebooted it, but it doesnt work at all…. any clues Geezzz ?

    • RupertGee
    • Posted 8 March 2008 at 08:37
    • Permalink

    @leo

    You can install and use the Boss Prefs app. It’s in the Installer’s Utilities category. You’ll need its Firefly Control plugin too.

    After installing both, just launch BossPrefs to turn on the Firefly server.

    It’s actually more elegant to use than Ulctl.

  5. WOOOOOOOOHOOO! I got it..and u’re elegant…not the method! cheers man and all da best from Australia!

    • Vanya
    • Posted 8 March 2008 at 11:24
    • Permalink

    thank you very much! Had the same problem as Leo, but now its all good
    ps writing on touch ;)

    • RupertGee
    • Posted 8 March 2008 at 12:03
    • Permalink

    @vanya

    Grin. I’ll update the post later and get everyone to use BossPrefs instead of Ulctl.

    Hey… it’s the weekend. Have you tried Touchpad Pro? It’s good fun!

    http://www.touchpadpro.com/

    Pinch to zoom Firefox is just downright cute. :)

    • Rajesh
    • Posted 8 March 2008 at 20:52
    • Permalink

    I tried to install the firefly. Nut I didn’t follow any of your instructions everything went off smoothly and I was able stream music with no problems. Though I had install the Utcl by Erica to start the service.

    I have an iPod touch 16 GB version 1.1.3

    • JOhn
    • Posted 9 March 2008 at 09:04
    • Permalink

    Dude I’ve searched other websites for fixes on the iPod touch but yours always comes out on top 10 stars for you Thanks man!

    • momott
    • Posted 10 March 2008 at 01:43
    • Permalink

    Hey… look at what I just found. Add this source in installer: http://homepage.mac.com/hartsteins/copycoders/copycoders.xml , once you do this install netservices and restart your ipod. Now all you have to do is open netservices and go to add-ons and flick FF media server to on!

    • thebot
    • Posted 10 March 2008 at 09:32
    • Permalink

    Hey Gee,

    Yesterday, I was looking through coverflow on the touch and wham. I doubled pressed the home button and then a KEYPAD for the iPhone’s calling pad, missed/call history, voicemail, favorites, and contacts came up…obviously the calling feature won’t work, but i was wondering if there is a way to remove this? is this just a byproduct of jailbreaking 1.1.3? Or is this a byproduct of getting the “January software apps update” for free?

    • RupertGee
    • Posted 10 March 2008 at 09:42
    • Permalink

    @thebot

    That’s weird.

    Double-pressing the Home button is suppose to bring up the Play Music Menu:

    http://rupertgee.wordpress.com/2008/01/20/ipod-touchs-pop-up-anywhere-play-music-menu/

    I think your iPod touch wants to be an iPhone. Hee hee.

    I don’t know what to do. Exocise it, perhaps?

    • Vanya
    • Posted 10 March 2008 at 13:20
    • Permalink

    @Rupert
    I’m one step ahead of you. I found it a while ago, downloaded, and now my parents continously get annoyed at me :P
    Though I don’t think it works on PPC’s. Could not connect error.
    So how exactly did you get the blur music icon up the top?
    And do you have any problems sending emails using gmail IMAP on the device? I can receive perfectly, but not send

    • RupertGee
    • Posted 10 March 2008 at 14:43
    • Permalink

    Hey, Touchpad Pro works just fine on my Mac mini G4. I wonder why it doesn’t work for you? In my case, I already was using VNSea to control all my Macs, and because TouchPad Pro uses the same configuration file as VNSea, no setup was needed.

    Erm… which blur music icon are you talking about?

    I only use IMAP gmail, and send is fine.

    • Vanya
    • Posted 10 March 2008 at 15:14
    • Permalink

    Hmm. Maybe cause I have G3? No idea.
    The Now Playing icon. Looks lot better than the standard triangle :P
    Hmm(again).
    Thanks

    • RupertGee
    • Posted 10 March 2008 at 22:57
    • Permalink

    Do you mean that musical note icon next to the battery icon?

    http://rupertgee.files.wordpress.com/2007/12/firefly-cmd098.png

    If so… hahaha. I have no idea how it got there. I definitely didn’t use Customize to change it. I suspect it was the older Mobile Scrobbler? But it sure is nicer than the normal triangle.

    • Vanya
    • Posted 11 March 2008 at 06:49
    • Permalink

    Ah ok. What does Scrobbler do? Can’t download since I’m at school now :p
    I don’t think there are any options in Customize to change it.
    Thanks anyway

    • thegpc
    • Posted 11 March 2008 at 07:04
    • Permalink

    @Vanya:

    MobileScrobbler is a program for iPod Touch and iPhone that works with the “scrobbling” website Last.fm, which just catalogs which songs you listen to, how often, etc, then shares the information and finds you eople with similar interests.

    • Vanya
    • Posted 11 March 2008 at 12:27
    • Permalink

    Thanks! Will definitely try this out!

    • thebot
    • Posted 12 March 2008 at 11:51
    • Permalink

    No. I still get the Play Music Menu. But when I’m in coverflow, and i double press. Then the iPhone features come on! weird. Ill try to make a vid and show ya.

    • Brian
    • Posted 14 March 2008 at 22:16
    • Permalink

    Why are ULTCL and BSD SUBSYSTEM required?

    Can I use NET SERVICES as a replacement for ULCTL to start and stop the service?

    What about BSD SUBSYSTEM?

    By the way, when I tried installing I got errors about not changing password.

    • Vanya
    • Posted 15 March 2008 at 13:06
    • Permalink

    @Brian
    ultcl isn’t necessary. You can download BossPfrefs and the FireFly plugin, which is easier.
    BSD Subsystem is necessary for most apps to work

  6. When I attempt to run Ulctl, the white screen appears and then simply disappears…

  7. ok, uninstalled ULCTL, and NOW my ipod does show up in iTunes, however, NONE OF MY SONGS ARE SHOWING… I rebooted, and uninstalled/reinstalled etc… Any suggestions?

  8. UPDATE: OK, so I went into firefly via safari and I am trying to change the settings to find my music files… however, the folders you indicated don’t exist on my ipod (mobile/Media)? Where are my music files located?

    Thanks!

    • Oli
    • Posted 18 March 2008 at 05:12
    • Permalink

    Thanks alot for this! These are really good instructions.

    • domino
    • Posted 20 March 2008 at 02:15
    • Permalink

    You can also access the administration page of firefly by taping 127.0.0.1:3689 directly in mobilesafari on the iPhone/iTouch.

    Thank you for your tuto! :)

    • Austin
    • Posted 23 March 2008 at 13:32
    • Permalink

    dude thanks. these instuctions are always RIGHT ON. and i love the MC Hammer video. it made my day.
    -AC

    • ppohio
    • Posted 27 March 2008 at 08:32
    • Permalink

    Throw Insomnia on there for a quick way to set our ipod not to sleep when you’re using the Firefly media server. That way you can press the top button to switch the screen off and save some battery power. Works like a charm, and if you’re using BossPrefs as a quick way to flip Firefly on and off, just add the Insomnia icon. Three taps (Bprefs, Firefly, Insomnia) and you’re serving a party.

    Thanks for this post Rupert, I put it off for a while for some reason, but this service is really great.

  9. is there a way to stream music from the ipod to a computer which is NOT on the same subnet? like when I go to my college, the desktops are on a different network(using ethernet cable) than the wifi.

    • noopha
    • Posted 1 April 2008 at 23:50
    • Permalink

    After reading through the comments, I get the idea that I do not need to install ulctl at all. That’s not true right? I still need to install it first, then install Firefly right?

    Can I uninstall ulctl altogether after installing BossPrefs with Firefly plugin?

    • Vanya
    • Posted 2 April 2008 at 15:55
    • Permalink

    @noopha,
    you can. (simple eh?)

  10. For some reason it is only showing a total of 12 songs in itunes when I have a few hundred on my iphone any suggestions? when ever I do a full scan it only loads the 12 songs and then resets my iphone.

    • Vanya
    • Posted 13 April 2008 at 12:45
    • Permalink

    @CJ
    What do you mean by reset? As in respring?

    • Jan
    • Posted 14 April 2008 at 15:09
    • Permalink

    Thanks, i finally got it working! That’s awesome!

  11. thnx m8!!
    u saved my day!!! ^

    • iAm happy now
    • Posted 21 April 2008 at 19:36
    • Permalink

    Thx for this great & simple tutorial!

    I was sure it must be only a little path error in 1.1.3 and 1.1.4. But never knew where to search :/.

    Ps: Firefly does not only work on any PC and Mac with iTunes,it also works great with all versions of the “Roku Soundbridge”!
    thank u verry much
    greetings from swiss

    • Jeff
    • Posted 22 April 2008 at 14:42
    • Permalink

    Thanks alot, it worked great, I was wondering though, when I change music on the iPod, will I have to go back to the IP address and run another “full scan” to get all of the music to appear in the iTunes file shared section? Thanks again for all your help

    • Vanya
    • Posted 22 April 2008 at 18:51
    • Permalink

    @Jeff,
    Yes, anytime you add more music to your iPod, you will need to run the ‘Full scan’

    • Jeff
    • Posted 22 April 2008 at 23:48
    • Permalink

    Thanks Vanya, one more question, after scanning, most of the music plays without a hitch, but about 1/3 of my music doesnt seem to work with the titles being QSAW or other 4 letter nonsense, and the time is listed as “continuous” any idea what that could be or how to fix it? thanks again.

    • ARUS
    • Posted 23 April 2008 at 00:15
    • Permalink

    worked perfectly, big thx. I had exactly the same problem and with your tut I could solve it :)

    • Vanya
    • Posted 23 April 2008 at 16:01
    • Permalink

    To Jeff, do you have any podcasts or radios subscribed to? And by not playing, do you mean that after you sign in iTunes etc?

    • Jeff
    • Posted 24 April 2008 at 02:15
    • Permalink

    Vanya, everything in my library are all songs and encoded in Mp3… I have no audio books or pod casts on there. Its very strange. Most of the songs appear as they should (title and length) and play fine. But some dont play at all and appear as 4 capital letters and have the length listed as “continuous” or “0:00″… this is not the end of the world as I can listen to the majority of my music, but I was just wondering if you knew what it was or if there was a quick fix…Thanks again

    • Vanya
    • Posted 24 April 2008 at 08:04
    • Permalink

    Hmm, sorry, no I don’t know. Maybe the guys at http://www.ipodtouchfans.com/forums/ can give a hand?

    • isbellarch
    • Posted 25 April 2008 at 17:41
    • Permalink

    thank you so much!!!!! firefly was a selling point for convincing my brother to get an iphone, and then 1.1.4 took it away!! not that the iphone needs any extra selling points, but firefly is a pretty awesome app!! thank you!!

    • noopha
    • Posted 27 April 2008 at 01:40
    • Permalink

    @Vanya

    It’s me again, and I want to ask if Firefly will work if my ipod touch and the PC/Mac is connected to 2 different networks?

    How do I do a ‘full scan’ which was mentioned by Jeff above?

    • Vanya
    • Posted 27 April 2008 at 13:34
    • Permalink

    hey Noopha.
    It should work perfectly fine, just streamed to two computers. At the status screen, tap full scan.

    • michael
    • Posted 5 May 2008 at 11:02
    • Permalink

    This was so helpful and clear, thank you for this, it is a very good method for fixing this problem!

    Sent from my iPod

    • Oliver
    • Posted 9 May 2008 at 06:34
    • Permalink

    Thank you very much… my Firefly it’s working great!!!!!

    • Aaron
    • Posted 13 May 2008 at 19:40
    • Permalink

    Thanks a lot - everything seems to be working OK. I too have some songs that are listed as having 0:00 or continuous duration but when I click on them so far every song played without a hitch and the error in the time is self-corrected.

    I love to have total control on the contents of my iphone though - how do I remove Firefly from my machine if I choose to do so? A quick description would be much appreciated.

  12. Aaron, since you never technically ‘installed’ Firefly, you can’t really ‘uninstall’ it.

2 Trackbacks/Pingbacks

  1. By » iPhone iTunes Server on 09 Apr 2008 at 4:54 am

    [...] wenig Googlen hilft ungemein. Dieser Beitrag hat mir ungemein weitergeholfen. Funktioniert übrigens auch mit der 1.1.4 [...]

  2. By Samad’s Blog » Streaming from the iTouch on 14 May 2008 at 2:32 am

    [...] I stumbled across RupertGee’s blog and found instructions to set it up properly. Check it out here. Thanks for posting the instructions, Rupert! Now I can enjoy my music without the need for [...]

Post a Comment

*
*