Repository files navigation

Simple extensible ASS subtitle editor for Linux

• Python - easily extend it however you want
• Video preview
• Audio preview (spectrogram)
• Video band for quick assessment of scene boundaries
• Audio and video are synced at all times
• Spectrogram shows where subs start and end
• Slow playback support (with audio pitch correction)
• I can sub an entire episode without ever having to touch the mouse
• Mouse users are not excluded and can click their way to all the commands
• Robust plugin API (everything GUI is capable of can be done through the API)
• Simple architecture (Commands ↔ API ↔ GUI)
• Separate control for persistent inline comments (useful for translating)
• Newlines support in the editor
• Everything is aligned to video frames
• Style editor with realistic preview
• Vim mode in the text editor (off by default, requires neovim 0.4+)
• No bloat

• Install system dependencies
  • Python 3.9
  • libmpv
  • ffms
  • fftw (pip install cython first)
  • Qt5 bindings
• Clone the repository:git clone https://github.com/bubblesub/bubblesub
• Enter its directory:cd bubblesub
• Installbubblesub:pip install --user .
• Run bubblesub:python3 -m bubblesub or simplybubblesub

If you want to simplifybubblesub installation, look at ourDockerfile.You will find what dependencies are needed, how to install them and how to runour tests.

Please seethis file.

For the API documentation, for now please consult the docstrings in thebubblesub.api module. In the future, if bubblesub experiences a boost inpopularity, this might be improved.

• $XDG_CONFIG_HOME/bubblesub/: contains user configuration
  • options.yaml: general options
  • hotkeys.conf: configurable user hotkeys
  • menu.conf: configurable additional user menus
• $XDG_CONFIG_HOME/bubblesub/scripts: contains user plugins (seeexampleplugin)
• $XDG_CACHE_HOME/bubblesub/: used to cache time codes and such

1. I want to report a bug.

   Please use GitHub issues.

2. I want a feature.

   Chances are I'm too busy to work on features I don't personally need,so pull requests are strongly encouraged.

3. Why not aegisub?

   Because it doesn't cover my needs, it's too convoluted and its developmentis too slow.

4. Windows builds?

   You can find a Windows build for bubblesubhere.
   I don't maintain it, so please contact the current developer if you find some issue.

5. Versioning? PyPI?

   I don't say no, maybe in the future, if the project gets more popular.For now,git master is the way to go.

Issue tracker:GitHub issues

I'd like to thank allcontributors for thehelp on this project.
The lovely logo was donated by fri. Thanks :)