• [fix] Fixed a bug with the VU level meters. Previously, adjusting the gain level for a channel would affect the output volumes for both master and cue (by adjusting the track volumes), but this wouldn't be reflected on the master and cue VU displays. It is now.

• [fix] DJ-1800 no longer crashes on quit if it is unregistered and if one or more tracks are in song search mode when using the internal mixer.

• [new] Added a preferences pane for EQ preferences, enabling the Low, Mid and Hi ranges to be modified by the user.
• [chg] The default EQ ranges for Low, Mid and Hi are now -20 dB / +6 dB, and the max range is -20 dB / +12 dB in each case.
• [imp] The current EQ range for each of the Low, Mid and Hi twisters is now displayed on the twister.
• [chg] When a Protected AAC file is loaded, the EQ twister displays a range of -4 dB / +4 dB, to more closely represent the limited EQ range available for Protected AAC files.
• [chg] Updated the user documentation to describe the new EQ preferences.

• [new] Added a mid-range EQ control to the internal mixer (not available for Protected AAC files).
• [imp] The Low, Mid and Hi EQ ranges now have a range of +/- 20db (Protected AAC files still use the old, smaller range for Low and Hi).
• [new] Created a new controller plug-in and documentation for the Denon DN-HC4500 controller.
• [new] Created a new controller plug-in and documentation for the Numark iCDX controller.
• [kis] The Numark DMC2 and Numark iCDX plug-ins do not yet work on Mac OS 10.5.x. They do work fine on 10.4.x, however.
• [imp] Improved mapping of mono tracks to stereo outputs, with improved VU monitoring.
• [imp] Improved mapping of stereo tracks to mono outputs, with improved VU monitoring.
• [new] Files with 3+ channels of source audio can now be used with DJ-1800, and will be mixed down to mono / stereo as appropriate.
• [fix] The Shift, Ctrl and Alt keys now only modify Keyboard controllers, rather than all controllers.
• [new] Added some keyboard controls for the new mid-range twister.
• [chg] Updated the Hercules DJ Controllers, Hercules DJ Console (Mac Edition), Kontrol DJ KDJ500, M-Audio X-Session Pro and Numark Total Control plug-ins to control the new mid-range twister.
• [imp] Added "EQ Kill" functionality to the Numark Total Control plug-in, which is triggered by pressing down the Low, Mid and Hi controls on the controller.
• [imp] The M-Audio X-Session Pro plug-in now includes a second, alternative layout.
• [fix] It is no longer possible to load a new track by clicking on a CD Player's track number display whilst another track is already in the process of being loaded into another CD Player. This prevents a situation whereby the CD Player could become frozen if the track list popup menu was kept open for too long.
• [chg] Plug-In API: Many changes to the function names in the Plug-In API, to use a more consistent naming convention.
• [chg] Plug-In API: Reversed the direction of the values expected by the "SetPosition0toX" functions for the Master Volume slider, the Channel Volume sliders, and the Tempo slider. These functions now match the corresponding GetPosition functions, and also now match the behaviour described in the Plug-In API documentation.
• [chg] Plug-In API: "inChannel" is now "inPlayer" throughout the API, to avoid confusion with MIDI channels.
• [new] Plug-In API: New API functions, CDPlayer_GetPlayMode and CDPlayer_GetTimeMode.
• [fix] Plug-In API: Checkbox-type preference option values are now stored and re-used correctly.
• [new] Plug-In API: Added a new plug-in event script, PreferenceValueHasChanged, which is called whenever a plug-in's preference value is changed by the user. Updated the Plug-In API documentation to include this new function.
• [new] Plug-In API: Added a new plug-in event script, RackHasBeenInitialised, which is called as soon as the on-screen Rack is ready for events. Updated the Plug-In API documentation to include this new function.
• [chg] All plug-ins have been updated to match the new function names in the Plug-In API. If you have been using earlier versions of any of the plug-ins, you will need to download the updated ones.
• [imp] Added documentation for all of the "set state" and "retrieve state" functions to the Plug-In API documentation.
• [chg] Updated the Plug-In API documentation to include all of the function name changes mentioned above.
• [chg] Updated the DJ-1800 user documentation and help files to include the new mid-range twister.
• [kis] Plug-In API: Documentation for how to create a plugin is not yet complete

• [new] Added a controller plug-in and documentation for the M-Audio X-Session Pro, with many thanks to Jakob Schlyter.
• [new] A new web page has been added, at http://www.dj1800.com/plugins.php, to list all of the available controller plug-ins. At the moment, this is the same set of plugins as included with the download of 3.1b2. This new page is not yet integrated into the rest of the DJ-1800 web site, but it will be when v3.1 is launched.
• [chg] The "Plug-In API" folder (which contained plug-in documentation and templates) is no longer included within the 3.1 download. It can instead be downloaded from http://www.dj1800.com/plugins.php.
• [fix] Controlling the Mixer or Crossfader when they are used by the current output mode but are hidden on-screen no longer causes their controls to be drawn on screen when they should not be.
• [imp] The "Starting MIDI Server" message on launch is now a more descriptive "Loading controller plug-ins" message
• [chg] The DJ-1800 user manual and in-application help book have been updated to account for the changes in 3.1
• [new] Plug-In API: A new type of preference option has been added to the API, for "strings lists"
• [new] Plug-In API: The Plug-In API Documentation now includes documentation on how to add preference options to a plug-in
• [chg] Plug-In API: The jog wheel methods now require an extra parameter
• [kis] Plug-In API: Documentation for how to create a plugin is not yet complete
• [kis] The Numark DMC2 plug-in does not yet work on Mac OS 10.5.x. It does work fine on 10.4.x, however.

• [new] Created a new controller plug-in and documentation for the Numark Total Control controller
• [new] Created a new controller plug-in and documentation for the Numark DMC2 controller
• [chg] Removed the User-Defined Mouse Plug-in
• [new] Controller plug-ins can now live in either the /Applications/DJ-1800/Plug-Ins/ folder (for all users on a Mac), or in the ~/Application Support/DJ-1800/Plug-Ins/ folder (for just one user). All of the currently-available plugins are included as part of this download.
• [chg] Updated the documentation for all existing controllers to describe the new plug-in approach, and included the appropriate documentation alongside each plug-in.
• [fix] The Controllers listbox (in the General Preferences window) now ignores mouse clicks on its column headers
• [fix] MIDI controllers with jog wheels no longer continue to process Search movements after the controller's wheel has stopped moving (this was particularly noticeable when searching through a loaded track). Any user-defined MIDI plugins which use the jog wheel methods will now need to call the new InitialiseMIDIJogWheelMovement method in their Initialise script before they can call any jog wheel methods. See the Plug-In API documentation for more information.
• [new] Plug-In API: MIDI controller plug-ins can now send and receive MIDI System Exclusive events
• [chg] Plug-In API: The Plug-In API documentation and files now live in their own separate folder in the DJ-1800 download. This will not be included in the final release of DJ-1800 v3.1 (it will be available to download from the DJ-1800 web site as a separate download), but is included here during the beta phase to enable users to start developing plug-ins in the meantime. The "Example MIDI Plugin" and "User-Defined Keyboard" plug-in can also now be found inside this folder.
• [new] Plug-In API: Added a bunch of convenience methods for controllers to get and set the values of faders and twisters with a range from 0 to 127, 0 to 255, and 0 to N. Note that this will still be translated into a pixel value, so the resolution of the on-screen widget will ultimately define the accuracy of the value actually used.
• [chg] Plug-In API: The total track count is now passed to DrawTrack scripts
• [new] Plug-In API: Several new controller methods are now available to controller scripts (check the API documentation for the full list)
• [new] Plug-In API: Added a new method to set the Tempo Slider's value precisely. This enables controllers with a high-resolution slider to set the pitch more accurately than the on-screen slider widget's resolution will allow.
• [new] Plug-In API: Added some MIDI port name localisations, for MIDI plug-ins which use the default Apple MIDI Driver and don't define their own port names. See the Plug-In API documentation for more information.
• [new] Plug-In API: New MemoryBlock functions to get and set Int32 and Int64 values
• [new] Plug-In API: Added some new HID controller functions to get and set long values in HID events
• [fix] Plug-In API: MIDI / HID plug-ins now log information about the custom MIDI / HID settings found in their Info.plist file when debugging is enabled for the controller
• [fix] Plug-In API: The HeadphonesVolumeTwister_GetPositionXxxxx functions had the wrong parameters - this is now fixed
• [chg] Plug-In API: Updated the documentation to include all of the changes mentioned above, and to list (but not yet document) more of the available API functions
• [kis] Plug-In API: Documentation for how to create a plugin is not yet complete
• [kis] The DJ-1800 user manual has not yet been updated to account for the changes in 3.1
• [kis] The plug-ins web page mentioned in the "Using controller plug-ins with DJ-1800.rtf" file (http://www.dj1800.com/plugins.php) does not yet exist

What's new in version 3.1a1:

• [new] Controller support is now implemented via plugins, rather than being hardcoded inside the application. This means:
  • Users can now create their own controller plugins for any of the following:
    • MIDI devices
    • Human Interface Device (HID) devices
    • Devices which have their own custom drivers as an external library
    • Keyboard control
    • Mouse control
  • Plugins can trigger many different actions in DJ-1800, for example:
    • Pressing any of the buttons on any of DJ-1800's CD Players
    • Pressing any of the buttons on the internal mixer
    • Changing the values of faders and twisters on the internal mixer
    • Moving the jog and shuttle wheels
    • Changing which track is loaded in a CD Player
    • Moving the crossfader
    • Changing the "current" CD Player
  • Plugins can retrieve information from DJ-1800, such as:
    • Which CD Player is the "current" CD Player
    • Whether the internal mixer / crossfader are being used
    • The current positions of faders and twisters
  • Plugins can register to receive notifications when events happen, and can respond to those events, such as:
    • When a Play or Cue LED needs to be set
    • When the current time value has changed for a CD Player
    • When various faders and twisters have been moved
  • Plugins can specify their own preferences, and the values of these preferences can be changed by the user via a reworked Controllers preferences window.
  • Plugins can create timers to perform actions after a certain time period - for example, to turn an LED on or off, or to reset an LCD display.
• [chg] All existing controller support has been extracted from the main application and implemented as controller plugins. This means that if you want to continue to use a particular hardware controller with DJ-1800, you will need to download the appropriate plugin and place it in the following directory: ~/Library/Application Support/DJ-1800/Plug-Ins/ . All of the current plugins are included with this alpha release, but when v3.1 is released, they will be available to download separately.
• [chg] If you want to change the way a particular controller plugin works, you can edit the plugin yourself. Plugin functionality is implemented using a programming language called RBScript (REALbasic Script). RBScript is an easy to learn scripting language based on the REALbasic language created by REAL Software. (REALbasic is the development IDE used to create DJ-1800.) RBScript files can be edited in any text editor, though we recommend BBEdit. Documentation for the RBScript language is included in the Language Reference for the full version of REALbasic. The latest version, REALbasic 2007 Release 5 for Mac OS X, can be downloaded from http://www.realsoftware.com/download/ .
• [new] The new plugin support includes a way to debug any changes you make to a plugin. You can turn on debugging for your controller plugin and DJ-1800 will write information and errors to the Mac OS X Console to enable you to find any problems.
• [chg] The generic MIDI support for any MIDI device is no longer included by default in DJ-1800 3.1b1. Instead, you should create your own MIDI plugin for any devices you wish to support. A template MIDI plugin is included with this beta release, and will be available to download separately when v3.1 is released.
• [chg] Keyboard and Mouse support are now implemented as plugins. A "Default Keyboard" and "Default Mouse" plugin are included within DJ-1800 itself, but you can override either plugin by creating your own plugin with the same Unique ID, and placing it in the ~/Library/Application Support/DJ-1800/Plug-Ins/ folder. This means that you can set up your own keyboard mappings for DJ-1800, and share them with other people if you wish. Template plugins for User-defined Keyboard and Mouse support are included with this alpha release, and will be available to download separately when v3.1 is released.
• [new] Plugins are implemented as proper Mac OS X plugins with an extension of ".plugin", which means that they are treated by the FInder as if they are a file, and are therefore easy to move around and share. However, a plugin is in fact a folder, containing all of the information that DJ-1800 needs to read and use the plugin. To see inside a plugin, right-click on the plugin and select "Show Package Contents".
• [chg] The Controllers preference pane has been completely redesigned to list all installed plugins.
• [kis] Documentation for how to create a plugin is included but is not yet complete.
• [kis] The DJ-1800 user manual has not yet been updated to account for the changes in this alpha release.
• [chg] Alpha and beta builds of DJ-1800 now display an alert on quit if the beta release has 7 days (or less) to run before the beta period expires.