Spotter-VM/doc/applications/pandora.rst

26 lines
1.8 KiB
ReStructuredText
Raw Normal View History

2020-06-03 18:56:46 +02:00
Pan.do/ra
=========
Overview
--------
Pan.do/ra is a free, open source media archive platform. It allows to manage large, decentralized collections of video and collaboratively create metadata and time-based annotations. Pan.do/ra is a Django-based application written in python and is split to several components, most notably OxJS javascript framework and oxtimelines. It heavily relies on *ffmpeg* and uses *RabbitMQ* to pass messages between the components.
Upstream URLs
^^^^^^^^^^^^^
- Pan.do/ra: https://code.0x2620.org/0x2620/pandora
- OxJS: https://code.0x2620.org/0x2620/oxjs
- python-ox: https://code.0x2620.org/0x2620/python-ox
- oxtimelines: https://code.0x2620.org/0x2620/oxtimelines
Localization
------------
Czech localtization for Pan.do/ra currently exists only in SpotterVM repository. Separate localization is required for Pan.do/ra and OxJS framework which it uses. Moreover, the list of supported languages is hardcoded, so localization entails also modification of this fixed list of languages.
Python 3.8 compatibility
------------------------
Pandora doesn't work well under python 3.8. Specifically, the database migration won't pass. This is caused by old version of Django, which doesn't play well with the new version of psycopg2 (see https://github.com/divio/django-cms/issues/6672), however older version of psycopg2 (2.7.7 as recommended in the linked issue) can't be installed on python3.8 as it uses some undocumented feature unsupported in python3.8 (https://github.com/psycopg/psycopg2/issues/854). The way out of this for Pandora would likely be to eventually bump the required version of Django to version 2.2+ which works well with psycopg2 2.8+. Pan.do/ra maintainer is aware of this, but it's not a simple task. For the time being, Pandora is stuck on python 3.7 provided by Alpine 3.10.