Search in tutorials  ×

Home page

Means the page is updated. disclaimer

Radiodj License A RadioDJ station setup Migrating to MariaDB Upgrading RadioDJ F.A.Q. RadioDJ screen layout zones playlist (a.k.a Queue list) Update image Plugin Search Update image Plugin Instant players Plugin History Plugin Song details Plugin Auxplayers Managing Tracks Playlist builder + (Playlists manager) Audio processing Now playing info Utilities Events Track CUE Point setting Rotations Kinds of everything Options Buttons Users Update image Screen size Default plugins Disabled plugins Record radiodj Video Tutorials   Small tips    RadioDJ change list RadioDJ Reports Setup two radio stations JWL Scripting
3rd Part Tutorials
    Shared files for download

(The most recent Language
works for all versions.) Check file date

Language files
Language Say-Time RadioDJ Styles Applications Scripts My free scripts Old_v.1.8.2_pdf_Files RadioDJ versions
(working correctly or not correctly!)
RadioDJ Manuals

☰   Tutorials
RadioDJ options

RadioDJ options screen

Tab Sweepers.

    Click on a button billow to show explanation


Options settings.

Settings screen:

  • Language = You can set the language to use (there are 16 languages available in the download).
  • Date format = You can set the format to your likes how? click on  
  • Program Priority = The one selected will do fine.
  • Results to show = has to do how many tracks per page to show in the search screen and track manager screen!
  • All other settings will do fine.
  • Advice select the box by Store settings in database!
  • Note on Remote Instance with a extra setup/use of RadioDJ
    if the database and music is shared between two or more instances, when setting one as remote
    this RadioDJ version will not mark tracks as played to avoid
    corruption of the history/reports
    but also the events will not trigger on it. In this way, you can create
    play lists, edit tracks and so on, but without corrupting the database.
  • Allow only one instance will prevent that if you install a extra setup of radiodj it can't be use or started

Sound cart settings:

Set the main 1 speaker

Note, set if possible by Monitoring (QUE) an other speaker (like a headset)
This speaker will/is used for pre listening a track and used bij setting que points on tracks
Every time you make changes to the sound cart settings you have to re start radiodj there will be a warning pop up screen

Auto DJ:

Stream Titles:

Other Settings:

When you have setup radiodj in a other folder as C:\RadioDJ\

  • Recording Folder = Check whether it points to the correct folder.
  • (RadioDJ has a build in recorder)

  • Artwork storage Path = Check whether it points to the correct folder.

    (By importing tracks and there is album art present it will be stored in that folder)
  • Color Scheme = Skins for the look of Radiodj screen. By clicking on   You can make your own scheme.
  • Short cut buttons you can add or remove the buttons.


This are the standard plugins.

How to use and set, see in the menu all that has to do with standard plugins and Disabled Plugins


Options Tracks Rotations.

Quick links to:

Tracks Rotations.

tracks rotations

tool tips

Buttons have a tool tip for use.


start rotation

Select a option.

Track From Category.

Select the category.


Subcategory selection.

Genre selection.

Mood - Gender - Language

There only available when there are set with a track import.

Selection start type.

Selection end type

Selection mode.

Selection sweeper.

Selecting repeat rules.

You can overwrite a single rule or all of them!

Global rotation rules settings.


Track From SQL Query.

track query


Start a new query.

Load query from a folder.

save Save the edited or adjusted query to a folder.

On load query, you can select a query .sql file from a folder.

In C:\RadioDJ\SQL Rotation Examples\

Are some examples.

    - ADD 3 TRACKS WITH SWEEPER FROM 1970 TO 1989.sql
    - LOAD ALBUM.sql

Loaded: ADD 3 TRACKS WITH SWEEPER FROM 1970 TO 1989.sql to show how it's look.

query rota

When clicking on Run query.


The tracks are found.

If there is a error in the query, you get the warning!



You can't use names only ID numbers for a categories, subcategories or genre, so this is handy.

Test run the query.
Get ID from categories list.
Get ID from subcategories list.
Get ID from genre list.

Very handy on editing a new query.

Click ok to put it in the rotation screen.

line in rotation
You still can adjust lines with:

Edit or delete the line.

Can be used to duplicate a line.
Select the line to duplicate first!

Use: exsit Or save to

For saving the rotation.

Or save as

Save as, to make a new rotation name.

Track From Requests.

If you use this by hand to put a requested track in from a requester.

Or using a web script:

Demo webscript: RadioDJ Demo Script V.2.2 from the RadioDJ website on the download page.

Track From Manual Event

error manual events

There has to be a manual event. (See events)

manual event

A manual event is present, if there a more you can select one.

Working of a rotation.

Auto DJ is ON.

When there are 5 lines in the rotation, on the first load 5 tracks are set in the playlist.

The moment there are just 4 tracks in the playlist the rotation set 5 tracks in the playlist.

Now there are 9 tracks in the playlist, the moment that there are only 4 in the playlist, the rotation set 5 to the playlist and so on....


Button open settings screen

Click on it in the main screen!

Option screen

Click on EVENTS.

Or click on eventbar in the main screen.

Setup Events.

Start screen.

You can start in the Default category, click on button 1 Or make a new category, click on button 2

Make or change a event.

Set a event name.

Select the event type.


  • One Time Only.
  • On use, you have to set the date, only on that date and year the event will run!
  • Repeat by Day.
  • Select the day or days.

    Choose the event category.
    If there is more than one!

  • Repeat by Day and Hour.
  • Select the day(s) and Hour(s).
    On a right click in the field Days or Hours.

    For a quick change.

    Don't forget to set the Event Hour!
    Don't forget to set the Event Hour (minutes and seconds)!
  • Manual Event.
  • This event will only start by hand.

    Use the manual events plugin for use.
  • Start up Event.
  • Every time RadioDJ is started this event will run.
  • Repeat by Date.
  • Using this option is:
    every year (Year is ignored on the calendar setting) on that date and event hour set, the chosen events action wil start.

    Choose the event category.
    If there is more than one!

  • Repeat by Date and Hour.
  • Using this option is:
    every year on that date (Year is ignored on the calendar setting) and event hour that is set (when a hours select box is NOT set, as in the photo) the chosen events action wil start.
    When a hours select box is set (or more) the hours are ignored in the time setting.

    Choose the event category.
    If there is more than one!

Event Actions.

Note, The run action is from top to bottom!
(Start from line 1 to line ...)

The line order of placing:
To the TOP in the list.
5. action
4. action
3. action
2. action
1. action
To the BOTTOM in the list.
1. action
2. action
3. action
4. action
5. action

Main Actions.

Action list:


  • Load Track.
  • Load Track From Category.
  • Load Playlist.
  • When this appeared in the screen, there are no playlists!

    Select on Options: the playlist.

    On position you can choose to the Top or Bottom.

  • Load M3U Playlist.
  • Opens your explorer screen to select a M3U playlist.

    Select the position.

  • Load M3U Playlist By Date Mask.

  • Opens your folder lister to select a folder where the M3U list are with the date to play.

    You have to set the argument field with the date mask!

    Example: M3U name is: 2017-07-25.m3u

    The date part in the file is 2017-07-25
    Date mask is: Y-m-d in the argument field (used separator is - a dash)

    Note, this/it must be according to the PHP date().

    Set in the argument field:

    Don't forget the file extension.

    The php date() is:
    d     Day of the month, 2 digits with leading zeros     01 to 31
    D     A textual representation of a day, three letters     Mon through Sun
    j     Day of the month without leading zeros     1 to 31
    m     Numeric representation of a month, with leading zeros     01 through 12
    n     Numeric representation of a month, without leading zeros     1 through 12
    Y     A full numeric representation of a year, 4 digits     Examples: 1999 or 2003
    y     A two digit representation of a year     Examples: 99 or 03
    Having a deeper understanding explained of programming in php!
    Well this is not the intention.
    Just a little bit of knowledge is enough, as showed in the list.
    How the date mask works.

    Also possible is a file name and hour like: morning_(2017-07-25)10.m3u

    The mask will be: morning_(Y-m-d)H.m3u

    a     Lowercase Ante meridiem and Post meridiem     am or pm
    A     Uppercase Ante meridiem and Post meridiem     AM or PM
    B     Swatch Internet time     000 through 999
    g     12-hour format of an hour without leading zeros     1 through 12
    G     24-hour format of an hour without leading zeros     0 through 23
    h     12-hour format of an hour with leading zeros     01 through 12
    H     24-hour format of an hour with leading zeros     00 through 23
    i     Minutes with leading zeros     00 to 59
    s     Seconds, with leading zeros     00 through 59
    u     Microseconds (added in PHP 5.2.2).
        Note that date() will always generate 000000 since it takes an integer parameter,
        whereas DateTime::format() does support microseconds if DateTime was created with microseconds.
    v     Milliseconds (added in PHP 7.0.0). Same note applies as for u.

  • Clear Playlist
  • It just clears the playlist.
    To use in combination with other actions.
  • Start Playing.
  • Start play, even if a track is playing.
  • Pause.
  • Pause the playing track.
  • Un-Pause.
  • Un-pause the playing track.
  • Stop Playing.
  • Stops the playing track.
  • Enable AutoDJ.
  • Starts the rotation and filling the playlist.
  • Disable AutoDJ.
  • Stops the rotation from filling the playlist.
  • Enable Assisted.
  • Make auto start the next in the playlist.
  • Disable Assisted.
  • Every next track has to start by hand.
  • Load Rotation.
  • Load a rotation.
  • Set Sweeper Category.
  • Set or change a sweeper category.
  • Enable Events Category.
  • Switch on a event category.
  • Disable Events Category.
  • Disable a event category.
  • Pause Events.
  • Pause all event.
  • Mute Input.
  • (Tool tip on button:)

    Switch the button off and can't be use.

  • Unmute Input.

  • Switch the button on and it can be use.

  • Run Application.

  • In the argument field:
    fill in where and what to run by this application.
  • Launch Internet Link.

  • Set the path to the internet link.

  • Run SQL Query.
  • Opens your explorer screen to select a sql query file.

    The path is selected.
    Showing what qurey to run.

  • Seconds To Wait.

  • Set the seconds to wait in the argument field.
    (just the number.)

  • Select Plugin Action.
  • The standard list:

    Select a available plugin.

    ← ← ← Note, this is the standard list.

    When plugins are imported from the Disabled Plugins folder to the Plugins folder.
    They are also seen in the list.
    It's possible on a plugin you have to set a argument!

    Even third party plugins are seen.

    (Check on the plugin it's self which argument to use for the plugin.)

    Note that:
    A combination of actions is beter and best used in an event.

    Smart timing.

    To resume the behavioral: (by Marius)

    Let's say you set the smart timing event to run exactly at 10.00:00, with a 30 seconds offset value in RadioDJ options.
    If the playing track will end between 09:59:30 and 10:00:30, the event will wait for the track to end, otherwise it will run as a normal event at the hour you've set, 10:00:00.

    When the smart timing can be used, beside the event name will appear "(Smart Timing)". and the remaining time until the event will be the same as the remaining time of the playing track.

    Make or change a category.

    Set a new name.

    Or select a exiting name to change

    Actually, the screen explains itself.
    Plus is add.

    Cross is remove.
    On the name!

    And the is change the name!

    duplicate events

    Right click on the event line to be duplicated.

    Double click on the line with (copy).

    Change what you want to change and save the event.


    Options Shortcuts.


    Options Users.



    The password of the Admin is not showed.
    On the first time using:
    Name: admin
    Pass: admin

    Change this like this:

    Click on admin 14 to change.

    Making a new user:

    admin 3

    admin 4

    Fill in the new user name and password.

    Click on the green plus.

    admin 5

    Select the new user, set the select boxes where the new user has acces to.

    specail png

    From my point of view, do not give permission here, you can then be removed, and then need to reinstall RadioDJ.

    Click on save save to store the settings for the new user.

    admin 7

    Click on close.

    Shows up if you click on a button in the RadioDJ screen.

    Login first.

    admin 10

    admin 10a

    When not in use.

    When clicking on admin 9 and not in use.

    It shows the user login is not in use.

    admin 12

    Log out when you are finished using RadioDJ and another takes over.

    Remind others to do this too, there may be different access permissions for users of the station.

    Finally, there seems to be an inactive time frame and you need to log in again.
    Unfortunately, but safety first or not?


    Options Color editor.

    Adjust or make your one radiodj theme


    Options Track Import.

    Categories manager.

    Has to do of the select boxen in track import: Category, Subcategory and Genre.

    These are the defaults.
    You may have already changed them, added subcategories etc.

    To import a track, click on   

    And select a track.

    Artist name and title shows. Track duration is calculated 00:04:58

    You can pre play the track.

       Start play
       Jump forward 2 sec.
       Stop play

    On play, the 00:00:00 counter starts running.

    Note: Pre play use the Monitoring CUE setting in OPTIONS Sound Cards settings.

    Import track settings:

    • Select the Category.
    • Select the Subcategory.
    • Select the genre.
    • Select the Track Type.

    Note, when importing a track that is/was no longer in the database and has cue points data in the ID3Tag, this screen shows up.

    Special use:

    Play for (number) times, and then, the option is: Noting, Disable, Delete or Move To.
    When Move to is selected, you can use, Move to Category and/or Subcategory.

    A track can be set to play only between dates on a start and end date.

    High Precision Cue Points:
    For setting the Start, Next and End points, best calculated.

    The tabs in the screen.

    Tab Details.

    You can adjust the details for the track.

    By File Added will on import the date be set (automatically).

    By File Modified will on a import the date be set when there are changes made (automatically).

    Most of the details are read from the ID3Tag if present.

    When sweepers are present:

    You can assign a sweeper to the track by clicking on the green plus.

    Note, the assign sweeper will only be used in rotations!

    You can assign more the one sweeper, there will be then used random in the rotation.

    You can select multiple sweepers at one time to assign.

    Tab comments.

    Tab Track image.

    Double click in the square of the image screen if you have local a image.

    Set/find the location where a image is stored on your PC.

    When a image is present in the track ID3Tag it will show in the screen.

    Tab Others.

    The buttons

    • Cue Editor: Opens the cue editor to set the cue points for the track.
    • Like: Intro, Loop, Hooks, Outro, Or adjust them.
    • ID3 save: Save all details in the tracks ID3Tag.
    • ID3 Read: Read the details from the ID3Tag from the track (if present).
    • Import: Import the track and save in the database.
    • Close: Don't import and store in the database.

    Import a internet stream.

    stream import
    • Select Category.
    • Select Subcategory.
    • Select Genre.
    • Selects Track Type internet stream.

    If the path/url is empty the will flash as warning.


    Place the url for the stream.

    Click on check stream to check the stream.

    title stream

    Stream type and station name will show up.

    stream orgial title

    Select Use Original Stream Title.

    Click on import.


    Options Directory Import.


    Options Categories.

    The ones you see in the screen by Categories, can't be renamed or removed (Main categories).

    Here you can make new Categories, Sub Categories or Genre.

    New category, subcategory or genre:

    Set the name and click on the plus.

    Remove a category, subcategory or genre:

    Set the name and click on the min.

    Rename a category, subcategory or genre:

    Select a category, subcategory or genre.
    As showed if you can't rename a category it's grayed out on the selection.

    As well for removing a main category the min button.

    Change the name and click on the button Rename.
    New category:

    Set the category name and click on the plus.

    Select the new category and make a new subcategory for it (there must be at least one subcategory).

    Else it shows:


    Options Playlists.

    L/R refresh list make new playlist remove selected playlist.



    Options About.

    This page was last modified on October 22 2020 10:47 am (SET)