mido


Namemido JSON
Version 1.3.2 PyPI version JSON
download
home_page
SummaryMIDI Objects for Python
upload_time2023-12-15 18:39:20
maintainer
docs_urlNone
author
requires_python~=3.7
licenseMIT
keywords python midi midifile
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            .. SPDX-FileCopyrightText: 2013 Ole Martin Bjorndalen <ombdalen@gmail.com>
..
.. SPDX-License-Identifier: CC-BY-4.0

Mido - MIDI Objects for Python
==============================

.. image:: https://img.shields.io/badge/License-MIT-blue.svg
   :alt: MIT License
   :target: https://github.com/mido/mido/blob/main/LICENSES/MIT.txt

.. image:: https://img.shields.io/pypi/v/mido.svg
   :alt: PyPi version
   :target: https://pypi.org/project/mido

.. image:: https://img.shields.io/pypi/pyversions/mido.svg
   :alt: Python version
   :target: https://python.org

.. image:: https://pepy.tech/badge/mido
   :alt: Downloads
   :target: https://pepy.tech/project/mido

.. image:: https://github.com/mido/mido/workflows/Test/badge.svg
   :alt: Test status
   :target: https://github.com/mido/mido/actions

.. image:: https://readthedocs.org/projects/mido/badge/?version=latest
   :alt: Docs status
   :target: https://mido.readthedocs.io/

.. image:: https://api.reuse.software/badge/github.com/mido/mido
   :alt: REUSE status
   :target: https://api.reuse.software/info/github.com/mido/mido

.. image:: https://www.bestpractices.dev/projects/7987/badge
           :alt: OpenSSF Best Practices
           :target: https://www.bestpractices.dev/projects/7987

Mido is a library for working with MIDI messages and ports:

.. code-block:: python

   >>> import mido
   >>> msg = mido.Message('note_on', note=60)
   >>> msg.type
   'note_on'
   >>> msg.note
   60
   >>> msg.bytes()
   [144, 60, 64]
   >>> msg.copy(channel=2)
   Message('note_on', channel=2, note=60, velocity=64, time=0)

.. code-block:: python

   port = mido.open_output('Port Name')
   port.send(msg)

.. code-block:: python

    with mido.open_input() as inport:
        for msg in inport:
            print(msg)

.. code-block:: python

    mid = mido.MidiFile('song.mid')
    for msg in mid.play():
        port.send(msg)


Full documentation at https://mido.readthedocs.io/


Main Features
-------------

* convenient message objects.

* supports RtMidi, PortMidi and Pygame. New backends are easy to
  write.

* full support for all 18 messages defined by the MIDI standard.

* standard port API allows all kinds of input and output ports to be
  used interchangeably. New port types can be written by subclassing
  and overriding a few methods.

* includes a reusable MIDI stream parser.

* full support for MIDI files (read, write, create and play) with
  complete access to every message in the file, including all common
  meta messages.

* can read and write SYX files (binary and plain text).

* implements (somewhat experimental) MIDI over TCP/IP with socket
  ports. This allows for example wireless MIDI between two
  computers.

* includes programs for playing MIDI files, listing ports and
  serving and forwarding ports over a network.


Status
------

1.3 is the fourth stable release.

This project uses `Semantic Versioning <https://semver.org>`_.


Requirements
------------

Mido requires Python 3.7 or higher.


Installing
----------

::

    python3 -m pip install mido

Or, alternatively, if you want to use ports with the default backend::

   python3 -m pip install mido[ports-rtmidi]

See ``docs/backends/`` for other backends.



Source Code
-----------

https://github.com/mido/mido/


License
-------

Mido is released under the terms of the `MIT license
<http://en.wikipedia.org/wiki/MIT_License>`_.


Questions and suggestions
-------------------------

For questions and proposals which may not fit into issues or pull requests,
we recommend to ask and discuss in the `Discussions
<https://github.com/mido/mido/discussions>`_ section.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "mido",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "~=3.7",
    "maintainer_email": "Radovan Bast <radovan.bast@gmail.com>, Rapha\u00ebl Doursenaud <rdoursenaud@gmail.com>",
    "keywords": "python,midi,midifile",
    "author": "",
    "author_email": "Ole Martin Bjorndalen <ombdalen@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/9e/a4/f9bfc7016c9fb1e348078a3455ab0d1573bcb5154dc7fc1aba9fcfe38b95/mido-1.3.2.tar.gz",
    "platform": null,
    "description": ".. SPDX-FileCopyrightText: 2013 Ole Martin Bjorndalen <ombdalen@gmail.com>\n..\n.. SPDX-License-Identifier: CC-BY-4.0\n\nMido - MIDI Objects for Python\n==============================\n\n.. image:: https://img.shields.io/badge/License-MIT-blue.svg\n   :alt: MIT License\n   :target: https://github.com/mido/mido/blob/main/LICENSES/MIT.txt\n\n.. image:: https://img.shields.io/pypi/v/mido.svg\n   :alt: PyPi version\n   :target: https://pypi.org/project/mido\n\n.. image:: https://img.shields.io/pypi/pyversions/mido.svg\n   :alt: Python version\n   :target: https://python.org\n\n.. image:: https://pepy.tech/badge/mido\n   :alt: Downloads\n   :target: https://pepy.tech/project/mido\n\n.. image:: https://github.com/mido/mido/workflows/Test/badge.svg\n   :alt: Test status\n   :target: https://github.com/mido/mido/actions\n\n.. image:: https://readthedocs.org/projects/mido/badge/?version=latest\n   :alt: Docs status\n   :target: https://mido.readthedocs.io/\n\n.. image:: https://api.reuse.software/badge/github.com/mido/mido\n   :alt: REUSE status\n   :target: https://api.reuse.software/info/github.com/mido/mido\n\n.. image:: https://www.bestpractices.dev/projects/7987/badge\n           :alt: OpenSSF Best Practices\n           :target: https://www.bestpractices.dev/projects/7987\n\nMido is a library for working with MIDI messages and ports:\n\n.. code-block:: python\n\n   >>> import mido\n   >>> msg = mido.Message('note_on', note=60)\n   >>> msg.type\n   'note_on'\n   >>> msg.note\n   60\n   >>> msg.bytes()\n   [144, 60, 64]\n   >>> msg.copy(channel=2)\n   Message('note_on', channel=2, note=60, velocity=64, time=0)\n\n.. code-block:: python\n\n   port = mido.open_output('Port Name')\n   port.send(msg)\n\n.. code-block:: python\n\n    with mido.open_input() as inport:\n        for msg in inport:\n            print(msg)\n\n.. code-block:: python\n\n    mid = mido.MidiFile('song.mid')\n    for msg in mid.play():\n        port.send(msg)\n\n\nFull documentation at https://mido.readthedocs.io/\n\n\nMain Features\n-------------\n\n* convenient message objects.\n\n* supports RtMidi, PortMidi and Pygame. New backends are easy to\n  write.\n\n* full support for all 18 messages defined by the MIDI standard.\n\n* standard port API allows all kinds of input and output ports to be\n  used interchangeably. New port types can be written by subclassing\n  and overriding a few methods.\n\n* includes a reusable MIDI stream parser.\n\n* full support for MIDI files (read, write, create and play) with\n  complete access to every message in the file, including all common\n  meta messages.\n\n* can read and write SYX files (binary and plain text).\n\n* implements (somewhat experimental) MIDI over TCP/IP with socket\n  ports. This allows for example wireless MIDI between two\n  computers.\n\n* includes programs for playing MIDI files, listing ports and\n  serving and forwarding ports over a network.\n\n\nStatus\n------\n\n1.3 is the fourth stable release.\n\nThis project uses `Semantic Versioning <https://semver.org>`_.\n\n\nRequirements\n------------\n\nMido requires Python 3.7 or higher.\n\n\nInstalling\n----------\n\n::\n\n    python3 -m pip install mido\n\nOr, alternatively, if you want to use ports with the default backend::\n\n   python3 -m pip install mido[ports-rtmidi]\n\nSee ``docs/backends/`` for other backends.\n\n\n\nSource Code\n-----------\n\nhttps://github.com/mido/mido/\n\n\nLicense\n-------\n\nMido is released under the terms of the `MIT license\n<http://en.wikipedia.org/wiki/MIT_License>`_.\n\n\nQuestions and suggestions\n-------------------------\n\nFor questions and proposals which may not fit into issues or pull requests,\nwe recommend to ask and discuss in the `Discussions\n<https://github.com/mido/mido/discussions>`_ section.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "MIDI Objects for Python",
    "version": "1.3.2",
    "project_urls": {
        "documentation": "https://mido.readthedocs.io",
        "source": "https://github.com/mido/mido"
    },
    "split_keywords": [
        "python",
        "midi",
        "midifile"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "392cdf005c4b310dde2c834431032139bf2c3924f81798013feb052d1afd543b",
                "md5": "4a3b3456a39fcaee32458e12904cbcad",
                "sha256": "9f5668d2eae78e43d54f4c651f8bf41a614eb23f98ce5179d3ddd984bf19eb58"
            },
            "downloads": -1,
            "filename": "mido-1.3.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4a3b3456a39fcaee32458e12904cbcad",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "~=3.7",
            "size": 54613,
            "upload_time": "2023-12-15T18:39:18",
            "upload_time_iso_8601": "2023-12-15T18:39:18.562847Z",
            "url": "https://files.pythonhosted.org/packages/39/2c/df005c4b310dde2c834431032139bf2c3924f81798013feb052d1afd543b/mido-1.3.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9ea4f9bfc7016c9fb1e348078a3455ab0d1573bcb5154dc7fc1aba9fcfe38b95",
                "md5": "e16447751e3d8144a4ad72219a43dbee",
                "sha256": "3aea28b6ed730f737d5b12da3578debe9dc50058fa370fe9ceded9189b67c348"
            },
            "downloads": -1,
            "filename": "mido-1.3.2.tar.gz",
            "has_sig": false,
            "md5_digest": "e16447751e3d8144a4ad72219a43dbee",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "~=3.7",
            "size": 124216,
            "upload_time": "2023-12-15T18:39:20",
            "upload_time_iso_8601": "2023-12-15T18:39:20.893096Z",
            "url": "https://files.pythonhosted.org/packages/9e/a4/f9bfc7016c9fb1e348078a3455ab0d1573bcb5154dc7fc1aba9fcfe38b95/mido-1.3.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-12-15 18:39:20",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "mido",
    "github_project": "mido",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "mido"
}
        
Elapsed time: 0.17772s