subed is an Emacs major mode for editing subtitles while playing the
corresponding video with mpv. At the moment, the only supported format is
- Quickly jump to next (
M-n) and previous (
M-p) subtitle text.
- Quickly jump to the beginning (
C-M-a) and end (
C-M-e) of the current subtitle’s text.
- Insert subtitles evenly spaced throughout the available space (
M-i) or right next the current subtitle (
C-M-i). A prefix argument controls how many subtitles to insert and whether they are inserted before or after the current subtitle.
- Kill subtitles (
- Adjust subtitle start (
M-]) and stop (
M-}) time. A prefix argument sets the number of milliseconds for the current session (e.g.
C-u 1000 M-[ M-[ M-[decreases start time by 3 seconds).
- Move the current subtitle or all marked subtitles forward (
C-M-n) or backward (
C-M-p) in time without changing subtitle duration. A prefix argument sets the number of milliseconds for the current session (e.g.
C-u 500 C-M-n C-M-nmoves the current subtitle 1 second forward).
- Shift the current subtitle forward (
C-M-f) or backward (
C-M-b) together with all following subtitles. This is basically a convenience shortcut for
C-SPC M-> C-M-n/p.
- Sort and re-number subtitles and remove any extra spaces and newlines
M-s). This is done automatically every time the buffer is saved.
mpv integration (optional)
- Open videos with
C-c C-vor automatically when entering subed-mode if the video file is named like the subtitle file but with a video extension (e.g.
- Subtitles are automatically reloaded in mpv when the buffer is saved.
- Cursor and playback position are synchronized:
- Playback in mpv seeks to the position of the current subtitle as the cursor moves between subtitles (~C-c ,~).
- The cursor is moved to the currently relevant subtitle as the video is
- Copy the current playback position as start (
C-c [) or stop (
C-c ]) time of the current subtitle.
- Playback is paused or slowed down when a subtitle’s text is edited (
- Loop over the current subtitle in mpv (
- When a subtitle’s start or stop time changes, mpv seeks to the subtitle’s
start time (
- Pause video playback without leaving Emacs (
For now, you have to install it manually. For example, copy
$HOME/.emacs.d/elisp/ and add
$HOME/.emacs.d/elisp/ to your
(use-package subed ;; Tell emacs where to find subed :load-path "~/.emacs.d/elisp/" :config ;; Disable automatic movement of point by default (add-hook 'subed-mode-hook 'subed-disable-sync-point-to-player) ;; Remember cursor position between sessions (add-hook 'subed-mode-hook 'save-place-local-mode) ;; Break lines automatically while typing (add-hook 'subed-mode-hook 'turn-on-auto-fill) ;; Break lines at 40 characters (add-hook 'subed-mode-hook (lambda () (setq-local fill-column 40))))
C-h f subed-mode should get you started.
subed is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.