MediaCMS is a modern, fully featured open source video and media CMS, written in Python/Django and React, featuring a REST API.
Go to file
Shubhank Saxena 8f228d6844
Add pre-commit (#140)
* Add pre-commit config files

* Add linting test on github action
2021-05-26 17:58:17 +03:00
.github Add pre-commit (#140) 2021-05-26 17:58:17 +03:00
actions MediaCMS backend, initial commit 2020-12-15 23:33:43 +02:00
cms Set default theme in settings (#132) 2021-04-20 22:05:31 +03:00
deploy Fix docker chown recursion performance and bento4 upgrade (#95) 2021-03-22 20:04:12 +02:00
docs Update Configuration.md (#86) 2021-03-21 20:38:40 +02:00
files allow media of all states to be added to playlist (#154) 2021-04-26 16:32:18 +03:00
fixtures MediaCMS backend, initial commit 2020-12-15 23:33:43 +02:00
media_files/userlogos change default banner 2020-12-25 16:03:58 +02:00
static Updated material icons version (#54) 2021-02-17 22:30:34 +02:00
templates Set default theme in settings (#132) 2021-04-20 22:05:31 +03:00
uploader MediaCMS backend, initial commit 2020-12-15 23:33:43 +02:00
users add is_stuff to admin (#156) 2021-04-27 21:12:44 +03:00
.gitignore Add deploy/docker/local_settings.py to .gitignore (#142) 2021-04-20 21:48:43 +03:00
.mailmap initial docker deployment implementation 2021-01-23 10:49:33 +00:00
.pre-commit-config.yaml Add pre-commit (#140) 2021-05-26 17:58:17 +03:00
AUTHORS.txt Feat docker compose readme (#47) 2021-02-02 22:59:42 +02:00
docker-compose-http-proxy.yaml use mediacms image from docker hub (#69) 2021-03-08 21:54:09 +02:00
docker-compose-https-proxy.yaml use mediacms image from docker hub (#69) 2021-03-08 21:54:09 +02:00
docker-compose-named-volumes.yaml use mediacms image from docker hub (#69) 2021-03-08 21:54:09 +02:00
docker-compose.yaml use mediacms image from docker hub (#69) 2021-03-08 21:54:09 +02:00
Dockerfile Fix docker chown recursion performance and bento4 upgrade (#95) 2021-03-22 20:04:12 +02:00
install.sh add Debian Buster info on Readme 2021-05-26 17:53:13 +03:00
LICENSE.txt MediaCMS backend, initial commit 2020-12-15 23:33:43 +02:00
manage.py MediaCMS backend, initial commit 2020-12-15 23:33:43 +02:00
pyproject.toml Add pre-commit (#140) 2021-05-26 17:58:17 +03:00
README.md Add pre-commit (#140) 2021-05-26 17:58:17 +03:00
requirements.txt Add pre-commit (#140) 2021-05-26 17:58:17 +03:00
setup.cfg Add pre-commit (#140) 2021-05-26 17:58:17 +03:00

MediaCMS

MediaCMS is a modern, fully featured open source video and media CMS. It is developed to meet the needs of modern web platforms for viewing and sharing media. It can be used to build a small to medium video and media portal within minutes.

It is built mostly using the modern stack Django + React and includes a REST API.

A demo is available at https://demo.mediacms.io

Screenshots

Features

  • Complete control over your data: host it yourself!
  • Support for multiple publishing workflows: public, private, unlisted and custom
  • Modern technologies: Django/Python/Celery, React.
  • Multiple media types support: video, audio, image, pdf
  • Multiple media classification options: categories, tags and custom
  • Multiple media sharing options: social media share, videos embed code generation
  • Easy media searching: enriched with live search functionality
  • Playlists for audio and video content: create playlists, add and reorder content
  • Responsive design: including light and dark themes
  • Advanced users management: allow self registration, invite only, closed.
  • Configurable actions: allow download, add comments, add likes, dislikes, report media
  • Configuration options: change logos, fonts, styling, add more pages
  • Enhanced video player: customized video.js player with multiple resolution and playback speed options
  • Multiple transcoding profiles: sane defaults for multiple dimensions (240p, 360p, 480p, 720p, 1080p) and multiple profiles (h264, h265, vp9)
  • Adaptive video streaming: possible through HLS protocol
  • Subtitles/CC: support for multilingual subtitle files
  • Scalable transcoding: transcoding through priorities. Experimental support for remote workers
  • Chunked file uploads: for pausable/resumable upload of content

Example cases

  • Schools, education. Administrators and editors keep what content will be published, students are not distracted with advertisements and irrelevant content, plus they have the ability to select either to stream or download content.

  • Organization sensitive content. In cases where content is sensitive and cannot be uploaded to external sites.

  • Build a great community. MediaCMS can be customized (URLs, logos, fonts, aesthetics) so that you create a highly customized video portal for your community!

  • Personal portal. Organize, categorize and host your content the way you prefer.

Philosophy

We believe there's a need for quality open source web applications that can be used to build community portals and support collaboration.

We have three goals for MediaCMS: a) deliver all functionality one would expect from a modern system, b) allow for easy installation and maintenance, c) allow easy customization and addition of features.

License

MediaCMS is released under GNU Affero General Public License v3.0 license. Copyright Markos Gogoulos and Yiannis Stergiou

Support and paid services

We provide custom installations, development of extra functionality, migration from existing systems, integrations with legacy systems, training and support. Contact us at info@mediacms.io for more information.

Hardware dependencies

For a small to medium installation, with a few hours of video uploaded daily, and a few hundreds of active daily users viewing content, 4GB Ram / 2-4 CPUs as minimum is ok. For a larger installation with many hours of video uploaded daily, consider adding more CPUs and more Ram.

In terms of disk space, think of what the needs will be. A general rule is to multiply by three the size of the expected uploaded videos (since the system keeps original versions, encoded versions plus HLS), so if you receive 1G of videos daily and maintain all of them, you should consider a 1T disk across a year (1G * 3 * 365).

Installation

There are two ways to run MediaCMS, through Docker Compose and through installing it on a server via an automation script that installs and configures all needed services.

Docker Compose installation

Install a recent version of Docker, and Docker Compose.

Run as root

git clone https://github.com/mediacms-io/mediacms
cd mediacms

The default option is to serve MediaCMS on all ips available of the server (including localhost).

Now run

docker-compose up

This will download all MediaCMS related Docker images and start all containers. Once it finishes, MediaCMS will be installed and available on http://localhost or http://ip

For more instructions, checkout the docs on the Docker deployment page. Docker Compose support has been contributed by @swiftugandan.

Single server installation

The core dependencies are Python3, Django3, Celery, PostgreSQL, Redis, ffmpeg. Any system that can have these dependencies installed, can run MediaCMS. But we strongly suggest installing on Linux Ubuntu 18 or 20 versions.

Installation on a Ubuntu 18 or 20 system with git utility installed should be completed in a few minutes with the following steps. Make sure you run it as user root, on a clear system, since the automatic script will install and configure the following services: Celery/PostgreSQL/Redis/Nginx and will override any existing settings.

Automated script - tested on Ubuntu 18, Ubuntu 20, and Debian Buster

mkdir /home/mediacms.io && cd /home/mediacms.io/
git clone https://github.com/mediacms-io/mediacms
cd /home/mediacms.io/mediacms/ && bash ./install.sh

The script will ask if you have a URL where you want to deploy MediaCMS, otherwise it will use localhost. If you provide a URL, it will use Let's Encrypt service to install a valid ssl certificate.

Update

If you've used the above way to install MediaCMS, update with the following:

cd /home/mediacms.io/mediacms # enter mediacms directory
source  /home/mediacms.io/bin/activate # use virtualenv
git pull # update code
python manage.py migrate # run Django migrations
sudo systemctl restart mediacms celery_long celery_short # restart services

Configure

Several options are available on cms/settings.py, most of the things that are allowed or should be disallowed are described there. It is advisable to override any of them by adding it to cms/local_settings.py. All configuration options will be documented gradually on the Configuration page.

Authors

MediaCMS is developed by Yiannis Stergiou and Markos Gogoulos. We are Wordgames - https://wordgames.gr.

Technology

This software uses the following list of awesome technologies:

  • Python
  • Django
  • Django Rest Framework
  • Celery
  • PostgreSQL
  • Redis
  • Nginx
  • uWSGI
  • React
  • Fine Uploader
  • video.js
  • FFMPEG
  • Bento4

Who is using it

Thanks To

  • Anna Helme, for such a great partnership all these years!

  • Steve Anderson, for trusting us and helping the Wordgames team make this real.

  • Andrew Lowenthal, King Catoy, Rezwan Islam and the rest of the great team of Engage Media.

  • Ioannis Korovesis, Ioannis Maistros, Diomidis Spinellis and Theodoros Karounos, for their mentorship all these years, their contribution to science and the promotion of open source and free software technologies.

  • Antonis Ikonomou, for hosting us on the excellent Innovathens space.

  • Werner Robitza, for helping us with ffmpeg related stuff.

How to contribute

If you like the project, here's a few things you can do

  • Hire us, for custom installations, training, support, maintenance work
  • Suggest us to others that are interested to hire us
  • Write a blog post/article about MediaCMS
  • Share on social media about the project
  • Open issues, participate on discussions, report bugs, suggest ideas
  • Star the project
  • Add functionality, work on a PR, fix an issue!
  • Before you send a PR, make sure your code is properly formatted. For that, use pre-commit install to install a pre-commit hook and run pre-commit run --all and fix everything before you commit. This pre-commit will check for your code lint everytime you commit a code.

Contact

info@mediacms.io