Skip to content

Commit 915a305

Browse files
committed
doc: add new authors, update dates, update README
1 parent eacc28f commit 915a305

File tree

3 files changed

+62
-32
lines changed

3 files changed

+62
-32
lines changed

README.rst

Lines changed: 53 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
==================================================
2-
TimeSide : audio processing framework for the web
3-
==================================================
1+
===========================================================================
2+
TimeSide : scalable audio processing framework and server written in Python
3+
===========================================================================
44

55
TimeSide is a python framework enabling low and high level audio analysis, imaging, transcoding, streaming and labelling. Its high-level API is designed to enable complex processing on very large datasets of any audio or video assets with a plug-in architecture, a secure scalable backend and an extensible dynamic web frontend.
66

@@ -24,6 +24,8 @@ Goals
2424
* **Visualize** sounds with various fancy waveforms, spectrograms and other cool graphers,
2525
* **Transcode** audio data in various media formats and stream them through web apps,
2626
* **Serialize** feature analysis data through various portable formats,
27+
* **Provide** audio sources from plateform like YouTube or Deezer
28+
* **Deliver** analysis and transcode on provided or uploaded tracks over the web through a REST API
2729
* **Playback** and **interact** **on demand** through a smart high-level HTML5 extensible player,
2830
* **Index**, **tag** and **annotate** audio archives with semantic metadata (see `Telemeta <http://telemeta.org>`__ which embed TimeSide).
2931
* **Deploy** and **scale** your own audio processing engine through any infrastructure
@@ -36,13 +38,34 @@ To fund the project and continue our fast development process, we need your expl
3638

3739
* staring or forking the project on `GitHub <https://github.com/Parisson/TimeSide>`_
3840
* tweeting something to `@parisson_studio <https://twitter.com/parisson_studio>`_ or `@telemeta <https://twitter.com/telemeta>`_
39-
* drop us an email <[email protected]>
41+
* drop us an email on <[email protected]> or <[email protected]>
4042

4143
Thanks for your help!
4244

4345
News
4446
=====
4547

48+
1.0
49+
---
50+
* Server refactoring:
51+
52+
* audio process run on items (REST API track's model)
53+
* several tools, views, models and serializers
54+
* REST API's schema on OpenAPI 3 specification and automatic Redoc generation
55+
56+
* Move core and server from Python 2.7 to 3.7
57+
* Upgrade Django to 2.2, Django REST Framework to 3.11, Celery to 4.4
58+
* Add an `Aubio <https://github.com/aubio/aubio>`_ based decoder
59+
* Add core and server processors' versioning and server process' run time
60+
* Regroup all dependencies on pip requirements removing conda use
61+
* Add :ref:`provider` as a core API component and as a REST API model
62+
* Add provider plugins :ref:`deezer-preview`, :ref:`deezer-complete` and :ref:`youtube`
63+
* Improve server unit testing
64+
* Add JWT authentication on REST API
65+
* Various bug fixes
66+
* Add core, server and workers logging
67+
68+
4669
0.9
4770
---
4871

@@ -56,7 +79,6 @@ News
5679
* Improve unit testing
5780
* Various bug fixes
5881

59-
6082
0.8
6183
---
6284

@@ -79,10 +101,10 @@ News
79101

80102
* Code refactoring:
81103

82-
- Create a new module `timeside.plugins` and move processors therein: timeside.plugins.decoder,analyzer, timeside.plugins.encoder, timeside.plugins.fx
83-
- WARNING: to properly manage the namespace packages structure, the TimeSide main module is now `timeside.core` and code should now be initialized with `import timeside.core`
84-
- `timeside.plugins` is now a `namespace package <https://pythonhosted.org/setuptools/setuptools.html#namespace-packages>`_ enabling external plugins to be **automatically** plugged into TimeSide (see for example `timeside-diadems <https://github.com/ANR-DIADEMS/timeside-diadems>`_). This now makes TimeSide a **real** plugin host, yeah!
85-
- A dummy timeside plugin will soon be provided for easy development start.
104+
* Create a new module `timeside.plugins` and move processors therein: timeside.plugins.decoder,analyzer, timeside.plugins.encoder, timeside.plugins.fx
105+
* WARNING: to properly manage the namespace packages structure, the TimeSide main module is now `timeside.core` and code should now be initialized with `import timeside.core`
106+
* `timeside.plugins` is now a `namespace package <https://pythonhosted.org/setuptools/setuptools.html#namespace-packages>`_ enabling external plugins to be **automatically** plugged into TimeSide (see for example `timeside-diadems <https://github.com/ANR-DIADEMS/timeside-diadems>`_). This now makes TimeSide a **real** plugin host, yeah!
107+
* A dummy timeside plugin will soon be provided for easy development start.
86108

87109
* Move all analyzers developped by the partners of the Diadems project to a new repository: `timeside-diadems <https://github.com/ANR-DIADEMS/timeside-diadems>`_
88110
* Many fixes for a better processing by `Travis-CI <https://travis-ci.org/Parisson/TimeSide>`_
@@ -93,13 +115,14 @@ For older news, please visit: https://github.com/Parisson/TimeSide/blob/master/N
93115
Documentation
94116
==============
95117

96-
* General documentation : http://parisson.github.io/TimeSide/
97-
* Tutorials : http://parisson.github.io/TimeSide/tutorials/index.html
98-
* API : http://parisson.github.io/TimeSide/api/index.html
99-
* Publications : https://github.com/Parisson/Telemeta-doc
100-
* Some online notebooks : http://mybinder.org/repo/thomasfillon/Timeside-demos
101-
* Player UI (v1) wiki : https://github.com/Parisson/TimeSide/wiki/Ui-Guide
102-
* A player example : http://archives.crem-cnrs.fr/archives/items/CNRSMH_E_2004_017_001_01/
118+
* General documentation: http://parisson.github.io/TimeSide/
119+
* Tutorials: http://parisson.github.io/TimeSide/tutorials/index.html
120+
* core API: http://parisson.github.io/TimeSide/api/index.html
121+
* RESTful API: https://sandbox.wasabi.telemeta.org/timeside/redoc/
122+
* Publications: https://github.com/Parisson/Telemeta-doc
123+
* Some online notebooks: http://mybinder.org/repo/thomasfillon/Timeside-demos
124+
* Player UI (v1) wiki: https://github.com/Parisson/TimeSide/wiki/Ui-Guide
125+
* A player example: http://archives.crem-cnrs.fr/archives/items/CNRSMH_E_2004_017_001_01/
103126

104127
Install
105128
=======
@@ -116,41 +139,43 @@ Then clone TimeSide::
116139

117140
That's it! Now please go to the documentation to see how to use it.
118141

119-
.. note ::
120-
121-
If you need to use TimeSide outside a docker image please refer to the rules of the Dockerfile which is based on a Debian stable system. But we do not provide any kind of free support in this usercase anymore (the dependency list is now huge). To get commercial support in more various usecases, please reach the Parisson dev team.
142+
.. note :: If you need to user TimeSide outside a docker image please refer to the rules of the Dockerfile which is based on a Debian stable system. But we do not provide any kind of free support in this usercase anymore (the dependency list is now huge). To get commercial support in more various usecases, please reach the Parisson dev team.
122143
123144
Sponsors and Partners
124145
=====================
125146

126147
* `Parisson <http://parisson.com>`_
127-
* `CNRS <http://www.cnrs.fr>`_ (National Center of Science Research, France)
128-
* `Huma-Num <http://www.huma-num.fr/>`_ (big data equipment for digital humanities, ex TGE Adonis)
129-
* `CREM <http://www.crem-cnrs.fr>`_ (french National Center of Ethomusicology Research, France)
148+
* `CNRS <http://www.cnrs.fr>`_: National Center of Science Research (France)
149+
* `Huma-Num <http://www.huma-num.fr/>`_: big data equipment for digital humanities (CNRS, France)
150+
* `CREM <http://www.crem-cnrs.fr>`_: French National Center of Ethomusicology Research (France)
130151
* `Université Pierre et Marie Curie <http://www.upmc.fr>`_ (UPMC Paris, France)
131-
* `ANR <http://www.agence-nationale-recherche.fr/>`_ (CONTINT 2012 project : DIADEMS)
152+
* `ANR <http://www.agence-nationale-recherche.fr/>`_: Agence Nationale de la Recherche (France)
132153
* `MNHN <http://www.mnhn.fr>`_ : Museum National d'Histoire Naturelle (Paris, France)
133154
* `C4DM <http://c4dm.eecs.qmul.ac.uk/>`_ : Center for Digital Music, Queen Mary University (London, United Kingdom)
134155
* `NYU Steinhardt <http://steinhardt.nyu.edu/music/>`_ : Music and Performing Arts Professions, New York University (New York, USA)
156+
* `IRCAM <https://www.ircam.fr>`_ : IRCAM (Paris, France)
135157

136158
Related projects
137159
=================
138160

139161
* `Telemeta <http://telemeta.org>`__ : Open web audio platform
140-
* `Sound archives of the CNRS <http://archives.crem-cnrs.fr/>`_, CREM and the "Musée de l'Homme" in Paris, France.
162+
* `Sound archives of the CNRS <http://archives.crem-cnrs.fr/>`_, CREM and the "Musée de l'Homme" in Paris, France
141163
* `DIADEMS <http://www.irit.fr/recherches/SAMOVA/DIADEMS/en/welcome/>`_ sponsored by the ANR.
142164
* `DaCaRyh <http://gtr.rcuk.ac.uk/projects?ref=AH/N504531/1>`_, Data science for the study of calypso-rhythm through history
143165
* `KAMoulox <https://anr-kamoulox.github.io/>`_ Online unmixing of large historical archives
144-
* NYU/CREM/Parisson : arabic music analysis
166+
* NYU+CREM+Parisson : arabic music analysis from the full CREM database
167+
* `WASABI <http://wasabihome.i3s.unice.fr/>`_: Web Audio Semantic Aggregated in the Browser for Indexation, sponsored by the ANR
145168

146169
Copyrights
147170
==========
148171

149-
* Copyright (c) 2006, 2018 Parisson Sarl
150-
* Copyright (c) 2006, 2018 Guillaume Pellerin
172+
* Copyright (c) 2019, 2020 IRCAM
173+
* Copyright (c) 2006, 2020 Guillaume Pellerin
174+
* Copyright (c) 2010, 2020 Paul Brossier
175+
* Copyright (c) 2019, 2020 Antoine Grandry
176+
* Copyright (c) 2006, 2019 Parisson SARL
151177
* Copyright (c) 2013, 2017 Thomas Fillon
152178
* Copyright (c) 2016, 2017 Eric Debeir
153-
* Copyright (c) 2010, 2014 Paul Brossier
154179
* Copyright (c) 2013, 2014 Maxime Lecoz
155180
* Copyright (c) 2013, 2014 David Doukhan
156181
* Copyright (c) 2006, 2010 Olivier Guilyardi

docs/source/copyright.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,13 @@
22
Copyrights
33
==========
44

5-
* Copyright (c) 2006, 2018 Parisson Sarl
6-
* Copyright (c) 2006, 2018 Guillaume Pellerin
5+
* Copyright (c) 2019, 2020 IRCAM
6+
* Copyright (c) 2006, 2020 Guillaume Pellerin
7+
* Copyright (c) 2010, 2020 Paul Brossier
8+
* Copyright (c) 2019, 2020 Antoine Grandry
9+
* Copyright (c) 2006, 2019 Parisson SARL
710
* Copyright (c) 2013, 2017 Thomas Fillon
811
* Copyright (c) 2016, 2017 Eric Debeir
9-
* Copyright (c) 2010, 2014 Paul Brossier
1012
* Copyright (c) 2013, 2014 Maxime Lecoz
1113
* Copyright (c) 2013, 2014 David Doukhan
1214
* Copyright (c) 2006, 2010 Olivier Guilyardi

timeside/server/views.py

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -498,7 +498,10 @@ class ResultAnalyzerView(View):
498498
def get(self, request, *args, **kwargs):
499499
result = models.Result.objects.get(uuid=kwargs['uuid'])
500500
container = AnalyzerResultContainer()
501-
container.from_hdf5(result.hdf5.path)
501+
if result.hdf5:
502+
container.from_hdf5(result.hdf5.path)
503+
else:
504+
502505
return HttpResponse(container.to_json(),
503506
content_type='application/json')
504507

0 commit comments

Comments
 (0)