From Aegisub Manual

Aegisub is highly customizable and hence has a large amount of user-changeable options. These are available in the options dialog box, found in the View menu. This page is a reference of all the available options.

Aegisub stores all its configuration in a plain text file called config.dat which by default is stored in the ?user directory. If you want to reset Aegisub to its default options without reinstalling the program, you can just delete config.dat and restart Aegisub.



Image:Options general.png
  • Show Splash Screen
If enabled, Aegisub will display its splash screen when starting up.
  • Show Tip of the Day
If enabled, Aegisub will display a (potentially) useful tip of the day after starting up.
  • Auto Check for Updates
If enabled, Aegisub will periodically check whether there is a newer version available, and alert you if there is. Requires a working connection to the internet.
  • Save config.dat locally
Normally, all configuration information for Aegisub is stored in a per-user basis in each system user's home directory. On Windows, this is %APPDATA%\Aegisub\, on Mac OS X it means $HOME/Library/Application Support/Aegisub/ and on other POSIX-like systems (GNU/Linux, *BSD etc.) it's $HOME/.aegisub/. This is the default value of ?user. However, by enabling this option, ?user will instead refer to the same directory as ?data (which is not a user-specific location), effectively making all configuration global to the installation of Aegisub.
Note: This option cannot be safely used if Aegisub is installed in a "usual" program directory on some operating systems unless you are the superuser, because it requires write permission to that directory or a nearby one. For example, normal users won't have write permission to the Program Files directory on Windows Vista, and most Linux distributions have similar restrictions for /usr/share.
  • Limits for levels and recent files
These boxes all control how many files Aegisub will save in the "recently opened" submenus, and also how many undo levels will be saved. Change to your preference, but beware: the more undo levels you use, the more RAM Aegisub will consume. This is particularly noticeable with large scripts. Having lots of recently opened files stored has no real drawback except making config.dat bigger and the submenus harder to navigate, though.

General -> File save/load

Image:Options file.png
  • Auto-backup
If enabled, Aegisub will save a backup copy of each script you open, immediately on opening it. By default, it is saved to ?user/autoback/, but this can be changed (see below).
  • Auto-save every X seconds
Decides how often Aegisub should automatically save a copy of the script you are working on. Setting it to 0 disables autosaving. By default, the automatically saved copy is stored in ?user/autosave/ but this can be changed (see below).
  • Auto-save path
Decides where to save autosaved copies of scripts you are working on. By default set to autosave in your Aegisub ?user directory (see the Aegisub path specifiers page for details).
  • Auto-backup path
Decides where to save automatic backup copies of scripts. By default set to autoback in your Aegisub ?user directory.
  • Crash recovery path
Decides where Aegisub should save scripts recovered from crashes. By default set to recovered in your Aegisub ?user diectory.
  • Auto-load linked files
Whenever you save a script, Aegisub also stores some information about what video, audio and timecodes files you had open while working on it, inside the script itself. This option decides what Aegisub does with these files that are "linked" to the script when opening it. If set to "ask", Aegisub will ask you if you want to load linked files. If set to "never", Aegisub will never load linked files, and likewise if set to "always", Aegisub will always try to load linked files (and report an error if the file(s) were not found).

General -> Subtitles edit box

Image:Options editbox.png
  • Enable call tips
When enabled, Aegisub will detect when you are writing an override tag and display a small box with a brief reference of the syntax of the tag in question until you close the tag. This is called a "call tip" and the feature may be familiar to users of various programming IDE's.
  • Link committing of times
When enabled, Aegisub will commit both start and end times when you hit Enter with the mouse cursor in either time edit box. If disabled, they will be committed separately instead.
  • Enable syntax highlighting
Enables or disables syntax highlighting of override tags.
  • Overwrite-Insertion in time boxes
Controls the behavior of all time edit boxes in the program. By default, all time edit boxes in Aegisub behave like as if you had pressed the Insert button, so every digit you type overwrites what is already there, and you cannot erase numbers that are already there, you have to overwrite them. Unticking this box disables this behavior and makes the time edit boxes behave just like normal text edit boxes (almost).
  • Path to dictionary files
Decides where Aegisub will look for dictionary files for its spellchecker and thesaurus. By default it looks in ?data/dictionaries, but if you have your own dictionaries in the correct format somewhere else, feel free to point Aegisub there instead.
  • Syntax highlighter - Normal
  • Syntax highlighter - Brackets
  • Syntax highlighter - Slashes and parentheses
  • Syntax highlighter - Tags
  • Syntax highlighter - Parameters
  • Syntax highlighter - Error
  • Syntax highlighter - Error background
  • Syntax highlighter - Line break
  • Syntax highlighter - Karaoke templates
All of these decide what colors the syntax highlighter should use for various parts of the text in the subtitles edit box. "Normal" is plain normal text.
  • Modified background
Decides what background color a changed but not yet committed box should have. Does not apply to the main subtitles edit box itself.
  • Font
Decides the font and fontsize used for the subtitle edit box and other edit boxes.

General -> Subtitles grid

Image:Options grid.png
  • Allow grid to take focus
When enabled, the subtitles grid acts as its own area of the program and it can have focus, just like the audio or the video can, and while it does you can use the arrow keys/mouse wheel to scroll around it etc. On the other hand, if you disable this option, the focus will stay where it was before whenever you click in the grid. This means you can't use keyboard shortcuts in the grid anymore, but on the other hand it means you can click in the grid to go to a line without losing the audio focus and so on. Use at your own discretion.
  • Highlight subtitles that are currently visible in the video
When enabled, all subtitle lines that are currently visible in the video frame (or at least should be visible; Aegisub does not account for alpha and such trickery in this case, it only cares about the timing of the line) will be highlighted in the grid with a special background color (see the "Line in frame background" option below).
  • Standard foreground
  • Standard background
The normal color of lines in the grid. "Foreground" is the text color, and "Background" is obviously the background color.
  • Selection foreground
  • Selection background
The color of selected lines in the grid.
  • Comment background
  • Selected comment background
The background color of commented-out lines and selected commented-out lines, respectively.
  • Collision foreground
The text color of lines whose timings overlap.
  • Line in frame background
The background color of lines currently visible in the video frame.
  • Header
  • Left column
  • Active line border
  • Lines
The color of the grid lines and fixed columns/headers.
  • Font
Decides the font and font size of all text in the grid.
  • Replace override tags with:
The character that will be shown instead of override blocks if tag hiding is active.


Image:Options video.png
  • Match video resolution on open
Controls what Aegisub will do about script resolution when you open a video. If set to "never", Aegisub will do nothing if the script resolution doesn't match the video resolution. If set to "ask", Aegisub will ask you if you want to change the script resolution to match the video resolution if they don't match. If set to "always", Aegisub will always change the script resolution to match the video resolution automatically. "always" is not recommended since it just changes script resolution without resampling anything, so it will most likely break existing typesetting.
  • Default zoom
The default video zoom level. Useful if you have a very big or very small screen.
  • Fast jump step in frames
Decides how big "jumps" Aegisub will make when you use the fast seek feature (Alt-rightarrow and Alt-leftarrow). Measured in frames.
  • Screenshot save path
Decides where Aegisub should save screenshots. The default is ?video, which means they are saved to wherever the video is, but you can change it to any path you like. Aegisub path specifiers are supported; another option directly available in the dropdown is ?script, which is wherever the script is.
  • Show keyframes in slider
When enabled, Aegisub will draw keyframe markers on the video seek slider. Note that this is not supported for all video formats and/or video providers.
  • Video provider
Decides what method Aegisub should use to load video. What options you have available here depends on how your copy of Aegisub was compiled and what operating system you are running under. The following alternatives exist:
- avisynth (Windows only)
Uses Avisynth to load video. Versatile, supports loading almost all common formats as well as .d2v files (indexed DVD VOB's) if the correct plugin is supplied. Note that Aegisub can install its own avisynth.dll instead of using your system installation if so desired. Requires Video for Windows decoders for AVI files for best performance. Uses ffmpegsource() to load anything that isn't AVI (and tries that too for AVI's if no suitable VfW decoder is found).
- dshow (Windows only)
Uses Microsoft's DirectShow framework to load video. Supports loading anything you can play in, say, Windows Media Player but is slower than Avisynth. May work with really odd formats that are not supported by ffmpegsource() but you do have a DirectShow decoder for.
- ffmpeg
Uses ffmpeg directly to load video. Supports most common formats. Technically there's nothing that stops you from using this on Windows, but most Windows builds (including the official Aegisub release builds for Windows) don't have it compiled in at all (since Avisynth uses ffmpegsource() anyway).


Image:Options audio.png
  • Grab times from line upon selection
This option should really be named "Selecting lines changes audio selection", because that's what it does. When enabled, clicking a line in the grid or going to it using the next/previous line hotkeys will select the corresponding area in the audio waveform. When disabled, the selected area will always stay the same until you change it.
  • Lock scroll on cursor
When enabled, the audio waveform view will automatically scroll to follow the playback cursor if it gets too close to either of the edges.
  • Snap to adjacent lines
When enabled, Aegisub will snap the audio cursor to adjacent line start or end times if it is close enough.
  • Default mouse wheel to zoom
When enabled, the mouse wheel will zoom the audio display horizontally. If disabled, it will scroll the audio display instead.
  • Snap to keyframes
When enabled, the audio cursor will snap to keyframe lines (if you have any loaded, either from a video or from a keyframe file) if it is close enough.
  • Auto-focus on mouse over
If enabled, moving the mouse cursor over the audio waveform will automatically give it focus (as opposed to requiring a click).
  • Default timing length
The default length of a new untimed line, in milliseconds.
  • Default lead-in length
  • Default lead-out length
The duration added to the start of a line by the "add lead-in" and "add lead-out" functions. Also used in the timing postprocessor.
  • Show inactive lines
Controls how lines surrounding the currently selected line are displayed in the audio waveform. "Don't show" will only display the current line, "Show previous" will show the previous line (in the grid, not chronologically) in gray in addition to the current line, and "Show all" will show all lines in gray in addition to the current line.

Audio -> Display

Image:Options audio display.png
  • Draw secondary lines
If enabled, lines marking seconds will be drawn in the audio waveform.
  • Draw timeline
If enabled, a timeline "ruler" with markers for each quarter second will be displayed below the audio waveform.
  • Draw keyframes
If enabled, lines marking the positions of keyframes in the video will be drawn on the audio waveform.
  • Draw selection background
If enabled, the selection will be drawn in an alternate color; if disabled only the line start and end markers will show where the selection is.
  • Draw cursor time
If enabled, a timestamp showing the time since the start of the file will be drawn near the top of the audio waveform cursor.
  • Play cursor
The color of the playback cursor.
  • Background
The color of the audio waveform background.
  • Selection background
The color of the audio waveform background when it is covered by the selection.
  • Selection background - modified
The color of the audio waveform background when it is covered by the selection and the selection is detected as modified.
  • Seconds boundary
The color of the second marker lines.
  • Waveform
  • Waveform - selection
  • Waveform - modified
  • Waveform - inactive
The color of the waveform itself in various situations (selected, detected as modified, and covered by an inactive line selection respectively).
  • Boundary - start
  • Boundary - end
  • Boundary - inactive
The respective colors of the various line boundary markers.
  • Syllable text
The color of a syllable's text in karaoke mode.
  • Syllable boundary
The color of a syllable boundary line in karaoke mode.

It is not possible to change the color scheme of the spectrum display mode.

Audio -> Advanced

Image:Options audio advanced.png
  • Audio provider
What method to use for loading audio. Currently there are only two methods, which one is used depends on the platform.
- avisynth (Windows only)
Uses Avisynth to load audio. All file types will be loaded with DirectShowSource(), except for AVS files which will be opened with Import().
- lavc
Uses ffmpeg directly to load audio. Supports most common formats. Technically there's nothing that stops you from using this on Windows, but most Windows builds (including the official Aegisub release builds for Windows) don't have it compiled in at all.
Regardless of this setting, the internal PCM WAV reader will always be tried first for WAV files.
  • Audio player
What method to use for playing back audio. The options depend on the platform.
- dsound (Windows only)
Uses Microsoft DirectSound to play back audio. This is the best tested and most stable audio player.
- alsa (Linux only)
Uses the Advanced Linux Sound Architecture to play back audio. ALSA is the native sound architecture of Linux and is not available on any other systems. It is possible to select the output device to use, but this is not exposed in the Options dialogue yet.
- pulse (Linux and other *NIX-like systems)
Plays sound back through a PulseAudio sound server.
- portaudio
Use the PortAudio API to play back sound. PortAudio has different playback implementations on different platforms. On most Unices it uses Open Sound System (OSS) for output. PortAudio currently doesn't seem to work on Mac, and it is not included in Windows builds as the DirectSound player is more reliable.
- openal (Windows and Mac)
Uses the OpenAL API to play back audio. It is the only working audio player on Mac. It is not included in Windows builds due to the extra dependency it creates, and DirectSound is more reliable.
  • CacheType
Use RAM unless you have very little of it, then use Hard Disk. The cache is not needed and not used when PCM WAV files are opened. If you disable caching, audio playback might become very unreliable.
  • Avisynth down-mixer (Windows only)
Aegisub can only use mono (single-channel) audio. This option determines which Avisynth function to use to convert audio to mono. This option is only available in the Windows version of Aegisub.
  • HD cache path
  • HD cache name
These options determine where the hard disk audio cache will be located. Only used if cache is set to hard disk. You shouldn't need to change this unless you're low on disk space. For the name, the string expects a printf-style "%i" parameter, that will be replaced with a number. "%02i" is used by default, don't change that unless you know what you are doing.
  • Spectrum cutoff
The index of the smallest frequency band the audio display will show in spectrum mode. There's usually no need to change this.
  • Spectrum quality
Determines the quality of the audio spectrum display. Higher quality settings result in larger CPU and RAM use. Each consecutive setting uses a bit more CPU than the previous, and double the amount of RAM. For 48 kHz samplerate audio, one minute of audio uses this much memory at the different settings:
  • 0 "regular" - 11 MB
  • 1 "better" - 22 MB
  • 2 "high" - 44 MB
  • 3 "insane" - 88 MB
The amount of memory used does not depend on the number of channels (Aegisub always works in mono) or the bit-depth (the spectrum is always calculated in 32 bit floating point) of the audio.
  • Spectrum cache memory max
The maximum amount of memory to use for audio spectrum caching. The results of the calculations to display the audio spectrum are cached to make scrolling through the audio smoother. The amount of spectrum display that can be cached in an amount of memory depends on the quality setting above. The default cache size of 128 MB results a little less than 6 minutes of audio at 48 kHz in quality 1. If you set this smaller than 5 MB, the default of 128 MB will be used instead. You probably shouldn't set this to more than 1/4 of your amount of physical RAM installed.


Image:Options automation.png
  • Base path
Not used by the Lua scripting engine. In the future this might be used by other scripting engines.
  • Include path
List of directories where include files are searched for. Directories are separated with a pipe character, |.
  • Auto-load path
List of directories that are searched for scripts on startup, which are then automatically loaded. Directories are separated with a pipe character, |.
  • Trace level
When a script sends a message to the debug console it can also specify a trace level. If the trace level of a message is lower than the value given here, the message is not logged. The names given to the levels are only suggestions, they don't have any effect on the execution of the script. (Eg. a "Fatal" level message will not cause the script to terminate.)
  • Thread priority
Priority given to the script execution thread. If you're on a single-core/single-CPU system having this on lower than normal will make other programs more responsive while long-running scripts are active.
  • Autoreload on Export
Automatically reloads the specified sets of scripts when the Exporting dialogue is opened. Note that if a script fails to reload, no errors are displayed, it just won't show up in the Export window then. In that case you will have to enter the Automation Manager window and determine the cause of the error.


Image:Options hotkeys.png

This page shows a list of all functions in Aegisub that can be bound to keyboard shortcuts, and what shortcut (if any) they are currently assigned to. Should be self explanatory.

Double click on a hotkey in the list to change it.