search

lluc / Telemeta

Collaborative multimedia asset management system
http://telemeta.org
GNU Affero General Public License v3.0
1 stars 1 forks source link

readme

============================================================ Telemeta : collaborative multimedia asset management system

.. image:: https://raw.githubusercontent.com/Parisson/Telemeta/master/telemeta/static/telemeta/images/logo_telemeta_2.png :alt: Telemeta logo

Overview

Telemeta is a free and open source collaborative multimedia asset management system (MAM) which introduces fast and secure methods to archive, backup, transcode, analyse, annotate and publish any digitalized video or audio file with extensive metadata. It is dedicated to collaborative media archiving projects, research laboratories and digital humanities - especially in ethno-musicological use cases - who need to easily organize and publish documented sound collections of audio files, CDs, digitalized vinyls and magnetic tapes over a strong database, through a smart and secure platform, in accordance with open web standards.

Key features:

Telemeta has been developed since 2006 and is based exclusively on 100% open source modules.

It is mostly written in Python, HTML5 and JavaScript.

The Telemeta name stands for Tele as "remote access" and meta for "metadata".

|version| |downloads| |travis_master| |coverage_master|

.. |version| image:: https://img.shields.io/pypi/v/telemeta.svg :target: https://pypi.python.org/pypi/Telemeta/ :alt: Version

.. |travis_master| image:: https://secure.travis-ci.org/Parisson/Telemeta.png?branch=master :target: https://travis-ci.org/Parisson/Telemeta/ :alt: Travis

.. |coverage_master| image:: https://coveralls.io/repos/Parisson/Telemeta/badge.png?branch=master :target: https://coveralls.io/r/Parisson/Telemeta?branch=master :alt: Coverage

Funding and support

To fund this long time libre and open source project, we need your explicit support. So if you use Telemeta in production or even in a development or experimental setup, please let us know by:

Thank you so much for your help!

News

1.6.4 +++++

1.6 ++++

Telemeta is now usable on any OS, ready for development and for production in 5 mn! B-)

1.5.1 ++++++

More changes <http://parisson.github.io/Telemeta/category/releases.html>_.

Examples

Demo

http://demo.telemeta.org

Install

Thanks to Docker, Telemeta is now fully available as a docker composition ready to work. The docker based composition bundles some powerfull applications and modern frameworks out-of-the-box like: Python, Conda, Numpy, Jupyter, Gstreamer, Django, Celery, Haystack, ElasticSearch, MySQL, Redis, uWSGI, Nginx and many more.

Then clone Telemeta::

git clone --recursive https://github.com/Parisson/Telemeta.git
cd Telemeta

Start it up

For a production environment setup, first read / edit env/prod.env, then::

docker-compose up

Then browse the app at http://localhost:8000/ (replacing 'localhost' by the IP given by the docker terminal on OSX or Windows)

To start the application in DEBUG mode::

docker-compose -f docker-compose.yml -f env/debug.yml up

Be CAREFULL in production:

Backup / Restore

To backup the database in the data/backup/ folder, run this in another terminal (or a Docker Quickstart Terminal)::

docker-compose run db /srv/scripts/sql/backup_db.sh

To restore the last backuped database from the data/backup/ folder, run this in another terminal (or a Docker Quickstart Terminal)::

docker-compose run db /srv/scripts/sql/restore_db.sh

If the app is broken after a restore script, restart the composition with::

docker-compose restart

API / Documentation

Development

|travis_dev| |coverage_dev|

.. |travis_dev| image:: https://secure.travis-ci.org/Parisson/Telemeta.png?branch=dev :target: https://travis-ci.org/Parisson/Telemeta/ :alt: Travis

.. |coverage_dev| image:: https://coveralls.io/repos/Parisson/Telemeta/badge.png?branch=dev :target: https://coveralls.io/r/Parisson/Telemeta?branch=dev :alt: Coverage

To start the application in a development environment setup, first read / edit env/debug.env, then::

cd Telemeta
git pull
git checkout dev
docker-compose -f docker-compose.yml -f env/dev.yml up

Then browse the app at http://localhost:9000/ (replacing 'localhost' by the IP given by the docker terminal on OSX or Windows). Note that the service will automatically be reloaded when any code of the app is modified.

You are welcome to participate to the development by forking the Telemeta project on GitHub_, using it as if it were the original and submitting your changes through a Pull Request on the dev branch ONLY.

Bugs, issues, ideas

If you find some bugs or have good ideas for enhancement, please leave a issue on GitHub <https://github.com/Parisson/Telemeta/issues/new> with the right label or tweet it @telemeta <https://twitter.com/telemeta>.

And remember: even if Telemeta suits you, please give us some feedback. We need your support!

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Sponsors and partners

Related research projects

.. _Telemeta: http://telemeta.org .. _TimeSide: https://github.com/Parisson/TimeSide/ .. _OAI-PMH: http://fr.wikipedia.org/wiki/Open_Archives_Initiative_Protocol_for_Metadata_Harvesting .. _Parisson: http://parisson.com .. _CNRS: http://www.cnrs.fr .. _MCC: http://www.culturecommunication.gouv.fr .. _CREM: http://www.crem-cnrs.fr .. _HumaNum: http://www.huma-num.fr .. _IRIT: http://www.irit.fr .. _LIMSI: http://www.limsi.fr/index.en.html .. _LAM: http://www.lam.jussieu.fr .. _LABRI: http://www.labri.fr .. _MNHN: http://www.mnhn.fr .. _MMSH: http://www.mmsh.univ-aix.fr .. _UPMC: http://www.upmc.fr .. _DIADEMS: http://www.irit.fr/recherches/SAMOVA/DIADEMS/fr/welcome/&cultureKey=en .. _ANR: http://www.agence-nationale-recherche.fr/ .. _SABIOD: http://sabiod.telemeta.org .. _CHANGELOG: http://github.com/Parisson/Telemeta/blob/master/CHANGELOG.rst .. _Publications: https://github.com/Parisson/Telemeta-doc .. _API : http://files.parisson.com/doc/telemeta/ .. _Player : https://github.com/Parisson/TimeSide/ .. _Example : http://archives.crem-cnrs.fr/archives/items/CNRSMH_E_2004_017_001_01/ .. _Homepage: http://telemeta.org .. _GitHub: https://github.com/Parisson/Telemeta/ .. _IJLRDA: http://www.dalembert.upmc.fr/ijlrda/ .. _Labex-Passé_Présent: http://passes-present.eu/ .. _U-Paris10: http://www.u-paris10.fr/ .. _MdH: http://www.museedelhomme.fr/ .. _IRCAM: http://www.ircam.fr .. _TimeSide-DIADEMS: https://github.com/ANR-DIADEMS/timeside-diadems .. _DaCaRyH: http://archives.crem-cnrs.fr/archives/fonds/CNRSMH_DACARYH/ .. _Kamoulox: http://www.agence-nationale-recherche.fr/?Projet=ANR-15-CE38-0003 .. _AHRC: http://www.ahrc.ac.uk/ .. _Queen Mary University: http://www.qmul.ac.uk/ .. _SoundSoftware : http://soundsoftware.ac.uk/ .. _C4DM: http://c4dm.eecs.qmul.ac.uk/ .. _CMAM: http://www.cmam.nat.tn/