Package: demodocus
demodocusis Python CLI program to quickly check synchronization
maps.Version: 1.0.0Date: 2015-12-12Developer:Alberto PettarinLicense: the MIT License (MIT)Contact:click hereInstallationUsing pipOpen a console and type:$[sudo]pipinstalldemodocusThat’s it! Just run without arguments (or with-hor--help)
to get the manual:$demodocusMake sure to haveffmpeginstalled and available on yourPATHenvironment variable, see below.From source codeGet the source code:clone this repo withgit:$gitclonehttps://github.com/pettarin/demodocus.gitor download thelatest
releaseand
uncompress it somewhere,or download thecurrent master
ZIPand uncompress it somewhere.Open a console and enter thedemodocus(cloned) directory:$cd/path/to/demodocusInstall the requirements:$[sudo]pip-rrequirements.txtThat’s it! Just run without arguments (or with-hor--help)
to get the manual:$python-mdemodocusMake sure to haveffmpeginstalled and available on yourPATHenvironment variable, see below.DependenciesPython, version 2.7.x or 3.4.x (or above)ffmpeg: download it fromhttps://www.ffmpeg.org/or install it
with your packet managerpyaudio: install it viapip:$[sudo]pipinstallpyaudio(if a compilation error appears, check that you have the PortAudio
1.9 headers available: in Debian, they are provided by theportaudio19-devpackage)Usageusage:
  $ demodocus -h
  $ demodocus -a AUDIO -s SYNCMAP [OPTIONS]

description:
  Run an interactive CLI tool to verify that SYNCMAP has a good alignment against AUDIO.
  The sync map file can be in JSON or SSV/SSVH format (auto-detected).

optional arguments:
  -h, --help            show this help message and exit
  -a AUDIO, --audio AUDIO
                        path to the audio file
  -c, --continuous      keep going (default: False)
  -d DURATION, --duration DURATION
                        play audio for max DURATION seconds (default: 2)
  -i INCREMENT, --increment INCREMENT
                        play audio every INCREMENT fragments (default: 1)
  -s SYNCMAP, --syncmap SYNCMAP
                        path to the sync map file
  -v, --version         print version and exit
  -w WAIT, --wait WAIT  wait WAIT seconds before playing the next fragment
                        (default: 0)

examples:

  $ demodocus -a audio.mp3 -s syncmap.json
    Check audio.mp3 against syncmap.json with default parameters (2 seconds, all fragments)

  $ demodocus -a audio.mp3 -s syncmap.ssv
    As above, but the sync map file has SSV format

  $ demodocus -a audio.mp3 -s syncmap.json -d 1
    Play each fragment for max 1 second

  $ demodocus -a audio.mp3 -s syncmap.json -d 3 -i 5
    Play every 5 fragments, for max 3 seconds each

  $ demodocus -a audio.mp3 -s syncmap.json -d 3 -i 5 -w 0.5
    Pause for 0.5 seconds before playing next fragment

  $ demodocus -a audio.mp3 -s syncmap.json -c -i 5 -d 1.5 -w 0.5
    Play every 5 fragments, 1.5 seconds each, continuously, pausing for 0.5 secondsLicensedemodocusis released under the MIT License.Limitations and Missing FeaturesThe input file must be converted to WAVE before running: slow for
very large input filesDependency fromffmpeg, called viasubprocessto convert the
input file to WAVEDependency frompyaudio, which in turns depends onPortAudioNo testsNo documentation