How to install and setup Jinzora (streaming media server) in OS X

This tutorial will guide you every step of the way through installing and setting up Jinzora, a very robust streaming media server – in OS X.

From the Jinzora site

Jinzora is the ultimate web based media streaming and management system. Streaming your media with Jinzora gives you quick and easy access to your online music and video collection from any device with a web browser. Enjoy your media from your PC, notebook, PDA, Smart Phone, Xbox, PS3 or Wii.

Jinzora supports the following formats – Audio: AAC, M4A, Midi, MP3, MP4, Ogg Vorbis, RM and WMA. Audio (Transcoded): Flac, MPC, WAV, WMA Lossless, WV and SHN. Video: AVI, WMV, MPEG and MOV.

If you’d like to install Jinzora in Windows, Lifehacker has you covered.

  1. Before you install Jinzora, you’ll need to install and setup MAMP (Mac, Apache, MySQL and PHP). Fortunately we have you covered with a tutorial on doing just that in OS X.
  2. Head over to the Jinzora download page and download the Linux version (yes, the Linux version). Extract the files to your Document Root (if you’re using MAMP, the default will be /Applications/MAMP/htdocs/).
  3. Open a Terminal, navigate to /Applications/MAMP/htdocs/jinzora2/ and enter the following 4 commands:

    chmod 777 settings.php
    chmod 777 jukebox/settings.php
    chmod 777 -R temp
    chmod 777 -R data

  4. os x terminal

  5. To start the browser based installation, navigate to index.php in the jinzora2 directory. Again, if you’re using MAMP with the default settings, this will be http://localhost:8888/jinzora2/index.php. Review the info provided on this page, and select your Language: from the drop down list.

  6. click to enlarge

  7. Jinzora will run a check to make sure that your server (Mac) meets the minimum requirements. It will also check for Optional Packages. Some of these won’t be found – don’t worry about it. If the Recommended Settings show up as “red”, you’ll need to edit your php.ini file (found in /Applications/MAMP/conf/php5/php.ini – if you’re using MAMP in the default installation location).

    Open php.ini in a text editor, and scroll to the line:

    memory_limit = 8M ; Maximum amount of memory a script may consume (8MB)

    change it to:

    memory_limit = 64M ; Maximum amount of memory a script may consume (64MB)

    Now look for the line:

    max_execution_time = 30 ; Maximum execution time of each script, in seconds

    and change it to:

    max_execution_time = 300 ; Maximum execution time of each script, in seconds

    Save the file. Click Proceed to License to continue.

  8. click to enlarge

  9. Review the license (yeah right), place a check in the box labeled I Agree to the license terms and click Proceed to Install Type.

  10. click to enlarge

  11. For the Installation Type: select Standalone (the default). For the Jukebox Mode: select Streaming Only. Click to Proceed to Main Settings.

  12. click to enlarge

  13. Here you’ll need to specify a number of settings. The Main Settings are all straight forward. The Frontend: and Style: can be changed later, so don’t stress too much over your selections.

  14. click to enlarge

  15. The Import Settings are very important. Hover your cursor over the Data Structure: drop-down list and a detailed explanation of the options will be displayed.

  16. click to enlarge

  17. I opted for Tag Data as my Data Structure, because I have spent a lot of time tagging my music, but my folder organization is terrible. Again, hover your cursor over the Media Layout: drop-down list for a detailed explanation of the choices.

  18. click to enlarge

  19. I opted for Artist as my Media Layout, but you of course can select the method that works best for you. Click Proceed to Backend Setup when you’ve made all your selections.

  20. click to enlarge

  21. Now you’ll need to specify the info for your database. Your database username and password can be found in your MAMP setup if you’re unsure what they are. Give your database a name (jinzora2, jinzora or something descriptive is a good idea), select MySQL as the Database Type, and unless you’ve already created the database manually, select True from the Create Database: drop-down. Click Continue with Backend Install.

  22. click to enlarge

  23. Assuming everything was successful, click Proceed to Import Media.

  24. click to enlarge

  25. Now it’s time to add your media. Navigate to the top level folder you want to add, and click Analyze. As you’ll note from the screenshot below, I only added some of my music collection (I created a temp folder and moved some albums into it). This was for screenshot purposes only. It can take quite a while to add a large media collection, and you can always add additional folders later.
  26. Once completed, click Proceed.
  27. You can add more media, or continue with the rest of the setup. When you’re done adding media, click Proceed to Save Config.

  28. click to enlarge

  29. If everything was successful, click Proceed to Launch Jinzora.

  30. click to enlarge

  31. Now you’ll be asked if you want to share anonymous stats. I’m a nice guy, so I opted to do just that.

  32. click to enlarge

  33. Click Launch Jinzora.

  34. click to enlarge

  35. Now sign in to Jinzora with the user name and password you specified way back in step #8.
  36. At this point you may receive an error message about your installation not being secure. Move the /Applications/MAMP/htdocs/jinzora2/install folder to somewhere else on your hard drive. Do not delete the install folder, as you’ll need it if you want to add more media folders in the future.

    Refresh the page after you’ve moved the install folder…

  37. click to enlarge

  38. and the admin interface to Jinzora will appear, with all of your media loaded.

  39. click to enlarge

  40. On another computer (or Smartphone etc) load the URL http://ip-of-your-mac:8888/jinzora2

    If your Mac and the “other computer” are on the same local network, the Jinzora login page will appear. If the other computer isn’t on the same network, you’ll need to make sure that port 8888 (the default MAMP web server port) is open/allowed through your firewall. If your Mac is behind a router, check for instructions on forwarding ports on your router.

    After you’ve signed in to Jinzora, click the Play button next to one of your albums/artists/songs. That album/artist/song will start to stream.

  41. click to enlarge

    Windows Mobile interface

    Streaming to Windows Media Player Mobile


To stream certain file types (flac, shn etc), you’ll need to install some additional software. Open settings.php in a text editor (found in /Applications/MAMP/htdocs/jinzora2) and scroll to the // Resampling section.

Change $allow_resample = "false"; to $allow_resample = "true";

Look for the lines:

$path_to_lame = "/usr/local/bin/lame";
$path_to_flac = "/usr/local/bin/flac";

and install flac and lame to those locations. Repeat for each format you want to stream.

If you’re only streaming files across your local network, you can skip the above steps, as Jinzora will ignore resampling requests for local networks. But make sure your internal networks IP addresses are included in the line:

$no_resample_subnets = “(192\.168\..*\..*)|(127\..*\..*\..*)”;

eg. if you use 10. as your internal network IP range, add |(10\..*\..*\..*)”

18 thoughts on “How to install and setup Jinzora (streaming media server) in OS X”

  1. Pingback: Life Clerks » Turn Your Mac into an Internet Jukebox with Jinzora [Music]

  2. Hi there

    Although I enjoyed this article, and got it to work, there were a few problems in these instructions.

    Step 3: from what i found, settings.php does not exist, so I left that command out, and things work fine!

    Step 12: the default database user and password are both “root”

    Step 21: First, I would just zip up the install folder right where it is. Also, the path I assume you meant was /Applications/MAMP/htdocs/jinzora2/install

    Step 23: when you are accessing your computer from another computer on the local network, then the IP address is the local address. However, if the computers are across the net, then the IP address of the host is the public IP address (of the router) and you need to tell the router to forward traffic on that port to the host computer. To get around knowing what your public IP is, I recommend a service called This installs a small piece of software on your computer, and monitors what your Public IP is. It then gives you a regular URL, like, and they will forward that to your public IP.

    Hope this helps!

    Connor P

  3. Connor –

    Thanks for pointing out the mistake re: step 21. I’ve edited the tutorial to include the ‘htdocs’ part :)

    settings.php is one of the most important files for jinzora2, it does exist :) You wouldn’t be able to install without it.

    The default user/pass for MySQL in MAMP are root/root, but most people would have changed those.

    Zipping the install folder is a great idea. But it does need to be moved/removed even if you zip it. is a good call. The earlier part of your comment was covered by step #23 (?).

  4. This reminds me of GNUMP3d for Linux. It’s basically the same idea just not as polished…and well for Linux.

    How well does Jinzora work with streaming to iTunes? iTunes “works” with GNUMP3d but does not auto resolve the addresses.

  5. I have jinzora st up on my server with 300 plus gigs of music.One of my biggest problems that I have had is with streaming m4a files from the server with itunes as the default music player. I can not get the m4as to stream at all. As a fix I converted all of my files to mp3s.That only took two days of work. Any ideas? I have Asked this question on the jinzora site but still have not gotten a good fix.

  6. if settings.php did exist, then it wasn’t in the main folder of jinzora2. I just skipped that command and it installed fine!

    And I left right where it was and it worked fine.

    Also, In step 3: the last two commands didn’t work as written. However when I reversed the positions of the flag (-R) and the permission #’s (777) it worked fine!!


    Connor p

  7. Pingback: How to install and setup Jinzora (streaming media server) in OS X | alternapop, music and macs

  8. Dear Ross,

    First of all, I’d like to thank you for the excellent explanation on how to set Jinzora for the mac (I’ve been struggling with Linux codes and mpd like a madman before this!!!)
    I have two questions for you.
    the first is: I’ve been trying to access my mac from outside my network using its external IP (I’ve already forwarded port 8888 on my router), but it doesn’t seem to work…
    The second is… Have you heard of MPoD for the iphone? Do you have any idea on how to configure it to use Jinzora?

    Thanks a lot!!


  9. I’ve finally gotten to the point where it’s importing my library when I get the following error: “Cannot have signed integers larger than 32-bits in getid3_lib::BigEndian2Int()”

    What is THAT supposed to mean? I’ve got a lot of Japanese music, tagged in Japanese…is that the problem?

    Also, until I set the MySQL root password to blank in phpMyAdmin it refused to create the database. Now, however, I cannot access phpMyAdmin. How can I re-authenticate?

    Also, Gwain, Jinzora IS for Linux. Did you not see where it says to download the Linux version?

  10. Pingback: UndergroundScene » Blog Archive » Internet Jukebox on Your Mac

  11. There is no settings.php file in the jinzora2 directory.

    chmod 777 settings.php
    chmod 777 jukebox/settings.php
    chmod 777 -R temp
    chmod 777 -R data

    The 3rd and 4th command didn’t work either, any ideas?

  12. installation failed at the “backend setup” stage for the “Cannot have signed integers larger than 32-bits in getid3_lib::BigEndian2Int()” error message. and got completely stuck.

    while reinstalling i found it to be completely useless

  13. Pingback: How To Install And Setup Jinzora Media Server In Ubuntu - ScienceArena

  14. Pingback: How To Install And Setup Jinzora Media Server In Ubuntu - Make Tech Easier

  15. Hi Ross–

    Thank you so much for your careful instructions. I never would’ve got this app working without your help. Many thanks to Connor, too, for the additional tips.

    I have one basic question: what’s the reason for using the Linux version of Jinzora rather than the Mac version? Are there any drawbacks to doing it this way as opposed to using the proper Mac version? Any information on the differences would be greatly appreciated.


  16. Pingback: jinzora2 ich weis nicht mehr weiter - Server Support Forum

  17. Pingback: Jinzora Media Server สคลิปทำเว็บเพลง | scriptmasters

Leave a Comment

Your email address will not be published. Required fields are marked *