Jamroom Logo Jamroom 5 Core
is now Open Source!
Follow Jamroom on Twitter!

Installing the Jamroom Bonus Pack Index Installing the Jamroom Power Pack

Installing the Jamroom LOFI Creator

If you are a licensed user of Jamroom, the Jamroom Bonus Pack contains a very useful feature called the “LOFI Creator”. It’s a plug-in that allows an artist to create a new LOFI song file out of an uploaded HIFI song file. It requires the “LAME” mp3 encoder/decoder binary to be installed on your system, and only works with MP3 files. Here are instructions on installing LAME, and setting up the Jamroom LOFI Creator.

Installing LAME

The first thing to do is to make sure your system meets the Jamroom LOFI Creator requirements:
  • You are running Linux, or some flavor of UNIX.

These instructions assume that you are running a Linux Based server - note that the installation is the same on other UNIX like operating systems (such as FreeBSD, Solaris, etc.) - however, you will need to compile your own version of LAME for your platform.

The next step in setting up the Jamroom LOFI Creator is to download the "LAME" (LAME Ain't an MP3 Encoder) pre-compiled Binary from the Jamroom "Extras" download page:

http://www.jamroom.net/Downloads_Extras

After downloading, unzip the archive, and upload the "lame" file inside into your Jamroom directory on your server.

Change permissions on the jamroom/lame file to 555. 

 

Configuring Jamroom

  • Log in to your Jamroom as the Master Admin, and go to the Admin Menu -> System Config section.
  • Click on "Custom Buttons" link from the System Config menu, then click on the "Create Button" button.  There are 3 values that will need to be filled in on this page in order to create the "LOFI Creator" button. Place the following values in their corresponding fields:
    • Button Label → lofi creator (or whatever you wold like to call it)
    • Button URL → decoder.php?mode=menu
    • Button Quota → choose the Profile Quota(s) you want this option to be available to.  It is recommended that you only show the LOFI Creator to Artist Quotas, as the Member Quotas do not have access to create Songs.
  • Click on the "Create Button" form submit button and your Custom Button has been created!
     

Alternate Config Files

The "decoder.php" script also features the ability to use alternate config files.  By default, if no "config" URL variable is passed in to the decoder.php script, the default decoder.cfg.php config file will be used, which is located in the jamroom/config directory.  To create an "alternate" config file, simply copy the default decoder.cfg.php file to a different name (like "new_decoder.cfg.php" for example).  Then, when creating your Custom Button, you can define the alternate config file:

decoder.php?mode=menu&config=new_decoder.cfg.php

This tells the decoder.php script to use the "new_decoder.cfg.php" config file for its configuration, instead of the default config file.  This allows you to create different LOFI Creators on your system (i.e. for different bit rates, acoustic modeling, etc.)

Troubleshooting

Now that you have created the new LOFI Creator, here are some tips on it’s use:

  • The faster the processor in your server, the quicker the conversion process will be. Note that while LAME is doing the actual conversion of the HIFI file to a LOFI file, it will eat up a significant amount of your CPU time, so it’s recommended that servers with fast processors utilize the LOFI Creator. On my Pentium II 400 development system (very slow by today’s standards) it takes well over 1 minute to convert a 5 megabyte MP3 file. On a Pentium 4 2400 MHz system, it takes about 25 seconds. On a Dual Xeon server, it takes about 10 seconds.
  • Note that your users will not have any choices in the LOFI Creator if they have not uploaded any HIFI song files.
  • If you get an error that Jamroom is unable to find the LAME binary, ensure that the LAME binary (called “lame”) is located in your Jamroom directory (i.e. jamroom/lame) and is executable (permissions of 555 at least) by the web user.

If you have any more questions about the LOFI Creator, visit the Jamroom Forums and post your issue. Thanks!


Installing the Jamroom Bonus Pack page 18 of 171 Installing the Jamroom Power Pack
Solutions Products Support Community Company
Social Media Platform
Social Networking Software
Musician Website Manager
Community Builder
Jamroom 5
Jamroom 5 Modules
Jamroom Marketplace
Support Forum
Documentation
Support Center
Contact Support
Community Forum
Member Sites
Developers
About Us
Contact Us
Privacy Policy
©2003 - 2018 The Jamroom Network