Plugin:SimpleDJ

From ShoutIRC RadioBot Wiki
Jump to navigation Jump to search

The Simple DJ plugin is the next phase in station automation and is designed to fully automate your station when there is no Live DJ.
Unlike Auto DJ, Simple DJ doesn't support transcoding so all your MP3s have to be encoded to the same samplerate and number of channels. This is a little less convenient, but uses a ton less CPU power and we provide tools to make managing your MP3s easier.

SimpleDJ Components

Main Random Queue (100%)
Request System (100%)
WebRequest Support (100%)
Meta Cache (100%)
Voice Support (100%)
Scheduling (100%)
Queue Plugins
 Memory Queue
 MySQL Queue

PM/Console Commands

Commands Flags Needed Description
!autodj-stop +s Counts down until song is over and disconnects so a Live DJ can connect. AutoDJ will turn back on after a timeout (default: 10 seconds)
!autodj-force +a Force AutoDJ to disconnect and stop anything it is doing.
!autodj-play +s Connect and start playing MP3s.
!autodj-reload +a Reloads the playlist and re-writes the HTML playlist (if specified in .conf)
!autodj-next +a Stops playing current song and goes to the next one.
!autodj-move
!autodj-move now
!autodj-move filename
+mo (any) When the current song is over it will be moved into the MoveDir defined in the AutoDJ/Options section of your ircbot.conf.
If now is specified it also skips to the next song immediately.
If a filename is specified it will move that file instead. This parameter takes just a filename just like !request, not a full path and filename.
!youtube-dl url or keyword(s) +a Downloads a YouTube video to the YouTubeDir folder.
!youtube-play [once] url or keyword(s) +a Downloads a YouTube video to the YouTubeDir folder and plays the audio. If once is specified the file is deleted afterwards.
!autodj-reqlist +a This will make AutoDJ show you a list of the currently requested/scheduled songs.
!autodj-reqdelete filename/wildcard +a This will make AutoDJ delete the first requested/scheduled song that matches the filename/wildcard you give.
!autodj-requests [on][off] +a This will make toggle whether AutoDJ will take requests from users.
You can also specify on or off to turn requests on or off.
!autodj-relay +mo (any) Queue's any file on the filesystem, or a stream (stream://host:port/;file.mp3)
!autodj-speak text +mo (any) This will make AutoDJ speak the specified text at the end of the current song (Voice must be enabled).
!autodj-chroot dir[;dir] +mo (any) Changes the content directory on the fly.
!autodj-name +mo (any) Changes the name sent to the sound server on the fly.
!autodj-modules +mo (any) This will display the currently loaded AutoDJ plugins.
!autodj-songtitle title +a This will make AutoDJ send the specified song title to your song server.
!autodj-dopromo +a This will make AutoDJ play a set of your promos after the current song.
!autodj-countdown   This will countdown the current song until it is over (but will not disconnect the bot for a DJ to connect like !autodj-stop)

Channel Commands

Commands Flags Needed Description
!next +a Stops playing current song and goes to the next one.
!songby artist +q Queue's a random song by the specified artist.
!countdown   This will countdown the current song until it is over (but will not disconnect the bot for a DJ to connect like !autodj-stop).
!move
!move now
!move filename
+mo (any) When the current song is over it will be moved into the MoveDir defined in the AutoDJ/Options section of your ircbot.conf.
If now is specified it also skips to the next song immediately.
If a filename is specified it will move that file instead. This parameter takes just a filename just like !request, not a full path and filename.
!relay +mo (any) Queue's any file on the filesystem, or a stream (stream://host:port/;file.mp3).
!youtube-dl url or keyword(s) +a Downloads a YouTube video to the YouTubeDir folder.
!youtube-play [once] url or keyword(s) +a Downloads a YouTube video to the YouTubeDir folder and plays the audio. If once is specified the file is deleted afterwards.

Configuration

See ircbot.conf for example config, or the Configuration page.

Helpful Programs

We provide our newest utility mp3sync with RadioBot to make encoding your MP3s to your stream bitrate/channels/samplerate automatic and easy.

Libraries in use by SimpleDJ Plugins

MP3 Decoder (sdj_dec_mp3.dll/so)
 LibSSMT by Drift Solutions for reading ShoutIRC Streaming Meta Tags
 taglib for reading ID3 (v1 & v2) and MusicMatch tags (LGPL)

Compatibility

Plugin Compatibility: RadioBot Basic RadioBot Full
Supported: Yes Yes



RadioBot vde

RadioBot main pages
Main PageInstallationChangelogCommandsPluginsFAQConfigurationCreditsRemote ClientBuilt-In VariablesMulti Sound Server ModeUsername Character Restrictions
Auto DJ Pages
Auto DJ Main PageWebRequest SystemSchedulerMP3 EncoderVoice SupportMySQL Plugin