Metadata-Version: 2.1
Name: amix
Version: 0.1.7
Summary: Automatic mix of audio clips.
Home-page: https://github.com/artificialhoney/amix/
Author: Sebastian Krüger
Author-email: sk@honeymachine.io
License: MIT
Project-URL: Documentation, https://artificialhoney.github.io/amix/
Project-URL: Source, https://github.com/artificialhoney/amix/
Project-URL: Tracker, https://github.com/artificialhoney/amix/issues
Project-URL: Download, https://pypi.org/project/amix/#files
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Description-Content-Type: text/x-rst; charset=UTF-8
Provides-Extra: testing
License-File: LICENSE.txt

====
amix
====

.. image:: https://img.shields.io/pypi/v/amix.svg
    :alt: PyPI-Server
    :target: https://pypi.org/project/amix/
.. image:: https://static.pepy.tech/badge/amix/month
    :alt: Monthly Downloads
    :target: https://pepy.tech/project/amix
.. image:: https://github.com/artificialhoney/amix/actions/workflows/test.yml/badge.svg
   :alt: Test
   :target: https://github.com/artificialhoney/amix/actions/workflows/test.yml
.. image:: https://img.shields.io/coveralls/github/artificialhoney/amix/main.svg
    :alt: Coveralls
    :target: https://coveralls.io/r/artificialhoney/amix
.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
    :alt: License MIT
    :target: https://opensource.org/licenses/MIT
.. image:: https://img.shields.io/badge/-PyScaffold-005CA0?logo=pyscaffold
    :alt: Project generated with PyScaffold
    :target: https://pyscaffold.org/

Automatic mix of audio clips.

------------
Installation
------------

Make sure, to have **ffmpeg** installed.

.. code-block:: bash

    pip install amix


-----
Usage
-----

I also uploaded my first results to SoundCloud_.

.. _SoundCloud: https://soundcloud.com/honeymachine/sets/street-parade

Please check first of all the help function.

.. code-block:: bash

    amix --help

Also make sure to always obtain the latest version.

.. code-block:: bash

    amix --version

Render audio from the definition file ``amix.yml`` in the current working directory to disc.

.. code-block:: bash

    amix

Increase verbosity to also output the ``ffmpeg`` logging.

.. code-block:: bash

    amix -vv

Use a ``jinja2`` template and supply data.

.. code-block:: bash

    amix templates/amix.yml.j2 --data "full=8" "half=4" "from=7.825" "tempo=0.538" "pitch=1.1" "original_tempo=180"

Automatically create parts from clips.

.. code-block:: bash

    amix --parts_from_clips

-------------
Configuration
-------------

You can find the JSON schema here_.

.. _here: https://github.com/artificialhoney/amix/blob/main/src/amix/amix.json


A sample configuration looks like:

.. code-block:: yaml

    name: DnB
    original_tempo: 180
    parts:
      - name: backbeat_part
        bars: 16
        clips:
          - name: backbeat
    mix:
      - name: intro
        parts:
          - name: backbeat_part
