HelpUpdate : README.audio.md

This commit is contained in:
Jerome Blanchi aka d.j.a.y
2019-07-02 19:57:56 +02:00
parent bc441c841a
commit de0da54214

View File

@@ -23,6 +23,12 @@ Veejay has limited audio support aka no fancy effects on sound. Despite that,
veejay will keep in sync the audio channel's of your clip, and transport it trough
[JACK - jackaudio.org](http://jackaudio.org/) a famous and robust low latency audio server.
Be sure veejay has NOT been configured without jack support (default jack support is enabled)
$ veejay -B|grep -i jack
If the previous command is mute, you should configure and build veejay-server again.
Veejay only has support for jackd1 (the old jack).
Prepare
-------
@@ -33,15 +39,19 @@ For example with ffmpeg/avconv you can use the "PCM signed 16-bit little-endian"
$ ffmpeg -i myvideo.mp4 -q:v 1 -vcodec mjpeg -acodec pcm_s16le -ar 48000 -s 1024x576 myvideo.avi
Your input video `myvideo.mp4` will be transcode to `mjpeg` video codec, using a video quantifier
of `1` setting the quality scale (VBR) to best image quality. The `pcm_s16le` audio codec is
selected, for a `48khz` sampling rate. Finally the output video `myvideo.avi` is resized to `1024x576`
Run
---
Veejay only has support for jackd1 (the old jack).
When you start veejay with a video containing an audio track, the jackd server is automatically started
with the default settings. But you may want to have more control.
### Start Jack audio
From terminal command, start `jackd` prior to starting `veejay` :
From terminal command, start `jackd` :
$ jackd -dalsa -P -r48000
@@ -57,12 +67,19 @@ as the loaded video files. Consequently, all your video __files must have the sa
$ veejay -m80 /path/to/myvideo.avi
Use the `-m` commandline option to allow veejay to cache video frames when sampling. This will reduce disk latency,
Use the `-m` command line option to allow veejay to cache video frames when sampling. This will reduce disk latency,
allowing for smoother audio playback (especially when used in combination of speed/pitch changes)
The `-m` commandline option is further explained in [README memory](./README.memory.md)
The `-m` command line option is further explained in [README memory](./README.memory.md)
__Nota__ : The video you start veejay with must contains a sound stream, else the jack transport is not started ... even if `-a` option.
__Others audio related options__
-a/--audio [01] Enable ( 1 ) or disable ( 0 ) audio. By default, audio is enabled.
--pace-correction [ms] Audio pace correction offset in milliseconds
-c/--synchronization [01] Sync correction off/on (default on)
-r/--audiorate <num> Set audio rate (defaults to 48Khz)
__Nota__ : The video you start veejay with must contains an audio track, else the jack transport is not started ... even with `-a1` option given.
Audio playback problems
-----------------------
@@ -80,14 +97,3 @@ A(2): You can disable veejay's multithreaded pixel operations:
A(3): Have a dedicated veejay-server machine and connect with reloaded through the network
A(4): Run with a different video codec or lower the video resolution
Keys
----
[ a,s,d,f,g,h,j,k,l ] : Increase speed 1x,2x,3x,...
ALT + [ a,s,d,f,g,h,j,k,l ] : Decrease speed (1/2,1/4, ...)
KP 6 : Play forward
KP 4 : Play backward