KooZic uses Python 2.7, 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 trouble, 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 image is available and provides an up and running installation without hassle. It should work on any Docker-supported platform (including Windows).
Initialize & Run KooZic
First, follow the instructions below corresponding to your distribution in order to install the dependencies.
Then, go in the directory where you downloaded KooZic. Note that the path cannot contain special characters (such as é, à, ç… For example, ‘/home/user/Téléchargement’ will lead to errors). Initialize the system:
./odoo-bin -i oomusic,oovideo -d koozic --without-demo=all --stop-after-init
Once the script has stopped, you are good to go! The server will run by default on port 8069 by running:
Access KooZic in your browser at http://localhost:8069. The default login and password is “admin”. Change the password right away! Moreover, set a master password to secure the database at http://localhost:8069/web/database/manager.
Dependencies on Debian & Ubuntu
On Ubuntu 16.04, everything is pretty much available out-of-the box.
Install the dependencies:
sudo apt install adduser node-less postgresql-client python python-dateutil python-decorator\ python-docutils python-feedparser python-imaging python-jinja2 python-ldap python-libxslt1\ python-lxml python-mako python-mock python-openid python-passlib python-psutil python-psycopg2\ python-pybabel python-pychart python-pydot python-pyparsing python-pypdf python-reportlab\ python-requests python-suds python-tz python-vatnumber python-vobject python-werkzeug\ python-xlsxwriter python-xlwt python-yaml postgresql python-mutagen ffmpeg mediainfo
Create the user in PostgreSQL. It should be the same user than the one you will use to run KooZic:
sudo su - postgres -c "createuser -s <your_user>"
If you are facing issues with the scan of your library (e.g. missing songs), we suggest to install Pytaglib. It should accept more easily incorrect music files.
sudo apt install python-dev libtag1-dev python-pip
Install the package pytaglib thanks to pip, since it is not available in the repositories for Python 2:
sudo pip install pytaglib
Dependencies on Fedora
KooZic has been tested on Fedora 25.
ffmpeg should first be installed. It is available in the rpmfusion repositories.
Install the dependencies:
dnf install babel libxslt-python nodejs-less pychart pyparsing python-babel python-dateutil\ python-decorator python-docutils python-feedparser python-imaging python-jinja2 python-ldap\ python-lxml python-mako python-mock python-openid python-passlib python-psutil python-psycopg2\ python-reportlab python-requests python-vobject python-werkzeug python-xlwt python-yaml pytz\ postgresql postgresql-server postgresql-libs postgresql-contrib postgresql-devel python-mutagen mediainfo
Install extra dependencies thanks to easy_install:
easy_install pyPdf vatnumber pydot suds ofxparse XlsxWriter
mkdir -p /var/lib/postgres/data chown -R postgres:postgres /var/lib/postgres/data
As postgres user:
su - postgres initdb -D /var/lib/postgres/data -E UTF-8 pg_ctl -D /var/lib/postgres/data -l logfile start createuser -s <your_user>
If you are still facing issues to install the dependencies, you might have a look at the package files. They will give you some clues on how dependencies can be installed.
After installing Docker, run the following command to download the latest KooZic image:
docker run -d -p 8069:8069 -p 8072:8072 -v <host_folder>:/mnt/host:ro --name koozic docmarty84/koozic
‘<host_folder>’ is the local folder containing your music.
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 start koozic docker stop koozic