Unix Instructions

From Aegisub Wiki

Jump to: navigation, search

This page contains instructions and information on installing Aegisub on UNIX or UNIX-style systems. For Windows building instructions, see Build Instructions. For Windows binaries, see Windows downloads. If you have any issues building Aegisub, please drop us a line in the official IRC channel. Please note that the SVN version of Aegisub is not supported, you are on your own!

Contents

[edit] Tarball Prerequisites

[edit] Required

As the name implies you need these.

package required version notes
gettext >= 0.14.5
wxWidgets >= 2.8 Compiled with OpenGL support.
wxStyledTextCtrl (wxSTC) >=2.8 Ships with wxWidgets in /contrib.
OpenGL Any Any modern version.
GLU Any OpenGL utility library, any modern version.
FreeType2 >=2.3.5

[edit] Audio / Visual

Not all of these are necessary and Aegisub's core can be built without any of these but you will probably want FFmpeg, libass (and/or ASA) and at the very least one of the audio players (even if you compiled Aegisub without FFmpeg because Aegisub has its own internal PCM audio provider which has some limitations (see the linked section for details).

package required version feature notes
ALSA 1.0.16?? Audio Player Unstable, 1.0.16 confirmed to work, status of other versions unknown.
FFmpeg 2007-10-04 Audio and Video Provider Any version on or around this date (newer may or may not work, older will probably break).
asa HEAD Overlay Current CVS version.
libass N/A Overlay Included w/aegisub.
PortAudio v18 Audio Player v19 does not work.
PulseAudio 0.9.5 Audio Player Randomly crashes aegisub.
OpenAL >= 20060211 Audio Player Originally intended only for Mac OS X but known to work very well on both Linux and Windows. For now it can be considered as the recommended audio player.

[edit] Scripting

Neither of these are required but if you intend to create advanced ASS-based effects or write Aegisub macros you will probably want Automation 4 (auto4).

package required version notes
Lua >= 5.1.1 For auto4.
Lua >= 5.0.3 For auto3 which is depreciated, please use auto4 for new scripts.
PERL >= 5.8.8 Incomplete and unmaintained.
Ruby >= 1.8.6.111 Incomplete and unmaintained for a long time.

[edit] Miscellaneous

glibc has iconv included in it (all known Linux distributions are using glibc).

package required version feature notes
hunspell 1.1.9 or >= 1.2.2 Spelling support Newer version recommended
iconv >= 1.11 Overlay Required for libass and ASA.
FontConfig >= 2.4.2 Overlay Required for libass and ASA.

[edit] Dependency Notes

[edit] wxWidgets

Before attempting to install wxWidgets from source try to find binary packages for your OS. wxSTC should be included in any wxWidget '-contrib' packages.

See http://wiki.wxwidgets.org/Compiling_and_getting_started for build instructions. Please note that you must pass along the flags --enable-unicode, --with-opengl and --with-stc to get the proper support. Don't forget to do a 'make install' in the contrib/ directory to install wxSTC.

[edit] ASA

See the guide on the asa wiki.

[edit] Known Issues

Any issue listed here is in line to be fixed. (no particular order) They may or may not have a corrosponding bug in the bug tracker, if it does the bug # will be listed here.

[edit] Program

  1. Spelling - You must fix the dictionary paths to be absolute not relative in the settings dialogue.
  2. Version Information - This hasn't been fixed for the new build
  3. ALSA - Badly broken on some systems
  4. PulseAudio - Causes aegisub to crash randomly.
  5. Update checker - Often causes crashes on non-Windows platforms. Try manually disabling automatic update checks by editing ~/.aegisub/config.dat if you get crashes on startup.

[edit] Audio

  1. While the audio demuxer / transcoder has been fixed there is still a very slight jitter (less than 5ms) over using LAME. All other formats should (note: should) work correctly. It should be noted than the jitter would not be noticeable to anyone watching the video.
    1. Only signed 16 and unsigned 8 bit little endian PCM WAV is known to work, other versions may work. Since Aegisub handles these internally you can load and time audio without Video Support.
  2. There is an ALSA related problem that can lock X11 (i.e. your GUI) while timing. Note that Linux has only two ways to output audio ALSA and OSS, which is deprecated and usually provided via compatibility layer in ALSA, hence even OpenAL, PortAudio and PulseAudio will exhibit the said problem because they too output audio via ALSA. For now the only always working lifesaver (reboot evader in other words) is killing Aegisub. In case of GUI lockup you will have to switch to a tty to kill Aegisub. If that's too hard. you can with few seconds interval enter REISUB (Raising Elephants Is Utterly Boring) while holding Alt+SysRq (a.k.a. the magic SysRq key), which will reboot your computer in more or less safe manner. You can also try Ctrl+Alt+Backspace to restart only X11 before resorting to the magic SysRq key.

[edit] Video

Aegisub doesn't support loading raw video, you must mux it into some container before loading it.

  1. AVI is known to work, MP4 is unconfirmed but preferred for H.264 until the MKV issues are fixed.
  2. MKV - Kind of works if you have a sufficiently recent compile of FFmpeg, but its MKV splitter still has issues and may for example report all frames as keyframes with some files. Frame accuracy possible but not guaranteed. Demux using mkvextract first (keep in mind that raw video is not supported so you might want to remux to MP4).

[edit] Scripting

  1. Perl - Unstable, needs a maintainer.
  2. Ruby - Unstable, needs a maintainer.

[edit] Compiling Aegisub

[edit] Tarball (supported)

Please check to ensure you've installed all the required dependencies 

# ./configure
  • Check that all libraries you want to compile with were detected properly by configure. Then: 
# make
  • Install: 
# make install
  • Enjoy 
# aegisub

[edit] SVN (UNSUPPORTED!)

These are only required if you're building from SVN. Do this only if you know what you are doing.

package required version notes
Imagemagick >= 6.3.7.0 Older versions may work.
glib (glib-gettextize binary) >= 2.16.3 Modifed version of gettextize from gettext, this is the only thing required from glib.
automake >= 1.9.6
autoconf >= 2.61
libtool >= 1.5.24
intltool >=0.31
  • Checkout the latest source from the SVN repository: 
svn co http://svn.aegisub.net/trunk/ aegisub
  • Generate 'configure', config.h and other related build files. 
# ./autogen.sh
  • If you get the following error when running autogen: 
configure.in:774: error: possibly undefined macro: AM_OPTIONS_WXCONFIG
    If this token and others are legitimate, please use m4_pattern_allow.
The solution is to find wxwin.m4 and add it to your general aclocal directory. (/usr/local/share/aclocal or /usr/share/aclocal on most systems)
  • autogen should have run configure, you can pass the configure flags along with it or re-run configure again with your options 
# ./configure
  • Check that all libraries you want to compile with were detected properly by configure, then: 
# make
  • Install 
# make install

The binary is called 'aegisub'.

[edit] Unofficial Binary Packages

If your OS isn't listed here please follow Compiling Aegisub

[edit] Ubuntu 8.04

Builds by Light- (Ubuntu 8.04 + variants ONLY) are available here
Please make sure you have the latest .deb and have read the instructions and known issues carefully before reporting any problems.

[edit] Ubuntu 7.04

Very outdated, not recommended: http://download.ubuntu.pl/_Feisty_Fawn/aegisub/aegisub_2.00-alpha-2_i386.deb (snapshot from 07.08.2007)

[edit] Unofficial Guides

These are unofficial guides, they may be out-dated or incorrect please do not come for support when using any of them.

[edit] Ubuntu 8.04 and Fedora Core 9 specific instructions

http://lulzicon.com/?page_id=9

Retrieved from "http://www.malakith.net/aegiwiki/Unix_Instructions"
Personal tools