fbff: more accurate seeking and vi-like marks
[fbff.git] / README
blob0495fbe2d61c9a228277ec78fdf44ce87c17185f
1 FBFF
2 ====
4 Fbff is a framebuffer/OSS media player using ffmpeg or libmpeg3.
6 USAGE
7 =====
9 To start it simply run:
11   $ fbff file.sth
13 When playing video files, audio and video may get out of sync.  So I
14 suggest using this by default:
16   $ fbff -u -s file.sth
18 And if that results in choppy playback, use:
20   $ fbff -u -s100 file.sth
22 This means record A/V diff after the first few video frames (-u)
23 and synchronize each 100 video frames (-s100).  This should work for
24 most files.
26 The following table describes fbff keybinding.  Most of these commands
27 accept a numerical prefix.  The variable avdiff is used to synchronize
28 audio and video streams.  The synchronization is done after the 's' key
29 or the pause and seek commands.  '-', '+', and 'a' keys can be used to
30 change the value of avdiff as explained below.
32 ==============  ================================================
33 KEY             ACTION
34 ==============  ================================================
35 p/space         pause
36 q               quit
37 i               print info
38 l/j/J           seek forward 10s/60s/600s
39 h/k/K           seek backward 10s/60s/600s
40 G               seek to the given minute
41 %               seek to the specified position in percents
42 ^[/escape       clear numerical prefix
43 mx              mark position as 'x'
44 'x              jump to position marked as 'x'
45 s               synchronize audio/video with A-V equal to avdiff
46 -               set avdiff to -arg
47 +               set avdiff to +arg
48 a               set avdiff to current playback A-V diff
49 c               set synchronization steps
50 ==============  ================================================
52 OPTIONS AND KEYS
53 ================
55 The following options can be specified when starting fbff:
57 ==============  ================================================
58 OPTION          DESCRIPTION
59 ==============  ================================================
60 -z x            zoom the video using ffmpeg
61 -m x            magnify the video by duplicating pixels
62 -j x            jump every x video frames; for slow machines
63 -f              start full screen
64 -v x            select video stream; '-' disables video
65 -a x            select audio stream; '-' disables audio
66 -t              use time based seeking; only if the default doesn't work
67 -s              don't rely on video framerate; always synchronize
68 -u              record avdiff after the first few frames of video
69 -r              adjust the video to the right of the screen
70 -b              adjust the video to the bottom of the screen
71 ==============  ================================================