smacke/ffsubsync

View on GitHub

Automagically synchronize subtitles with video.

Stars: 7.9k
Forks: 323
Open beginner issues: 0
Indexed issues: 68

Dominant language: Python
License: MIT
Last GitHub push: Jul 24, 2026
Latest indexed: Sep 19, 2026
Contributing guide: No contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

68 open issues indexed

Default `subs_then_webrtc` VAD aligns against forced-only embedded subtitle stubs, producing ±60 s offsets on in-sync subtitles Open

Difficulty 4/5 3-5 days Newbie friendliness 55/100

smacke/ffsubsync#238 · Opened Sep 16, 2026
Are there any chance to have this as a VLC plugin? Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

smacke/ffsubsync#219 · 1 comment · 1 reaction · Opened Aug 29, 2025
Option to give a time code where to reset synchronisation Open

enhancement

Difficulty 4/5 3-5 days Newbie friendliness 35/100

smacke/ffsubsync#218 · 1 reaction · Opened Aug 29, 2025
can i show subtitles over video at the same time ? Open

out-of-sync

Difficulty 5/5 Over a week Newbie friendliness 20/100

smacke/ffsubsync#215 · Opened Jul 21, 2025
[Feature Request] Docker image + batch processing Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

smacke/ffsubsync#214 · 1 comment · 1 reaction · Opened Jun 13, 2025
Can i sync embedded subtitles with the audio track? Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

smacke/ffsubsync#213 · Opened May 30, 2025
[Feature Request] Force voice activity synchronization Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

smacke/ffsubsync#210 · 1 comment · Opened Apr 27, 2025
Installation help page Open

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

smacke/ffsubsync#206 · Opened Feb 2, 2025
won't install Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 25/100

smacke/ffsubsync#198 · 13 comments · 1 reaction · Opened Nov 7, 2024
ffmpeg minimum version check for error handling for VAD failures Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 45/100

smacke/ffsubsync#196 · Opened Oct 27, 2024
[Feature Request] Stremio add-on Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

smacke/ffsubsync#190 · 1 comment · 2 reactions · Opened Jun 25, 2024
Bazarr's "Automatic Subtitle Sync" sometimes cuts off the first minute of subtitles when using "No Fix Framerate" Open

out-of-sync

Difficulty 3/5 1-2 days Newbie friendliness 25/100

smacke/ffsubsync#189 · 2 comments · Opened Jun 13, 2024
output subtitles still out of sync Open

out-of-sync

Difficulty 5/5 Over a week Newbie friendliness 25/100

smacke/ffsubsync#188 · 1 comment · 2 reactions · Opened Apr 12, 2024
[Feature Request] Add option to specify ffmpeg exe path Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

smacke/ffsubsync#184 · 5 comments · Opened Nov 16, 2023
[Feature Request] Add an option to extract serialize/reference data as subtitle file Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

smacke/ffsubsync#183 · Opened Nov 14, 2023
Broken link: test-data Open

bug

Difficulty 2/5 1-3 hours Newbie friendliness 15/100

smacke/ffsubsync#182 · Opened Oct 22, 2023
--apply-offset-seconds not applying set argument of 107 seconds Open

out-of-sync

Difficulty 3/5 1-2 days Newbie friendliness 35/100

smacke/ffsubsync#181 · 1 comment · Opened Aug 28, 2023
Switch to click for argument parsing Open

enhancement

smacke/ffsubsync#179 · 1 assignee · Opened Jun 3, 2023
ffsubsync skips first 5 subtitles lines even though they seem properly formatted Open

out-of-sync

Difficulty 3/5 1-2 days Newbie friendliness 35/100

smacke/ffsubsync#177 · 1 comment · Opened May 7, 2023
stops processing multiple files on pysubs2.exceptions.UnknownFPSError Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 35/100

smacke/ffsubsync#176 · 9 comments · Opened Apr 24, 2023
output subtitles still out of sync Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 25/100

smacke/ffsubsync#174 · 3 comments · Opened Feb 12, 2023
OpenAi Multilanguage speech to text "whisper" Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

smacke/ffsubsync#164 · 1 comment · 2 reactions · Opened Sep 22, 2022
Framerate was not specified and cannot be read from the MicroDVD file error when used on a .sub file Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 35/100

smacke/ffsubsync#162 · Opened Jun 28, 2022
Is ffsubsync support auto adjust subtitle duration Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

smacke/ffsubsync#152 · 1 comment · Opened Feb 5, 2022
output subtitles still out of sync Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 25/100

smacke/ffsubsync#151 · Opened Jan 14, 2022
output subtitles still out of sync Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 25/100

smacke/ffsubsync#150 · Opened Dec 29, 2021
Bazarr Synchronization failed -> consider passing --max-offset-seconds with a number larger than 60 Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 30/100

smacke/ffsubsync#149 · Opened Dec 28, 2021
Run multiple inputs at once Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

smacke/ffsubsync#144 · 6 comments · 1 reaction · Opened Dec 6, 2021
run() requires argparse shim, can't be called directly Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 38/100

smacke/ffsubsync#139 · Opened Sep 29, 2021
Breaks/Splits update Open

Difficulty 5/5 Over a week Newbie friendliness 15/100

smacke/ffsubsync#136 · 1 comment · Opened Sep 24, 2021
Syncing via bazarr failed (exception) Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 25/100

smacke/ffsubsync#134 · 5 comments · Opened Sep 19, 2021
Idea/Question for another usecase Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

smacke/ffsubsync#132 · 1 comment · 4 reactions · Opened Jul 23, 2021
how to prevent skipping Open

out-of-sync

Difficulty 3/5 1-2 days Newbie friendliness 30/100

smacke/ffsubsync#130 · 3 comments · Opened Jun 28, 2021
Output subtitles still out of sync Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 25/100

smacke/ffsubsync#129 · Opened Jun 13, 2021
feat: Allow the use of urls instead of files Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

smacke/ffsubsync#127 · 2 comments · Opened Apr 28, 2021
output subtitles still out of sync Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 15/100

smacke/ffsubsync#121 · Opened Mar 18, 2021
output subtitles still out of sync Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 25/100

smacke/ffsubsync#117 · Opened Feb 23, 2021
output subtitles still out of sync Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 30/100

smacke/ffsubsync#116 · Opened Feb 7, 2021
allow one split to handle cases where intro sequence appears in middle of video Open

enhancement

smacke/ffsubsync#115 · 1 reaction · 1 assignee · Opened Jan 31, 2021
integration tests for all the command line flags Open

enhancement

smacke/ffsubsync#109 · 1 assignee · Opened Nov 28, 2020
allow some kind of "rename pattern" for syncing multiple files instead of overwriting the inputs Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 15/100

smacke/ffsubsync#108 · Opened Nov 28, 2020
ERROR: Unable to read input subtitles unsynchronized.srt (try checking permissions) Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 25/100

smacke/ffsubsync#105 · 13 comments · Opened Oct 11, 2020
increase tolerance of srt parsing Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 18/100

smacke/ffsubsync#101 · 2 comments · Opened Aug 28, 2020
Syncing via bazarr failed for 2 "old" movie Open

out-of-sync

Difficulty 4/5 3-5 days Newbie friendliness 25/100

smacke/ffsubsync#100 · 4 comments · Opened Aug 28, 2020
Use embedded PGS subtitles as a reference Open

enhancement help wanted

Difficulty 5/5 Over a week Newbie friendliness 25/100

smacke/ffsubsync#94 · 5 comments · 2 reactions · Opened Aug 18, 2020
--make-test-case cannot move ffsubsync.log because it's in use Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

smacke/ffsubsync#93 · 7 comments · Opened Aug 18, 2020
return stats like normalized score, shift, detected encoding, etc. from ffsubsync.run Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

smacke/ffsubsync#87 · 1 reaction · Opened Jun 10, 2020
add type hints and incorporate mypy into CI Open

enhancement

smacke/ffsubsync#86 · 1 comment · 1 assignee · Opened Jun 10, 2020
be robust to malformatted MicroDVD files Open

enhancement

Difficulty 3/5 1-2 days Newbie friendliness 35/100

smacke/ffsubsync#84 · Opened Jun 9, 2020
improve handling of conversion between subtitle formats Open

enhancement

smacke/ffsubsync#83 · 1 assignee · Opened Jun 9, 2020

smacke/ffsubsync

Get new issues in your inbox