-
Notifications
You must be signed in to change notification settings - Fork 0
Compiling and installing Arizona
Arizona is tested and known to work with most of modern 32-bit and 64-bit GNU/Linux based distributions. BSD-based operating systems like FreeBSD/NetBSD are not yet tested. Microsoft Windows operating systems are not natively supported but you can use WSL on Windows 10.
Assumptions
- You're using fully configured Arch Linux with sudo and pacman set up.
- You're running user with sudo permissions and not root.
- Your system is up to date (
sudo pacman -Syu
) - You're using Arch Linux and not different Arch Linux-based distribution. (most likely it will also work on them too)
Requirements/Dependencies
- core / make (for compiling, can be deleted afterwards)
- core / pkgconf (also for compiling and also can be deleted afterwards)
- core / json-c (for JSON configuration file)
- extra / clang (for compiling, can be deleted afterwards)
- extra / git (for downloading Arizona repository, can be deleted right after)
- extra / libshout (for connecting to Icecast)
- extra / mariadb-clients (for MySQL queues)
One-liner to install those packages:
sudo pacman -S make git pkgconf json-c clang mariadb-clients libshout
Downloading
With the "git" commandline tool, you can just simply download the entire repository using:
git clone https://github.com/tlpr/arizona.git
Otherwise you can manually download the .zip archive from GitHub and unpack it in your desired directory.
Compiling
Change directory to the Arizona's "src" catalogue. It's cd arizona/src/
command, assuming you're still in the directory where you executed "git clone" command. Arizona do not have ./configure
like command at this point so you can go and just execute make
to start compiling procedure. If you're absolutely sure you've followed this Wiki page step by step and you still experienced any error while compiling you can ask us for help in getting your program to work. After successful compiling you should see green, bold message. Now your program is basically ready to use and both Arizona's executable and her configuration file is present in arizona/bin/ directory, you can move to it using cd ../bin/
command, assuming you're still in directory you executed make
in.
Installation
Arizona can be installed onto a system instead of being just a portable executable. If you wish to do so you can just execute sudo make install
inside arizona/src/ directory right after compiling. After that you can just execute Arizona anywhere on the system using "arizona" command. Configuration file will be present in /etc/arizona.json
Configuring
Configuration file is pretty complex so I've made a different Wiki page for it.
Uninstallation
If you wish you can remove Arizona from your system the same way as you installed her. Just change directory to arizona/src/ and execute sudo make uninstall
command.
Cleaning up (optional)
If you've installed Arizona and want to delete packages used only for compiling and downloading you can execute this command:
sudo pacman -R git make pkgconf
Beware as those packages may be a dependency of yet different packages, if so pacman should block executing this command. Be cautious.
If you've uninstalled Arizona and want to remove any dependency associated with it you can execute:
sudo pacman -R make git pkgconf json-c clang mariadb-clients libshout
Warning above also apply here.