KooZic uses Python 3.5 (or 3.6), relies on PostgreSQL as a database system and FFmpeg for music transcoding. It uses as a core system the Odoo software.
KooZic is being extensively and exclusively tested on Ubuntu 16.04. However, it should work on any Linux distribution without much trouble. In case of problem, check the Odoo installation guide, as well as the FFmpeg documentation. Windows is not supported, while it should be possible to make it work on OSX.
A Docker Compose image is available and provides an up and running installation without hassle. It should work on any Docker-supported platform (including Windows).
An installation script is provided to automatize installation, un-installation and upgrade.
In a terminal, run the following:
wget https://raw.githubusercontent.com/DocMarty84/koozic_install/v2/koozic_install.py -O koozic_install.py sudo python3 koozic_install.py install
Access KooZic in your browser at http://localhost:8069. The default login and password is “admin”. Change the password right away!.
Okay, now the details…
The installation script takes 2 optional arguments:
- -u: user (default: root)
- -d: install directory (default: /opt)
It is advised to use another user than root. Just make sure the user has access to the media folders.
The script will:
- Retrieve the latest version
- Install all the dependencies
- Setup PostgreSQL
- Install FFMpeg
- Setup a systemd service
The following platforms are supported:
- Ubuntu 18.04 & 16.04 (and derivatives, such as Linux Mint)
- Debian 9
- Fedora 29 (do not forget to check your SELinux configuration)
- CentOS 7.6 (Python 3 must be installed)
Don’t like it?
sudo python3 koozic_install.py uninstall
Note that PostgreSQL as well as the dependencies won’t be removed automatically (because I don’t want to screw your system). You might also want to remove FFMpeg at /usr/local/bin/ffmpeg.
- Install Docker Compose following the official instructions
- Download the “koozic-*-docker.tar.gz” file on GihHub.
- Edit “docker-compose.yml” and replace “/music” by the music folder you want to share.
docker-compose up -d
After ~10-20 seconds, KooZic should now be accessible in your browser at http://localhost:8069. To add your music in the library, simply create the folder ‘/mnt/host’ in the KooZic configuration.
The usual Docker instructions can be used to start and stop the container later on:
docker-compose start docker-compose stop