summaryrefslogtreecommitdiff
path: root/README.md (plain)
blob: 7d5a7efe9eaa916162d0668f1ebc19966de0dc31
1FFmpeg README
2=============
3
4FFmpeg is a collection of libraries and tools to process multimedia content
5such as audio, video, subtitles and related metadata.
6
7## Libraries
8
9* `libavcodec` provides implementation of a wider range of codecs.
10* `libavformat` implements streaming protocols, container formats and basic I/O access.
11* `libavutil` includes hashers, decompressors and miscellaneous utility functions.
12* `libavfilter` provides a mean to alter decoded Audio and Video through chain of filters.
13* `libavdevice` provides an abstraction to access capture and playback devices.
14* `libswresample` implements audio mixing and resampling routines.
15* `libswscale` implements color conversion and scaling routines.
16
17## Tools
18
19* [ffmpeg](https://ffmpeg.org/ffmpeg.html) is a command line toolbox to
20 manipulate, convert and stream multimedia content.
21* [ffplay](https://ffmpeg.org/ffplay.html) is a minimalistic multimedia player.
22* [ffprobe](https://ffmpeg.org/ffprobe.html) is a simple analysis tool to inspect
23 multimedia content.
24* [ffserver](https://ffmpeg.org/ffserver.html) is a multimedia streaming server
25 for live broadcasts.
26* Additional small tools such as `aviocat`, `ismindex` and `qt-faststart`.
27
28## Documentation
29
30The offline documentation is available in the **doc/** directory.
31
32The online documentation is available in the main [website](https://ffmpeg.org)
33and in the [wiki](https://trac.ffmpeg.org).
34
35### Examples
36
37Coding examples are available in the **doc/examples** directory.
38
39## License
40
41FFmpeg codebase is mainly LGPL-licensed with optional components licensed under
42GPL. Please refer to the LICENSE file for detailed information.
43
44## Contributing
45
46Patches should be submitted to the ffmpeg-devel mailing list using
47`git format-patch` or `git send-email`. Github pull requests should be
48avoided because they are not part of our review process and will be ignored.
49