Installation

RadioBot Installation

Windows Installation

1. RadioBot has been tested on Windows 2000/XP/Vista/7/10 (both 32-bit and 64-bit where applicable).

2. Download the RadioBot Installer for Windows

3. Run the RadioBot Installer.

4. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the RadioBot folder you created in Step 3.

5. Run RadioBot.exe

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

6. When the bot joins your channel, type /msg BotNick hello

7. To install plugins, the DJ client, or other bot components run Package Manager.exe.

Linux Installaton

Note for All Linux distributions

Note: All Linux installations assume you have appropriate 3rd party repositories such as RPMForge (dag/dries), EPEL, Debian Multimedia, etc. (whichever is appropriate for your distro)

Also note: These instructions are just guides, things are different even in the same distros sometimes (especially if cpanel, etc. is installed), so these instructions may have to be tweaked for your specific system.

Linux users are expected to know basic Linux system operations like package management, config files, etc., as we cannot give a "Linux 101" to each user.

Linux Support Policies

Linux distribution will be supported as outlined here.

CentOS 7 Installation

1. This was tested on CentOS 7 with EPEL + RPMForge + ATrpms repos enabled.

2. Download the RadioBot archive for CentOS

3. Open a shell/terminal and cd to the folder where you downloaded RadioBot to

4. Download physfs-1.0.0-0.el6.rf.x86_64.rpm and libmpg123-1.15.1-1.el7.nux.x86_64.rpm and install them with: sudo yum localinstall physfs-1.0.0-0.el6.rf.x86_64.rpm libmpg123-1.15.1-1.el7.nux.x86_64.rpm

5. Type sudo yum -y install openssl sqlite mysql wxGTK taglib physfs lame curl protobuf muParser lua

• Go to Step 7 if you have RadioBot Basic

6. Type sudo yum -y install libogg libvorbis libresample lame-devel libsndfile ffmpeg flac opus

7. Type mkdir radiobot

8. Type cd radiobot

9. Type tar -xzf ../radiobot.centos7.x86_64.tar.gz

10. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 7.

11. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

12. When the bot joins your channel, type /msg BotNick hello

CentOS 6 Installation

1. This was tested on CentOS 6 with EPEL + RPMForge repos enabled.

2. Download the RadioBot archive for CentOS

3. Open a shell/terminal and cd to the folder where you downloaded RadioBot to

4. Type sudo yum -y install openssl sqlite mysql wxGTK cryptopp taglib physfs lame curl protobuf muParser lua

• Go to Step 6 if you have RadioBot Basic

5. Type sudo yum -y install libogg libvorbis mpg123 libresample lame-devel libsndfile ffmpeg flac opus

6. Type mkdir radiobot

7. Type cd radiobot

8. Type tar -xzf ../radiobot.centosXX.tar.gz

9. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 28.

10. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

11. When the bot joins your channel, type /msg BotNick hello

Debian Installation

1. This was tested on Debian 8. This also assumes you have the Debian Multimedia repo enabled in your APT config.

2. Download the RadioBot archive for Debian

3. Open a shell/terminal and cd to the folder where you downloaded RadioBot to.

4. Debian 11: Type sudo apt-get install openssl sqlite3 libsqlite3-0 default-libmysqlclient-dev libcurl4 libphysfs1 tcl8.6 libloudmouth1-0 libtag1v5 espeak espeak-data festival libssl1.1 libwxgtk3.0-gtk3-0v5 libsqlite3-0 libmpg123-0 libogg0 libvorbis0a libvorbisfile3 libsndfile1 libavformat58 libavcodec58 libmp3lame0 libflac8 libresample1 libfaac0 libprotobuf23 libmuparser2v5 liblua5.2-0 libaacplus2 libsoxr0
Debian 10: Type sudo apt-get install openssl sqlite3 libsqlite3-0 default-libmysqlclient-dev libcurl4 libphysfs1 tcl8.6 libloudmouth1-0 libtag1v5 espeak espeak-data festival libssl1.1 libwxgtk3.0-0v5 libsqlite3-0 libmpg123-0 libogg0 libvorbis0a libvorbisfile3 libsndfile1 libavformat58 libavcodec58 libmp3lame0 libflac8 libresample1 libfaac0 libprotobuf17 libmuparser2v5 liblua5.2-0 libaacplus2 libsoxr0
Debian 8: Type sudo apt-get install openssl sqlite3 libsqlite3-0 libmysqlclient18 libcurl3 libphysfs1 tcl8.6 libloudmouth1-0 libtag1c2a libtagc0 espeak espeak-data festival libssl1.0.0 libwxgtk3.0-0 libsqlite3-0 libmpg123-0 libogg0 libvorbis0a libvorbisfile3 libsndfile1 libavformat56 libavcodec56 libmp3lame0 libflac8 libresample1 libfaac0 libprotobuf9 libmuparser2 liblua5.2-0 libaacplus2 libsoxr0
Debian 7: Type sudo apt-get install openssl sqlite3 libsqlite3-0 libmysqlclient18 libcurl3 libphysfs1 tcl8.5 libloudmouth1-0 libtag1c2a libtagc0 espeak espeak-data festival libssl1.0.0 libwxgtk2.8-0 libsqlite3-0 libmpg123-0 libogg0 libvorbis0a libvorbisfile3 libsndfile1 libavformat54 libavcodec54 libmp3lame0 libflac8 libresample1 libfaac0 libprotobuf7 libmuparser2 liblua5.2-0 libaacplus2 libopus0

5. Type mkdir radiobot

6. Type cd radiobot

7. Type tar -xzf ../radiobot5.debian.tar.gz

8. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 6.

9. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

10. When the bot joins your channel, type /msg BotNick hello

Ubuntu Installation

1. This was tested on Ubuntu 19.04.

2. Download the RadioBot archive for Ubuntu

3. Open a shell/terminal and cd to the folder where you downloaded RadioBot to.

4. [Ubuntu 21.04] Type sudo apt install openssl sqlite3 libwxgtk3.0-gtk3-0v5 lame libtag1v5 libtagc0 libmp3lame0 libmp3lame-dev libogg-dev libvorbis-dev libsndfile1 libsndfile1-dev libavcodec-extra libavformat58 libcurl4-openssl-dev libmpg123-0 libresample1 libncurses5 libphysfs1 libpcre3 libprotobuf23 libmysqlclient21 libfaac0 libopus0 libloudmouth1-0 libdbus-glib-1-2 libmuparser2v5 libsoxr0 build-essential

[Ubuntu 19.04] Type sudo apt install openssl sqlite3 libwxgtk3.0-0v5 lame libtag1v5 libtagc0 libmp3lame0 libmp3lame-dev libogg-dev libvorbis-dev libsndfile1 libsndfile1-dev libavcodec-extra libavformat58 libcurl4-openssl-dev libmpg123-0 libresample1 libncurses5 libphysfs1 libpcre3 libprotobuf17 libmysqlclient20 libfaac0 libopus0 libloudmouth1-0 libdbus-glib-1-2 libmuparser2v5 libsoxr0 build-essential

[Ubuntu 18.04] Type sudo apt install openssl sqlite3 libwxgtk3.0-0v5 lame libtag1v5 libtagc0 libmp3lame0 libmp3lame-dev libogg-dev libvorbis-dev libsndfile1 libsndfile1-dev libavcodec-extra libavformat57 libcurl4-openssl-dev libmpg123-0 libresample1 libncurses5 libphysfs1 libpcre3 libprotobuf10 libmysqlclient20 libfaac0 libopus0 libloudmouth1-0 libdbus-glib-1-2 libmuparser2v5 libsoxr0 build-essential

[Ubuntu 16.04] Type sudo apt-get install openssl sqlite3 libwxgtk3.0-0v5 lame libtag1v5 libtagc0 libmp3lame0 libmp3lame-dev libogg-dev libvorbis-dev libsndfile1 libsndfile1-dev libavformat-ffmpeg56 libavcodec-ffmpeg56 libcurl4-openssl-dev libmpg123-0 libresample1 libncurses5 libphysfs1 libpcre3 libprotobuf9v5 libmysqlclient18 libfaac0 libopus0 libloudmouth1-0 libdbus-glib-1-2 libmuparser2v5 libsoxr0 build-essential

[Ubuntu 14.10] sudo apt-get install openssl sqlite3 libwxgtk3.0-0 lame libtag1c2a libtagc0 libmp3lame0 libmp3lame-dev libogg-dev libvorbis-dev libsndfile1 libsndfile1-dev libavformat56 libavcodec56 libcurl4-openssl-dev libmpg123-0 libresample1 libncurses5 libphysfs1 libpcre3 libprotobuf8 libmysqlclient18 libfaac0 libopus0 libloudmouth1-0 libdbus-glib-1-2 libmuparser2 libsoxr0

[Ubuntu 14.04] sudo apt-get install openssl sqlite3 libwxgtk3.0-0 lame libtag1c2a libtagc0 libmp3lame0 libmp3lame-dev libogg-dev libvorbis-dev libsndfile1 libsndfile1-dev libavformat54 libavcodec54 libcurl4-openssl-dev libmpg123-0 libresample1 libncurses5 libphysfs1 libpcre3 libprotobuf8 libmysqlclient18 libfaac0 libopus0 libloudmouth1-0 libdbus-glib-1-2 libmuparser2 libsoxr0

5. Type mkdir radiobot

6. Type cd radiobot

7. Type tar -xzf ../radiobot.ubuntu.tar.gz

8. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 9.

9. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

10. When the bot joins your channel, type /msg BotNick hello

• If you plan on using AutoDJ, you may need to use the Debian libmpg123 fix if the bot crashes when it tries to play an MP3 on older versions of Ubuntu.

Fedora Installation

1. This was tested on Fedora 16 with the RPM Fusion repo enabled

2. Download the RadioBot archive for Fedora (if one for your release # isn't available, get the closest one to yours)

3. Open a shell/terminal and cd to the folder where you downloaded RadioBot to

4. Type sudo yum -y install openssl sqlite loudmouth lame lame-devel libogg libvorbis vorbis libsndfile libmpg123 taglib taglib-devel ffmpeg ffmpeg-libs faac physfs mysql-libs flac libresample pcre

5. Type mkdir radiobot

6. Type cd radiobot

7. Type tar -xzf ../radiobot.fcX.tar.gz (where X is the # of your Fedora release, ie. 10 or 11)

8. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 5.

9. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

10. When the bot joins your channel, type /msg BotNick hello

Arch Installation

1. This was tested on Arch Linux 32-bit

2. Download the RadioBot archive for Arch

3. Open a shell/terminal and cd to the folder where you downloaded RadioBot to

4. Type sudo pacman -S protobuf mpg123 taglib libsndfile mysql ffmpeg muparser loudmouth opus libogg opusfile libvorbis faac libsoxr physfs lua ncftp

5. Type mkdir radiobot

6. Type cd radiobot

7. Type tar -xzf ../radiobot.arch.tar.gz

8. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 5.

9. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

10. When the bot joins your channel, type /msg BotNick hello

SuSE Installation

1. This was tested on SuSE 11.1 with the PackMan 3rd party repo enabled.

2. Download the RadioBot archive for SuSE.

3. Open a shell/terminal and cd to the folder where you downloaded RadioBot to.

4. Use yast to install openssl sqlite3 mysql-devel wxGTK taglib physfs libmad0 lame physfs curl libcurl4

• Go to Step 6 if you have RadioBot Basic

5. Use yast to install libogg libvorbis libsndfile libavformat libavcodec libmp3lame lame-devel

6. Type mkdir radiobot

7. Type cd radiobot

8. Type tar -xzf ../radiobot4.suse.tar.gz

15. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 6.

16. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

17. When the bot joins your channel, type /msg BotNick hello

FreeBSD Installation

1. This was tested on FreeBSD stable (7.0)

2. Download the RadioBot archive for FreeBSD

3. Use sysinstall to install openssl if it is not already installed

• Go to Step 16b if you have RadioBot Basic

4. Download both id3lib and lame from the ShoutIRC.com website (or their respective homepages)

5. Use sysinstall to install libmad, libogg, libvorbis, vorbis-tools, libsqlite3, and libsndfile

6. Open a shell/terminal and cd to the folder where you downloaded RadioBot, id3lib, and lame to

7. Run tar -xzf id3lib-3.8.3.tar.gz

8. Type cd id3lib-3.8.3

9. Type ./configure && make

10. Type sudo make install

11. Type cd ..

12. Type tar -xzf lame-3.97.tar.gz

13. Type cd lame-3.97

14. Type ./configure && make

15. Type sudo make install

16a. RadioBot Full: type cd ..
16b. RadioBot Basic: Open a shell/terminal and cd to the folder where you downloaded RadioBot to

17. Type mkdir radiobot

18. Type cd radiobot

19. Type tar -xzf ../radiobot.freebsd.tar.gz

20. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 17

21. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

22. When the bot joins your channel, type /msg BotNick hello

Mac OS X Installation

Note: The Mac OS X build is experimental and for testing purposes only!

This is for learning purposes since we know almost nothing about Macs, especially backwards compatibility if an app compiled for 10.6.8 will run on later versions like 10.7.x or 10.8.x.

1. This was tested on Mac OS 10.6.8 with XCode 3.2.6 and Homebrew installed.

2. Download the RadioBot archive for Mac OS.

3. Open a shell/terminal and cd to the folder where you downloaded RadioBot to

4. Type brew install openssl sqlite mysql taglib physfs lame curl protobuf wxmac loudmouth dbus-glib pcre

• Go to Step 6 if you have RadioBot Basic

5. Type sudo brew install libogg libvorbis mpg123 libsndfile ffmpeg flac opus

6. Type mkdir radiobot

7. Type cd radiobot

8. Type tar -xzf ../radiobot5.macosx.tar.gz

9. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 28.

10. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

11. When the bot joins your channel, type /msg BotNick hello

Solaris Installation

Note: Please note that there is no Solaris build at this point, this is for future reference

1. This was tested on Solaris 10 x86

2. Download the RadioBot archive for Solaris

3. Make sure you have pkg-get installed from blastwave.org

4. Open a shell/terminal and cd to the folder where you downloaded RadioBot to

5. Type pkg-get install openssl

• Go to Step 13 if you have RadioBot Basic

6. Type pkg-get install libmad id3lib lame libogg libvorbis vorbistools

7. Download libsndfile from the ShoutIRC.com website (or it's homepage)

8. Type gtar -xzf libsndfile-1.0.17.tar.gz

9. Type cd libsndfile-1.0.17

10. Type ./configure && make

11. Type make install

12. Type cd ..

13. Type mkdir radiobot

14. Type cd radiobot

15. Type tar -xzf ../radiobot.solaris.tar.gz

16. Use the ircbot.conf generator at ShoutIRC.com (Log In -> My Account -> Licenses) to make a basic configuration. Save your ircbot.conf into the radiobot folder you created in Step 13.

17. Type ./radiobot

• You may need to tweak your ircbot.conf to customize things the way you want. You will be able to edit your ircbot.text to customize the colors and messages of the bot later, this is just to make sure it's working.

18. When the bot joins your channel, type /msg BotNick hello

Disclaimer

All operating system/distribution logos, images, names, etc., are copyrighted, trademarked, and/or otherwise the property of their respective owners.