mirror of
https://github.com/obsproject/obs-studio.git
synced 2024-07-04 10:33:30 +00:00
Update INSTALL file for Linux distributions
Add more details installation/compilation instructions for Redhat-based distros, debian-based distros, Arch Linux, Gentoo, and OpenSUSE distros Fix incomplete Debian installation instructions, and separate out instructions and package requirements that were specific to Debian-based distros. Most of the instructions in the file were previously specific only to Debian. Also added some brief instructions for an easy and minimal FFmpeg installation.
This commit is contained in:
parent
346bcd7e48
commit
15fb91ed63
132
INSTALL
132
INSTALL
|
@ -100,46 +100,106 @@ Mac OSX
|
||||||
This will create a .dmg file with an app bundle inside.
|
This will create a .dmg file with an app bundle inside.
|
||||||
|
|
||||||
|
|
||||||
Linux
|
Linux (Ubuntu 14.04 installation)
|
||||||
- You need a fairly recent Linux distribution.
|
- FFmpeg is required. If you do not have the FFmpeg installed (if you're not
|
||||||
Ubuntu 14.04 or a similar recent Linux distribution works fine, but
|
sure, then you probably don't have it), you can get it with the following
|
||||||
anything that's up-to-date should work.
|
commands:
|
||||||
Ubuntu 13.10 or older will _not_ work because of the ancient
|
|
||||||
version of libav they use.
|
|
||||||
|
|
||||||
- Because Ubuntu and Debian come with libav instead of ffmpeg, you have
|
sudo add-apt-repository ppa:jon-severinsson/ffmpeg
|
||||||
to get the original ffmpeg. Recommended:
|
sudo apt-get update && sudo apt-get install ffmpeg
|
||||||
For Ubuntu 14.04:
|
|
||||||
https://launchpad.net/~jon-severinsson/+archive/ubuntu/ffmpeg
|
|
||||||
For Debian:
|
|
||||||
http://www.deb-multimedia.org/
|
|
||||||
|
|
||||||
- There is also a ppa available in case you do not want to compile
|
- Then you can install OBS with the following commands:
|
||||||
yourself(Ubuntu 14.04 only):
|
|
||||||
https://launchpad.net/~obsproject/+archive/ubuntu/obs-studio
|
|
||||||
|
|
||||||
- Build dependencies on Ubuntu 14.04 with ffmpeg ppa from above:
|
sudo add-apt-repository ppa:obsproject/obs-studio
|
||||||
cmake libpulse-dev qtbase5-dev libqt5x11extras5-dev libavcodec-dev
|
sudo apt-get update && sudo apt-get install obs-studio
|
||||||
libavformat-dev libswscale-dev libx264-dev libswresample-dev
|
|
||||||
libfdk-aac-dev libxinerama-dev libxcomposite-dev libxrandr-dev
|
|
||||||
|
|
||||||
- Building in portable mode(assuming you are in a terminal in the
|
|
||||||
obs-studio base dir):
|
|
||||||
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DUNIX_STRUCTURE=0 -DCMAKE_INSTALL_PREFIX="${HOME}/obs-studio-portable" ..
|
|
||||||
make -j4 && make install
|
|
||||||
|
|
||||||
- After that you should have a portable install in ~/obs-studio-portable
|
Linux (Arch Linux installation, unofficial)
|
||||||
Change to bin/64bit or bin/32bit and run ./obs to run it.
|
- Link: https://aur.archlinux.org/packages/obs-studio-git
|
||||||
|
|
||||||
- If you want to install obs-studio into your system, it's recommended
|
|
||||||
to use checkinstall instead of a plain make install. It allows for a
|
|
||||||
clean uninstall and allows the package manager to keep track of the
|
|
||||||
installed files:
|
|
||||||
|
|
||||||
sudo apt-get install checkinstall
|
Linux (OpenSUSE installation, unofficial)
|
||||||
mkdir build && cd build
|
- Link: http://packman.links2linux.org/package/obs-studio
|
||||||
cmake -DUNIX_STRUCTURE=1 -DCMAKE_INSTALL_PREFIX=/usr ..
|
|
||||||
make -j4
|
|
||||||
sudo checkinstall
|
Linux (Gentoo installation, unofficial)
|
||||||
|
- Link: https://github.com/saintdev/obs-studio-overlay
|
||||||
|
|
||||||
|
|
||||||
|
Linux (Manually compiling on Redhat-based distros such as Fedora)
|
||||||
|
- Get RPM fusion at http://rpmfusion.org/Configuration/
|
||||||
|
|
||||||
|
- Set up a build environment:
|
||||||
|
|
||||||
|
sudo yum install gcc gcc-c++ gcc-objc cmake git
|
||||||
|
|
||||||
|
- If you don't care much about FFmpeg features, just get it from RPM fusion:
|
||||||
|
|
||||||
|
sudo yum install ffmpeg-devel
|
||||||
|
|
||||||
|
- Get the required packages:
|
||||||
|
|
||||||
|
sudo yum install libX11-devel libGL-devel ffmpeg-devel libv4l-devel \
|
||||||
|
pulseaudio-libs-devel x264-devel freetype-devel \
|
||||||
|
fontconfig-devel libXcomposite-devel libXinerama-devel \
|
||||||
|
qt5-qtbase-devel qt5-qtx11extras-devel
|
||||||
|
|
||||||
|
- Building and installing OBS:
|
||||||
|
|
||||||
|
git clone https://github.com/jp9000/obs-studio.git
|
||||||
|
cd obs-studio
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DUNIX_STRUCTURE=1 ..
|
||||||
|
make -j4
|
||||||
|
sudo make install
|
||||||
|
|
||||||
|
|
||||||
|
Linux (Manually compiling on Debian-based distros)
|
||||||
|
- Set up a build environment:
|
||||||
|
|
||||||
|
sudo apt-get install build-essential pkg-config cmake git checkinstall
|
||||||
|
|
||||||
|
- FFmpeg is required, and not commonly available on debian-based distros.
|
||||||
|
If you want a custom compilation with FDK AAC encoder and such, see:
|
||||||
|
|
||||||
|
https://trac.ffmpeg.org/wiki/CompilationGuide
|
||||||
|
|
||||||
|
- Otherwise, I will only give easy and brief instructions for a very minimal
|
||||||
|
FFmpeg installation:
|
||||||
|
|
||||||
|
sudo apt-get install zlib1g-dev yasm
|
||||||
|
git clone --depth 1 git://source.ffmpeg.org/ffmpeg.git
|
||||||
|
cd ffmpeg
|
||||||
|
./configure --enable-shared --prefix=/usr
|
||||||
|
make -j4
|
||||||
|
sudo checkinstall --pkgname=FFmpeg --fstrans=no --backup=no \
|
||||||
|
--pkgversion="$(date +%Y%m%d)-git" --deldoc=yes
|
||||||
|
|
||||||
|
- Get the required packages:
|
||||||
|
|
||||||
|
sudo apt-get libx11-dev libgl-dev libpulse-dev libxcomposite-dev \
|
||||||
|
libxinerama-dev libv4l-dev libudev-dev libfreetype6-dev \
|
||||||
|
libfontconfig-dev qtbase5-dev libqt5x11extras5-dev
|
||||||
|
|
||||||
|
- Building and installing OBS:
|
||||||
|
|
||||||
|
git clone https://github.com/jp9000/obs-studio.git
|
||||||
|
cd obs-studio
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DUNIX_STRUCTURE=1 -DCMAKE_INSTALL_PREFIX=/usr ..
|
||||||
|
make -j4
|
||||||
|
sudo checkinstall --pkgname=obs-studio --fstrans=no --backup=no \
|
||||||
|
--pkgversion="$(date +%Y%m%d)-git" --deldoc=yes
|
||||||
|
|
||||||
|
|
||||||
|
Linux portable mode
|
||||||
|
- You can also build in portable mode on Linux, which installs all the
|
||||||
|
files to an isolated directory:
|
||||||
|
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DUNIX_STRUCTURE=0 \
|
||||||
|
-DCMAKE_INSTALL_PREFIX="${HOME}/obs-studio-portable" ..
|
||||||
|
make -j4 && make install
|
||||||
|
|
||||||
|
After that you should have a portable install in ~/obs-studio-portable
|
||||||
|
Change to bin/64bit or bin/32bit and then simply run: ./obs
|
||||||
|
|
Loading…
Reference in a new issue