Skip to main content

Add media content to your Kotti site

Project description

This is an extension to the Kotti CMS that allows you to add audio and video to your Kotti site.

Find out more about Kotti

kotti_media uses MediaElementJS for video and audio views and thus supports native HTML5 playback on all platforms that support this. Each video can have multiple formats (MP4 (.h264 baseline profile), WebM, Ogg/Theora) to achieve this goal. For audio, supported formats include mp3 and wav. For older Platforms MediaElementJS includes a Adobe Flash / MS Silverlight plugin fallback, so that every resopurce can be played on every platform if all supported formats are uploaded.

Compatibility

For Kotti >= 0.7 use the latest release of kotti_media.

For Kotti < 0.7 use the kotti_video < 0.2.

Setup

To activate the kotti_media add-on in your Kotti site, you need to add an entry to the kotti.configurators setting in your Paste Deploy config. If you don’t have a kotti.configurators option, add one. The line in your [app:main] section could then look like this:

kotti.configurators = kotti_media.kotti_configure

With this, you’ll be able to add video and audio items in your site. Video and Audio content types are containers, into which you add specific media file types.

Work in progress

kotti_media is considered alpha software, not yet suitable for use in production environments. The current state of the project is in no way feature complete nor API stable. If you really want to use it in your project(s), make sure to pin the exact version in your requirements. Not doing so will likely break your project when future releases become available.

Development

Contributions to kotti_media are highly welcome. Just clone its Github repository and submit your contributions as pull requests.

Note that all development is done on the develop branch and master is reserved for “production-ready state”. Therefore make sure to always base your work on the current state of the develop branch.

This follows the highly recommended A successful Git branching model pattern, which is implemented by the excellent gitflow git extension.

Testing

build status

kotti_media has 100% test coverage. Please make sure that you add tests for new features and that all tests pass before submitting pull requests. Running the test suite is as easy as running py.test from the source directory (you might need to run python setup.py dev to have all the test requirements installed in your virtualenv).

TODO

  • add i18n

  • add/verify support for subtitles and chapter marks

AUTHORS

kotti_media was created by Andreas Kaiser (disko).

Initial audio support has been contibuted by Jeff Pittman (geojeff).

CHANGES

0.5.1 - 2013-07-12

  • Don’t check for data if unnecessary as it causes full loading of that column which is particular bad with media files. This is a huge performance boost on related views.

0.5 - 2013-04-25

  • Upgrade to Kotti>=0.8. This breaks backward compatibility. Pin kotti_media to “<0.5dev” if you are on Kotti 0.7.x.

  • Use Kotti’s pytest plugin.

0.4

  • Make player options user configurable.

0.3.2

  • Bugfix: respect permissions when iterating over children in media_folder_view

0.3.1

  • Fix documentation.

0.3

  • Rename package to kotti_media (was: kotti_video).

  • Add tests (100% coverage from now on).

  • Add audio support.

  • Add external URL support for CDN storage / delivery of file data.

  • Add media_folder_view for context kotti.resources.Document.

0.2

  • Release for Kotti >= 0.7dev.

0.1

  • Initial release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kotti_media-0.5.1.tar.gz (12.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page