mediaComp 0.4.12

A multimedia processing library for Python 3.

mediaComp: a multimedia library for Python 3

MediaComp is a free and open-source multimedia library for Python 3 which enables the easy manipulation of images and sounds. It utilizes popular libraries to provide an abstraction of manipulating sounds, images, and colors, by abstracting the complexity into easy-to-use function calls.

History

MediaComp is a conversion of the multimedia library originally developed and released by Mark Guzdial & Barbara Ericson for use with their Introduction to Computing and Programming in Python: A multimedia Approach book (last edition ISBN 978-0-13-402554-4). It is based on Python 3, whereas the Guzdial/Ericson (G/E) version was based on Jython 2.7. Our implementation is based on Gordon College's JES4PY conversion, which implemented a subset of the original G/E multimedia library features so they could be used in Python 3. Their goal was, and ours is, to provide the pedagogical assets of the G/E multimedia library without requiring Jython or needing to use the JES IDE. While mediaComp is still a subset of the G/E implementation, it provides added functionality when compared to JESPY.

MediaComp is a conversion of only the media computation multimedia library, and does not include JES, the Jython Environment for Students, which is an educational IDE used in the Media Computation curriculum developed by Guzdial and Ericson. More details on the curriculum are available at http://www.mediacomputation.org/.

Installation

Before installing mediaComp, verify that Python is installed on your device. To find out, open a command prompt or terminal and type:

python --version

If a message like "Python 3.12.5" is displayed it means Python is installed and you can install mediaComp. If an error message occurs, check the official Python website to download it.

To install our package run:

python -m pip install mediaComp[gui]

Help

Even if you are new to mediaComp you should be able to start faily easily. Our abstractions make the functionality of the library intuitive. Full documentation can be found on our GitHub.

Credits

Thank you to everyone who has contributed to this library.

• Dave Largent (mentor)
• Jason Yoder
• CJ Fulciniti
• Santos Pena

Dependencies

MediaComp is strongly dependent on several libraries. Most of the these will install with the package, however to make sure you get wxPython with the package, install it with pip install mediaComp[gui].

Dependency	Version
wxPython	> 4.2.0
pillow	> 11.0.0
pygame	> 2.5.0
numpy	>= 2.2.1
sounddevice	>= 0.5.2

Tested IDEs

MediaComp is primarily used in the Thonny IDE, but has been used in VSCode and JetBrains PyCharm as well. If you encounter an issue using any of the three IDE's, submit an issue!

License

This package is distributed under GPL 3.0-or-later, which can be found in our GitHub repository in LICENSE. This means you can basically use mediaComp in any project you want. Any changes or additions made the package must also be released with a compatible license.