Go to file
pkviet bbac3280c1 libobs: Add surround sound audio support
(This commit also modifies the following modules: UI,
deps/media-playback, coreaudio-encoder, decklink, linux-alsa,
linux-pulseaudio, mac-capture, obs-ffmpeg, obs-filters, obs-libfdk,
obs-outputs, win-dshow, and win-wasapi)

Adds surround sound audio support to the core, core plugins, and user
interface.

Compatible streaming services: Twitch, FB 360 live
Compatible protocols: rtmp / mpeg-ts tcp udp
Compatible file formats: mkv mp4 ts  (others untested)
Compatible codecs: ffmpeg aac, fdk_aac, CoreAudio aac,
		   opus, vorbis, pcm (others untested).
Tested streaming servers: wowza, nginx
	 HLS, mpeg-dash : surround passthrough
Html5 players tested with live surround:
	 videojs, mediaelement, viblast (hls+dash), hls.js
Decklink: on win32, swap channels order for 5.1 7.1
         (due to different channel mapping on wav, mpeg, ffmpeg)
Audio filters: surround working.
Monitoring: surround working (win macOs linux (pulse-audio)).
VST:	 stereo plugins keep in general only the first two channels.
	 surround plugins should work (e.g. mcfx does).
OS: win, macOs, linux (alsa, pulse-audio).
Misc: larger audio bitrates unlocked to accommodate more channels
NB: mf-aac only supports mono and stereo + 5.1 on win 10
         (not implemented due to lack of usefulness)

Closes jp9000/obs-studio#968
2017-11-26 03:41:53 -08:00
CI CI: Update Travis script to target OSX 10.10+ 2017-10-14 23:07:53 -04:00
UI libobs: Add surround sound audio support 2017-11-26 03:41:53 -08:00
additional_install_files Improve additional_install_files for debug/release 2014-07-18 22:41:11 -07:00
cmake cmake: Enable COPY_DEPENDENCIES by default on Windows 2017-01-23 22:21:38 -08:00
config update build system to autotools (finally) 2013-10-29 23:21:40 -07:00
deps libobs: Add surround sound audio support 2017-11-26 03:41:53 -08:00
docs/doxygen Various: Optimize bundled PNG files 2017-05-05 19:56:00 +00:00
libobs libobs: Add surround sound audio support 2017-11-26 03:41:53 -08:00
libobs-d3d11 libobs-d3d11: Fix gs_enable_color 2017-11-25 18:12:52 -08:00
libobs-opengl libobs-opengl: Disable v-sync on mac 2017-10-06 06:35:56 -07:00
plugins libobs: Add surround sound audio support 2017-11-26 03:41:53 -08:00
test test: Add sync tests 2017-10-02 07:36:02 -07:00
.editorconfig .editorconfig: Add file to speed up editor configuration 2017-06-14 21:35:09 -05:00
.gitattributes Fix ffmpeg/x264 find modules according to cmake find module naming conventions 2014-05-22 13:03:47 +02:00
.gitignore Add *32 and *64 build directories to gitignore. 2014-09-23 04:56:31 -07:00
.gitmodules obs-outputs: Add FTL output 2017-08-01 02:27:34 -07:00
.mailmap mailmap: Disambiguate between another author 2017-02-22 16:04:45 +01:00
.travis.yml Build with CEF 3112 on OSX 2017-08-18 21:41:31 -05:00
AUTHORS AUTHORS: Update with data from Git and Crowdin 2017-05-20 12:16:24 +02:00
CMakeLists.txt cmake: Add _CRT_NONSTDC_NO_WARNINGS def to all projects 2017-06-27 09:55:51 -07:00
CONTRIBUTING.rst Update Linux kernel coding style URL in CONTRIBUTING 2017-04-25 23:31:37 -04:00
COPYING deps-w32-pthreads: Update FSF address 2015-07-11 09:10:27 -07:00
Doxyfile Add doxygen configuration file for obs. 2014-10-19 15:00:07 +02:00
INSTALL Replace install instructions with GitHub Wiki link 2015-07-06 15:48:12 +02:00
README.rst Improve README/CONTRIBUTING files 2017-04-07 22:33:48 -07:00
appveyor.yml CI: Update curl version used by appveyor 2017-11-26 00:15:58 -08:00

README.rst

OBS Studio <https://obsproject.com>
===================================

What is OBS Studio?
-------------------

  OBS Studio is software designed for capturing, compositing, encoding,
  recording, and streaming video content, efficiently.

  It's distributed under the GNU General Public License v2 - see the
  accompanying COPYING file for more details.

Quick Links
-----------

 - Website: https://obsproject.com

 - Help/Guides: https://github.com/jp9000/obs-studio/wiki

 - Forums: https://obsproject.com/forum/

 - Build Instructions: https://github.com/jp9000/obs-studio/wiki/Install-Instructions

 - Bug Tracker: https://obsproject.com/mantis/

   (Note: The bug tracker is linked to forum accounts.  To use the bug
   tracker, log in to a forum account)

Contributing
------------

 - If you wish to contribute code to the project, please make sure read
   the coding and commit guidelines:
   https://github.com/jp9000/obs-studio/blob/master/CONTRIBUTING.rst

 - If you wish to contribute translations, do not submit pull requests.
   Instead, please use Crowdin.  For more information read this thread:
   https://obsproject.com/forum/threads/how-to-contribute-translations-for-obs.16327/

 - Other ways to contribute are by helping people out with support on
   our forums or in our community chat.  Please limit support to topics
   you fully understand -- bad advice is worse than no advice.  When it
   comes to something that you don't fully know or understand, please
   defer to the official help or official channels.