Readme netjukebox 5

[wbartels]

netjukebox 5 requirements
PHP 5.2.0 or later with extensions: GD2, MYSQL/MYSQLI and PDF
MySQL 4.1.0 or later
httpQ 3.1 or later


Installation
The installation instruction can be found on:
http://www.netjukebox.nl/install.php


Configuration
All configuration parameters can be set in:
include/config.inc.php


MySQL and MySQLi
netjukebox natively works with the php MySQLi engine.
If you want to use the older MySQL engine convert the scripts with:
tools/mysqli2mysql.php


Upgrade from netjukebox 5.09
netjukebox 5.10 and up has only one file for the thumbnail and PDF cover.
Use this script to update the images: tools/batch_rename_image.php
This script will rename the source image to image_front/back from the
config.inc.php file. When multiple source images exist it will use the image
with the highest resolution.


Upgrade from netjukebox 4.08
The httpQ profile need to be updated when upgrading from netjukebox 4.08 and older.
Because of the more uniform directory and file-naming scheme the httpQ profiles must end with a slash.
This can easy be fixed by edit an existing profile and then save it.
(the slash will then be automatically be added)


Upgrade from netjukebox 3.77
When upgrading from netjukebox 3.77 and earlier to this release then
all users will be deleted and two default user will be created:

username: admin
password: admin

username: anonymous
password: anonymous


Command line update
netjukebox update can be run from the command line.
This way it is possible to schedule an update with a Windows Scheduled Task or Linux Cron Job.
Example:
C:\PHP\php.exe "D:\Internet\netjukebox\update.php" update silent


Track number limitation
LAME version 3.97 doesn't support track numbers larger than 255 even with --id3v2-only.
This bug has been fixed in LAME 3.98 beta 5.


Very large files
The current version of PHP doesn't support integers larger than 31 bit.
This is the reason why very large files (~2GB) are not working on netjukebox.