django-music-publisher 18.8

Introduction

Installing the app

If you want to install the django_music_publisher app, just use pip:

pip install --upgrade django_music_publisher

Add music_publisher.apps.MusicPublisherConfig to INSTALLED_APPS, no URLs need to be added, as everything goes through the Django Admin.

You will have to add this to the settings, replace with your data.

MUSIC_PUBLISHER_SETTINGS = {
    'admin_show_publisher': False,
    'admin_show_saan': True,

    'token': None,
    'validator_url': None,
    'generator_url': None,

    'publisher_id': 'TOP',  # THE 2-3 letter CWR delivery publisher code
    'publisher_name': 'THE ORIGINAL PUBLISHER',  # the publisher name
    'publisher_ipi_name': '00000000199',  # IPI name number
    'publisher_ipi_base': 'I0000000393',  # IPI base number (rarely used)
    'publisher_pr_society': '052',  # Performing Rights Society Code
    'publisher_mr_society': '044',  # Mechanical Rights Society Code
    'publisher_sr_society': None,  # Sync Rights Society Code (rarely used)

    'library': 'THE FOO LIBRARY',  # Use only if you are in library music
    'label': 'FOO BAR MUSIC',  # Use only if you are also a label
}

For US publishers with entities in different PROs, define the “main” publisher first, which is original publisher for affiliates in the respective PRO and foreign societies. Then define ones in other PROs.

MUSIC_PUBLISHER_SETTINGS = {
    'admin_show_publisher': True,
    'admin_show_saan': False,

    'token': None,
    'validator_url': None,
    'generator_url': None,

    'publisher_id': 'FOO',
    'publisher_name': 'FOO S MUSIC PUBLISHING',
    'publisher_ipi_name': '00000000199',
    'publisher_pr_society': '071',  # SESAC
    'publisher_mr_society': '034',  # HFA
    'publisher_sr_society': None,

    'us_publisher_override': {
        'ASCAP': {
            'publisher_id': 'FOOA',
            'publisher_name': 'FOO A MUSIC PUBLISHING',
            'publisher_ipi_name': '00000000493',
            'publisher_pr_society': '010',  # ASCAP
            'publisher_mr_society': '034',  # HFA
            'publisher_sr_society': None,
        },
        'BMI': {
            'publisher_id': 'FOOB',
            'publisher_name': 'FOO B MUSIC PUBLISHING',
            'publisher_ipi_name': '00000000395',
            'publisher_pr_society': '021',  # BMI
            'publisher_mr_society': '044',  # HFA
            'publisher_sr_society': None,
        },
        'SESAC': None,  # Already defined, set to None
    },

    'library': 'FOO BAR MUSIC LIBRARY',
    'label': 'FOO BAR MUSIC',
}

When you apply for a free 15-day demo licence, additional documentation will be provided, as well as token, validator_url, and creator_url values.

Installing the project (standalone deployment)

You can only install this project on a computer that has Python 3 preinstalled. Supported versions are 3.5 and 3.6. It might work with other Python 3 versions, but not with Python 2. It is advised you run this inside a virtual environment.

Do:

python3 -m venv dmp
cd dmp
source bin/activate
git clone https://github.com/matijakolaric-com/django-music-publisher.git
cd django-music-publisher
pip install -r requirements.txt

The next step is to create dmp_project/local_settings.py or edit dmp_project/settings.py. Regardless, SECRET_KEY and MUSIC_PUBLISHER_SETTINGS (see above for details) must be set. Then:

python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

Then open the following link: http://localhost:8000/ and log in with credentials you provided.

Societies

The only optional setting is MUSIC_PUBLISHER_SOCIETIES. In the default setup, only 12 societies from six countries are present. If you need to add additional societies, do it with this setting (and not in the models.py).

Societies the original publisher and writers are affiliated with, as well as all societies whose acknowledgement files are being imported, must be present.

Validation and CWR Generation Service

As stated above, this tool uses an external service for data validation and generation of CWR files, which is a part of CWR Developer Toolset.

Free 15 day demo licence is available upon requests. Contact us through this Contact Page.

Walkthrough and Demo

Walkthrough is available in the docs folder.

Demo is available, some demo data is provided. There are two versions, the US and the World version:

• World Demo

• US Demo

More information

More information can be found in this page https://matijakolaric.com/articles/2/.