Django-music-publisher

-------------------------------

It has been well over a year since the last major version came out.
In the meantime, a new LTS version of Django Web Framework was released, so
DMP had to be updated accordingly.

Both light and dark skins have been updated. Several minor improvements were added
and the code was improved in several places.

All dependencies were bumped to the latest stable versions.


Future open-source features
===========================

Nothing is planned for the foreseeable future. Unless there is a significant
change in the industry, the next major release will be out in 2026.

Bugfix and security releases will be coming out when required.

-------------------------------

As the release name suggests, this release is a game changer. Not necessarily
in a good way for small music publishers without development/IT skills.

Since version *20 Twenty*, it was possible for anyone to deploy DMP to a free cloud
account using a wizard. The free cloud service no longer exists, so the wizard
was removed.

Deploying to Heroku and Digital Ocean is still possible for those
who can read and follow installation instructions.

``Account `` field was added to the ``Writer`` model. This field can
be used for linking royalty statement data with
accounting. This is the only visible change to an end user within DMP.

Several important projects based on TGT were released in the previous 3 years,
not only targeting music publishers, but also CMOs (societies). That is
what open source projects are really about, and DMP will in the future
be more focused on providing the core for such projects. Optionally combined
with consulting by the author and the team.

Source code has been reviewed and partly cleaned up, with average
complexity reduced to ``A`` and no block more complex than
``C``. Code style is now validated with
`Black <https://black.readthedocs.io/en/stable/>`_.

Introduction chapter of this documentation was extended with graphs,
and split into two separate documents. Several external articles were
linked to improve clarity.

----------------------------

With very little to do in the realm of music publishing, within
the defined scope, DMP has moved towards supporting music companies
who are **both publishers and labels**.

This version added support for file uploads, either locally (for
traditional installations) or to S3 storage (for containers). Please
consult :doc:`installation` for instructions how to enable and
configure file storage.

Writers, artists, labels and releases received ``image`` and
``description`` fields, to be used in front-end representations.
Recordings received an ``audio_file`` field.

Read-only REST API endpoints are available for releases and recording
artists, enabling integration with websites.

Playlists can now be created, either by manually adding recordings,
or by using batch actions in various list views, and shared
using secret URLs.

Full metadata backup can be download using REST API endpoint.

-------------------------------------------

The version focuses on improving data exchange with other
solutions, most notably `That Green Thing
<https://matijakolaric.com/thatgreenthing>`_.

* Support for writers with IPI numbers, but without CMO
affiliations was improved
* Internal notes for writers, artists and labels were added

* More data is available in CSV exports:

* separate manuscript, performance, mechanical and sync
shares for writers,
* data about an original publisher, with performance,
mechanical and sync shares,
* data about recordings, including recording ID, record
labels and recording artists, and
* society Work IDs.

* More data is available in CSV imports:

* data about recordings: ISRC, duration, release date, and
* society work IDs.

* Improved support for ISWC imports and duplicate handling.

* Interface now also available in *dark* mode

---------------------

This version was focused on improving and extending existing
features.

Support for CWR was extended to include latest revisions:

* CWR 2.1 Revision 8,
* CWR 2.2 Revision 2 (includes cross-references),
* CWR 3.0 Revision 0 (includes cross-references, experimental), and
* CWR 3.1 DRAFT (includes cross-references, experimental).

CWR Syntax highlighting was improved and now includes all fields
DMP generates from data, with more detailed descriptions on
mouse-over, for all supported CWR versions.

A side menu was added to all add/change/view pages, making
navigation faster.

------------

This version added a lot of new features!

Processing of royalty statements is the most important new feature
since the initial release. It can import statements in practically
**any** CSV format. Processing is extremely fast.

Basic CSV imports and exports for musical works, and JSON exports
for releases were added.

ISWCs can now be imported from CWR acknowledgements. Controlled
writers with no society affiliation are now fully supported.

Index (home) page became clearer due to grouping of views. User
manual was reorganised to follow the same structure. ``User manual``
links now lead to the relevant page in the user manual.