source: gs2-extensions/video-and-audio/trunk/src/opt/DSpace/README.txt@ 26186

Last change on this file since 26186 was 26186, checked in by jmt12, 12 years ago

Adding in (optional) support for video and image processing in DSpace and Terrier. These kinda belong here as they depend on the video-and-audio support (like MediaInfo, HandbrakeCLI, and Hive2) to work

File size: 2.1 KB
Line 
1===== Video Processing in DSpace =====
2
3==== Installation Instructions ====
4
51. Copy the VideoFilter into place:
6
7cd <greenstone>/ext/video-and-audio/opt/DSpace
8cp VideoFilter.java <dspace>/dspace-source/dspace-api/src/main/java/org/dspace/app/mediafilter/VideoFilter.java
9
102. Replace default ItemUpdate application with one that supports the 'noundo' flag (otherwise you're working directory will fill up with undo files for every video file processed):
11
12cd <greenstone>/ext/video-and-audio/opt/DSpace
13cp ItemUpdate.java <dspace>/dspace-source/dspace-api/src/main/java/org/dspace/app/itemupdate/ItemUpdate.java
14
153. Configure the new plugin:
16
17cd <dspace>/dspace-source/dspace/config/
18emacs dspace.cfg
19...
20#Names of the enabled MediaFilter or FormatFilter plugins
21filter.plugins = PDF Text Extractor, HTML Text Extractor, \
22 ...
23 Video Converter
24#Assign 'human-understandable' names to each filter
25plugin.named.org.dspace.app.mediafilter.FormatFilter = \
26 ...
27 org.dspace.app.mediafilter.VideoFilter = Video Converter
28#Configure each filter's input format(s)
29...
30filter.org.dspace.app.mediafilter.VideoFilter.inputFormats = MPEG2 Transport Stream
31[ctrl][s] [ctrl][x]
32
334. Recompile DSpace and update installation
34
35cd <dspace>/dspace-source
36mvn package
37cd <dspace>/dspace-source/target/dspace-1.8.2-build/
38ant update
39
405. Open the administrator's wed interface and add a new file format "MPEG2 Transport Stream" with the file extension "*.ts"
41
426. Still in the web interface, add your video files as raw TS (as exported from ReplayMe!) *or* use batch import to put in an entire directory tree as exported from Greenstone
43
447. Run the media filter from the command line to ingest video files properly (the -f forces rebuild - useful as previous media filter runs will mark documents as filtered and otherwise won't process them again):
45
46cd <dspace>/bin/
47./dspace filter-media -f
48
49(Note, you can add a "-i" argument with an internal identifier to reprocess a single video file - that's basically how parallel processing works, by calling this command, once per document, on multiple machines).
Note: See TracBrowser for help on using the repository browser.