From d8c06cd99e2b46b00da53850570aed6b6d52da27 Mon Sep 17 00:00:00 2001 From: Stefano Pigozzi Date: Sun, 19 May 2013 09:19:29 +0200 Subject: add Travis-CI integration Travis-CI [1] is a continous integration cloud service. It is free for open-source projects and tigthly integrated tiwh GitHub so there is really no reason for us not use it. :) For now we are going to do a total of 4 builds, mainly to test ffmpeg/libav API breakage: * ffmpeg-stable, libass-stable * ffmpeg-git, libass-stable * libav-stable, libass-stable * libav-git, libass-stable The compiler that is currently used is clang for two reasons: * running 8 build targets would be quite wasteful and take a long time * clang is less tested and used during development than gcc (especially on linux) Currently Travis doesn't support OS X environments alongside Linux ones [2]. When it will, we will add a fifth build target to test OS X compilation breakage. README was moved to markdown to add the little build status image. I ran some tests with my GitHub fork and couldn't get images to show up using ReStructured Text. [1]: https://github.com/travis-ci/travis-ci [2]: travis-ci/travis-ci#216 --- README.md | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000000..ba3fab5360 --- /dev/null +++ b/README.md @@ -0,0 +1,71 @@ +mpv +=== + +[![Build Status](https://api.travis-ci.org/mpv-player/mpv.png)](https://travis-ci.org/mpv-player/mpv) + +Overview +-------- + +**mpv** is a movie player based on MPlayer and mplayer2. It supports a wide +variety of video file formats, audio and video codecs, and subtitle types. + +If you are wondering what's different from mplayer2 and MPlayer you can read +more about the [changes][changes]. + +Compilation +----------- + +Compiling with full features requires development files for several +external libraries. Below is a list of some important requirements. For +more information see the output of `./configure --help` for a list of options, +or look at the list of enabled and disabled features printed after running +`./configure`. If you think you have support for some feature installed +but configure fails to detect it, the file `config.log` may contain +information about the reasons for the failure. + +Essential dependencies (incomplete list): + +- gcc or clang +- X development headers (xlib, X extensions, libvdpau, libGL, libXv, ...) +- Audio output development headers (libasound, pulseaudio) +- fribidi, freetype, fontconfig development headers (for libass) +- libass +- FFmpeg libraries (libavutil libavcodec libavformat libswscale libpostproc) +- libjpeg +- libquvi if you want to play Youtube videos directly +- libx264 if you want to use encoding (has to be explicitly enabled when + compiling ffmpeg) + +Most of the above libraries are available in suitable versions on normal +Linux distributions. However FFmpeg is an exception (distro versions may be +too old to work at all or work well). For that reason you may want to use +the separately available build wrapper ([mpv-build][mpv-build]) that first compiles FFmpeg +libraries and libass, and then compiles the player statically linked against +those. + +If you are running Mac OSX and using homebrew we provide [homebrew-mpv][homebrew-mpv], an up +to date formula that compiles mpv with sensible dependencies and defaults for +OSX. + +Bug reports +----------- + +Please use the [issue tracker][issue tracker] provided by GitHub to send us bug +reports or feature requests. + +Contributing +------------ + +For small changes you can just send us pull requests through GitHub. For bigger +changes come and talk to us on IRC before you start working on them. It will +make code review easier for both parties later on. + +Contacts +-------- + +You can find us on IRC in `#mpv-player` on `irc.freenode.net` + +[changes]: https://github.com/mpv-player/mpv/blob/master/DOCS/man/en/changes.rst +[mpv-build]: https://github.com/mpv-player/mpv-build +[homebrew-mpv]: https://github.com/mpv-player/homebrew-mpv +[issue tracker]: https://github.com/mpv-player/mpv/issues -- cgit v1.2.3