Metadata-Version: 2.1
Name: mmusicc
Version: 0.3.0b1
Summary: a audio file and metadata synchronization program
Home-page: https://github.com/jonolt/mmusicc
Author: Johannes Nolte
Author-email: jonolt@mailbox.org
License: UNKNOWN
Project-URL: Documentation, https://mmusicc.readthedocs.io/en/latest/
Description: Metadata Music Control
        ======================
        
        |PyPI status|
        |PyPI license|
        |PyPI version mmusicc|
        |PyPI pyversions|
        |Documentation Status|
        |code style: black|
        
        .. |PyPI license| image:: https://img.shields.io/pypi/l/mmusicc.svg
           :target: https://pypi.python.org/pypi/mmusicc/
        
        .. |PyPI version mmusicc| image:: https://img.shields.io/pypi/v/mmusicc.svg
           :target: https://pypi.python.org/pypi/mmusicc/
        
        .. |code style: black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
            :target: https://github.com/psf/black
        
        .. |PyPI pyversions| image:: https://img.shields.io/pypi/pyversions/mmusicc.svg
           :target: https://pypi.python.org/pypi/mmusicc/
        
        .. |PyPI status| image:: https://img.shields.io/pypi/status/mmusicc.svg
           :target: https://pypi.python.org/pypi/mmusicc/
        
        .. |Documentation Status| image:: https://readthedocs.org/projects/mmusicc/badge/?version=latest
           :target: http://mmusicc.readthedocs.io/?badge=latest
        
        
        mmusicc is a lightweight audio file and metadata control and synchronization program to transfer the changes made in a master music library to a derived music library. New files or albums are converted using ffmpeg. When the file already exits, the metadata is compared und updated if it has changed. The individual tags and their processing can be freely selected by each user via a configuration file. There will be a simple Autofill future that can be used to fix small consistency errors, the rules will be editable in the config file (to be implemented). To Synchronize multiple folders at once, the folder structure, directory- and file-names must be identical at source and target, this should be given when this tool is used to one-way sync the master directory. Data can also be exported to or imported from a database (implementation still very basic) e.g. for a metadata backup.
        
        mmusicc shall not replace a metadata editor and only provides methods for automated syncing of large music libraries.
        
        mmusicc's source code is inspired by the two music tag programs `quodlibet <https://github.com/quodlibet/quodlibet>`_ and `puddletag <https://github.com/keithgg/puddletag/>`_ and uses some code fragments of those.
        
        
        Installation & Usage
        --------------------
        
        mmusicc is still under development and should not be used to overwrite master data. Using it for 'slave' data is perfectly fine. Multiple test confirm that the master files are not modified and only accessed. It is also tested that the program is deterministic.
        
        .. code-block:: bash
        
            pip install mmusicc
        
        The script is automatically installed on system. Use ``--help`` for usage info or see its output at `usage on mmusicc.readthedocs.org <https://mmusicc.readthedocs.io/en/latest/usage.html>`_. See also the following examples:
        
        .. code-block:: bash
        
            # syncing a full library to mp3
            mmusicc -s Music -t MusicMp3 -f .mp3 --ffmpeg-options "-codec:a libmp3lame -qscale:a 2 -codec:v copy"
        
            # syncing a full library to ogg
            mmusicc --source Music --target MusicOgg --format .ogg --ffmpeg-options "-c:a libvorbis -q 6 -vn"
        
            # syncing a full library to opus
            mmusicc --source Music --target MusicOgg --format .opus --ffmpeg-options "-c:a libopus -b:a 192000 -application audio -vn"
        
            # converting one file to another format. The two commads are equivalent
            mmusicc -s folder_source/song.flac -t . -f ogg
            mmusicc -s folder_source/song.flac -t song.ogg
        
            # saving metadata to database
            mmusicc -s Music -tdb database.db
        
            # importing metadata from database,
            # where only tags which got a value are imported leaving others untouched
            mmusicc -t MusicMp3 -sdb database.db  --lazy
        
            # syncing A to B, where all existing metadat is deleted,
            # leaving only the white listet tags on file
            mmusicc -s A -t B -f .ogg -white-list-tags track title artist delete-existing-metadata
        
        Supported Formats/Codecs
        ^^^^^^^^^^^^^^^^^^^^^^^^
        
        Supported Codecs anf Formats are displayed with ``--help`` (see `usage <https://mmusicc.readthedocs.io/en/latest/usage.html>`_).
        
        **Additional formats/codecs will be implemented on request**.
        
        For now the only formats/codecs supported are, what I need for myself.
        
        
        Remarks
        -------
        
        Catching every special case of certain metadata formats and transferring it to a normalized dict is nearly impossible (especially with id3). Also different tagging program's have certain specialities how certain uncommon tags are saved or if say are even displayed. Therefore some features are not yet or only partially supported:
        
        - Only one Album Cover file is supported at the moment. More will raise Errors (will be fixed soon).
        - Support for id3.PairedTextFrames was dropped, since it is not used much and I haven't found a good way to handle them. They might come back in the future. They are used for 'TIPL: Involved People List', 'TMCL: Musicians Credits List'. Some taggers use these field for e.g arranger.
        
        
        Version Milestones
        ------------------
        
        +--------+--------------------------------------------------------------------+
        |version | milestone                                                          |
        +--------+--------------------------------------------------------------------+
        |0.1.0   | metadata working                                                   |
        +--------+--------------------------------------------------------------------+
        |0.2.0   | mmusicc working (and first package distribution (test.pypi only))  |
        +--------+--------------------------------------------------------------------+
        |0.3.0   | comprehensive testing and verification (release on pypi)           |
        +--------+--------------------------------------------------------------------+
        |0.5.0   | interactive mode with text user interface (tui) to display changes |
        +--------+--------------------------------------------------------------------+
        |0.7.0   | mmusicc can be run in graphical mode from tui (state machine)      |
        +--------+--------------------------------------------------------------------+
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
Classifier: Topic :: Multimedia :: Sound/Audio :: Editors
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
