lyrics-transcriber 0.40.0__py3-none-any.whl → 0.41.0__py3-none-any.whl

lyrics_transcriber/cli/cli_main.py

@@ -68,6 +68,12 @@ def create_arg_parser() -> argparse.ArgumentParser:
         type=Path,
         help="JSON file containing output style configurations for CDG and video generation",
     )
+    output_group.add_argument(
+        "--subtitle_offset",
+        type=int,
+        default=0,
+        help="Offset subtitle timing by N milliseconds (positive or negative). Default: 0",
+    )
 
     # Feature control group
     feature_group = parser.add_argument_group("Feature Control")
@@ -143,6 +149,7 @@ def create_configs(args: argparse.Namespace, env_config: Dict[str, str]) -> tupl
         output_dir=str(args.output_dir) if args.output_dir else os.getcwd(),
         cache_dir=str(args.cache_dir),
         video_resolution=args.video_resolution,
+        subtitle_offset_ms=args.subtitle_offset,
         fetch_lyrics=not args.skip_lyrics_fetch,
         run_transcription=not args.skip_transcription,
         run_correction=not args.skip_correction,

lyrics_transcriber/core/config.py

@@ -43,3 +43,4 @@ class OutputConfig:
     generate_cdg: bool = True
     render_video: bool = True
     video_resolution: str = "360p"
+    subtitle_offset_ms: int = 0

lyrics_transcriber/output/cdg.py

@@ -126,7 +126,7 @@ class CDGGenerator:
         cdg_styles: dict,
     ) -> str:
         """Create TOML configuration file for CDG generation."""
-        safe_filename = self._get_safe_filename(artist, title, "Karaoke CDG", "toml")
+        safe_filename = self._get_safe_filename(artist, title, "Karaoke", "toml")
         toml_file = os.path.join(self.output_dir, safe_filename)
         self.logger.debug(f"Generating TOML file: {toml_file}")
 
@@ -161,7 +161,7 @@ class CDGGenerator:
             title=title,
             artist=artist,
             audio_file=audio_file,
-            output_name=f"{artist} - {title} (Karaoke CDG)",
+            output_name=f"{artist} - {title} (Karaoke)",
             sync_times=sync_times,
             instrumentals=instrumentals,
             formatted_lyrics=formatted_lyrics,
@@ -190,11 +190,11 @@ class CDGGenerator:
         """Compose CDG using KaraokeComposer."""
         kc = KaraokeComposer.from_file(toml_file)
         kc.compose()
-        kc.create_mp4(height=1080, fps=30)
+        # kc.create_mp4(height=1080, fps=30)
 
     def _find_cdg_zip(self, artist: str, title: str) -> str:
         """Find the generated CDG ZIP file."""
-        safe_filename = self._get_safe_filename(artist, title, "Karaoke CDG", "zip")
+        safe_filename = self._get_safe_filename(artist, title, "Karaoke", "zip")
         output_zip = os.path.join(self.output_dir, safe_filename)
 
         self.logger.info(f"Looking for CDG ZIP file in output directory: {output_zip}")
@@ -216,12 +216,12 @@ class CDGGenerator:
 
     def _get_cdg_path(self, artist: str, title: str) -> str:
         """Get the path to the CDG file."""
-        safe_filename = self._get_safe_filename(artist, title, "Karaoke CDG", "cdg")
+        safe_filename = self._get_safe_filename(artist, title, "Karaoke", "cdg")
         return os.path.join(self.output_dir, safe_filename)
 
     def _get_mp3_path(self, artist: str, title: str) -> str:
         """Get the path to the MP3 file."""
-        safe_filename = self._get_safe_filename(artist, title, "Karaoke CDG", "mp3")
+        safe_filename = self._get_safe_filename(artist, title, "Karaoke", "mp3")
         return os.path.join(self.output_dir, safe_filename)
 
     def _verify_output_files(self, cdg_file: str, mp3_file: str) -> None:
@@ -376,7 +376,7 @@ class CDGGenerator:
         cdg_styles: dict,
     ) -> dict:
         """Create TOML data structure."""
-        safe_output_name = self._get_safe_filename(artist, title, "Karaoke CDG")
+        safe_output_name = self._get_safe_filename(artist, title, "Karaoke")
         return {
             "title": title,
             "artist": artist,

lyrics_transcriber/output/generator.py

@@ -78,6 +78,7 @@ class OutputGenerator:
                 font_size=self.font_size,
                 line_height=self.line_height,
                 styles=self.config.styles,
+                subtitle_offset_ms=self.config.subtitle_offset_ms,
                 logger=self.logger,
             )
 
@@ -161,12 +162,12 @@ class OutputGenerator:
             "720p": (1280, 720),
             "360p": (640, 360),
         }
-        
+
         if resolution not in resolution_map:
             raise ValueError("Invalid video_resolution value. Must be one of: 4k, 1080p, 720p, 360p")
-            
+
         resolution_dims = resolution_map[resolution]
-        
+
         # Default font sizes for each resolution
         default_font_sizes = {
             "4k": 250,
@@ -174,13 +175,13 @@ class OutputGenerator:
             "720p": 100,
             "360p": 40,
         }
-        
+
         # Get font size from styles if available, otherwise use default
         font_size = self.config.styles.get("karaoke", {}).get("font_size", default_font_sizes[resolution])
-        
+
         # Line height matches font size for all except 360p
         line_height = 50 if resolution == "360p" else font_size
-        
+
         return resolution_dims, font_size, line_height
 
     def write_corrections_data(self, correction_result: CorrectionResult, output_prefix: str) -> str:

lyrics_transcriber/output/subtitles.py

@@ -5,7 +5,7 @@ import subprocess
 import json
 
 from lyrics_transcriber.output.ass.section_screen import SectionScreen
-from lyrics_transcriber.types import LyricsSegment
+from lyrics_transcriber.types import LyricsSegment, Word
 from lyrics_transcriber.output.ass import LyricsScreen, LyricsLine
 from lyrics_transcriber.output.ass.ass import ASS
 from lyrics_transcriber.output.ass.style import Style
@@ -25,6 +25,7 @@ class SubtitlesGenerator:
         font_size: int,
         line_height: int,
         styles: dict,
+        subtitle_offset_ms: int = 0,
         logger: Optional[logging.Logger] = None,
     ):
         """Initialize SubtitleGenerator.
@@ -34,12 +35,15 @@ class SubtitlesGenerator:
             video_resolution: Tuple of (width, height) for video resolution
             font_size: Font size for subtitles
             line_height: Line height for subtitle positioning
+            styles: Dictionary of style configurations
+            subtitle_offset_ms: Offset for subtitle timing in milliseconds
             logger: Optional logger instance
         """
         self.output_dir = output_dir
         self.video_resolution = video_resolution
         self.font_size = font_size
         self.styles = styles
+        self.subtitle_offset_ms = subtitle_offset_ms
         self.config = ScreenConfig(line_height=line_height, video_width=video_resolution[0], video_height=video_resolution[1])
         self.logger = logger or logging.getLogger(__name__)
 
@@ -91,6 +95,30 @@ class SubtitlesGenerator:
         """Create screens from segments with detailed logging."""
         self.logger.debug("Creating screens from segments")
 
+        # Apply timing offset to segments if needed
+        if self.subtitle_offset_ms != 0:
+            self.logger.info(f"Subtitle offset: {self.subtitle_offset_ms}ms")
+
+            offset_seconds = self.subtitle_offset_ms / 1000.0
+            segments = [
+                LyricsSegment(
+                    text=seg.text,
+                    words=[
+                        Word(
+                            text=word.text,
+                            start_time=max(0, word.start_time + offset_seconds),
+                            end_time=word.end_time + offset_seconds,
+                            confidence=word.confidence,
+                        )
+                        for word in seg.words
+                    ],
+                    start_time=max(0, seg.start_time + offset_seconds),
+                    end_time=seg.end_time + offset_seconds,
+                )
+                for seg in segments
+            ]
+            self.logger.info(f"Applied {self.subtitle_offset_ms}ms offset to segment timings")
+
         # Create section screens and get instrumental boundaries
         section_screens = self._create_section_screens(segments, song_duration)
         instrumental_times = self._get_instrumental_times(section_screens)

{lyrics_transcriber-0.40.0.dist-info → lyrics_transcriber-0.41.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: lyrics-transcriber
-Version: 0.40.0
+Version: 0.41.0
 Summary: Automatically create synchronised lyrics files in ASS and MidiCo LRC formats with word-level timestamps, using Whisper and lyrics from Genius and Spotify
 License: MIT
 Author: Andrew Beveridge

{lyrics_transcriber-0.40.0.dist-info → lyrics_transcriber-0.41.0.dist-info}/RECORD

@@ -1,8 +1,8 @@
 lyrics_transcriber/__init__.py,sha256=JpdjDK1MH_Be2XiSQWnb4i5Bbil1uPMA_KcuDZ3cyUI,240
 lyrics_transcriber/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lyrics_transcriber/cli/cli_main.py,sha256=I4YXULnIA_H9ESmXdEspOcidY2n24KdUkOTDZb7r680,9967
+lyrics_transcriber/cli/cli_main.py,sha256=MDgjIlgmKDfv3z6nK_j7TJKtcijfuLrB06hDMXXaZQY,10211
 lyrics_transcriber/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lyrics_transcriber/core/config.py,sha256=yR0hG4BFEgyzd1hdb27t5B2RI7eYdAvQ9w9RUnoIpuY,1197
+lyrics_transcriber/core/config.py,sha256=euwOOtuNbXy4-a1xs8QKdjcf5jXZQle0zf6X1Wthurw,1229
 lyrics_transcriber/core/controller.py,sha256=YKz-_nV-h2grXfQrNafDiK35uNitiLVA-z9BmMOkq-w,19540
 lyrics_transcriber/correction/anchor_sequence.py,sha256=YpKyY24Va5i4JgzP9ssqlOIkaYu060KaldiehbfgTdk,22200
 lyrics_transcriber/correction/corrector.py,sha256=r6AmdVl_JbOIbNgNk5aDHy-5vdw5-cayspUGht_844A,13494
@@ -81,7 +81,7 @@ lyrics_transcriber/output/ass/lyrics_screen.py,sha256=gRzUsDMLEtZZPuv77xk7M0FzCp
 lyrics_transcriber/output/ass/section_detector.py,sha256=TsSf4E0fleC-Tzd5KK6q4m-wjGiu6TvGDtHdR6sUqvc,3922
 lyrics_transcriber/output/ass/section_screen.py,sha256=QeUaIeDXs_Es33W5aqyVSaZzMwUx-b60vbAww3aQfls,4185
 lyrics_transcriber/output/ass/style.py,sha256=ty3IGorlOZ_Q-TxeA02hNb5Pb0mA755dOb8bqKr1k7U,6880
-lyrics_transcriber/output/cdg.py,sha256=YKGqljyX4L7j3mg2Y3YfATIPSOszErVtdmyp8SjYnQk,24916
+lyrics_transcriber/output/cdg.py,sha256=Kx8_luGUQbrAlbzGKKNQTPTSGkN48oqOBIH6CYzNlMI,24894
 lyrics_transcriber/output/cdgmaker/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lyrics_transcriber/output/cdgmaker/cdg.py,sha256=nBqkw0JOois-NI27CkwHblLuBaoL-sHyJb2SntX7m8s,6733
 lyrics_transcriber/output/cdgmaker/composer.py,sha256=gWziaLnCo8iV7Igp7yFn5oFUVctRDtkLlcfx6O-f98Y,90780
@@ -111,12 +111,12 @@ lyrics_transcriber/output/fonts/Zurich_Cn_BT_Bold.ttf,sha256=WNG5LOQ-uGUF_WWT5aQ
 lyrics_transcriber/output/fonts/arial.ttf,sha256=NcDzVZ2NtWnjbDEJW4pg1EFkPZX1kTneQOI_ragZuDM,275572
 lyrics_transcriber/output/fonts/georgia.ttf,sha256=fQuyDGMrtZ6BoIhfVzvSFz9x9zIE3pBY_raM4DIicHI,142964
 lyrics_transcriber/output/fonts/verdana.ttf,sha256=lu0UlJyktzks_yNbnEHVXBJTgqu-DA08K53WaJfK4Ms,139640
-lyrics_transcriber/output/generator.py,sha256=TzgYjppsGKev5Fg-q7JtjTAiTkuKOBE8Ssaf6ZoAwQA,8294
+lyrics_transcriber/output/generator.py,sha256=FdXoyxp62jmkvOCaS1ixnRI9ek08ts1QeA8qxss_REY,8309
 lyrics_transcriber/output/lrc_to_cdg.py,sha256=2pi5tvreD_ADAR4RF5yVwj7OJ4Pf5Zo_EJ7rt4iH3k0,2063
 lyrics_transcriber/output/lyrics_file.py,sha256=_KQyQjCOMIwQdQ0115uEAUIjQWTRmShkSfQuINPKxaw,3741
 lyrics_transcriber/output/plain_text.py,sha256=3mYKq0BLYz1rGBD6ROjG2dn6BPuzbn5dxIQbWZVi4ao,3689
 lyrics_transcriber/output/segment_resizer.py,sha256=b553FCdcjYAl9T1IA5K6ya0pcn1-irD5spmxSc26wnI,17143
-lyrics_transcriber/output/subtitles.py,sha256=BQy7N_2zdBBWEiHL0NWFz3ZgAerWqQvTLALgxxK3Etk,16920
+lyrics_transcriber/output/subtitles.py,sha256=jrvg0Tn8W-lRmlGNwnrMMzJB6xdEfI0ZoNLer5zWKJk,18170
 lyrics_transcriber/output/video.py,sha256=ghb53OF6BNZy1VudKQvogPBA27eXfN8FHX9C72aGsm0,9095
 lyrics_transcriber/review/__init__.py,sha256=_3Eqw-uXZhOZwo6_sHZLhP9vxAVkLF9EBXduUvPdLjQ,57
 lyrics_transcriber/review/server.py,sha256=5Cfy3aS-h2c6bZU0wkrDZ9ATIkjndNWbxVJjQ89PFJE,5981
@@ -126,8 +126,8 @@ lyrics_transcriber/transcribers/audioshake.py,sha256=QzKGimVa6BovlvYFj35CbGpaGeP
 lyrics_transcriber/transcribers/base_transcriber.py,sha256=yPzUWPTCGmzE97H5Rz6g61e-qEGL77ZzUoiBOmswhts,5973
 lyrics_transcriber/transcribers/whisper.py,sha256=P0kas2_oX16MO1-Qy7U5gl5KQN-RuUIJZz7LsEFLUiE,12906
 lyrics_transcriber/types.py,sha256=xGf3hkTRcGZTTAjMVIev2i2DOU6co0QGpW8NxvaBQAA,16759
-lyrics_transcriber-0.40.0.dist-info/LICENSE,sha256=BiPihPDxhxIPEx6yAxVfAljD5Bhm_XG2teCbPEj_m0Y,1069
-lyrics_transcriber-0.40.0.dist-info/METADATA,sha256=hj-_pxAxvpcNC7XBPLbEvpPQYEDfHazvIOHrlXsWUOk,5891
-lyrics_transcriber-0.40.0.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-lyrics_transcriber-0.40.0.dist-info/entry_points.txt,sha256=kcp-bSFkCACAEA0t166Kek0HpaJUXRo5SlF5tVrqNBU,216
-lyrics_transcriber-0.40.0.dist-info/RECORD,,
+lyrics_transcriber-0.41.0.dist-info/LICENSE,sha256=BiPihPDxhxIPEx6yAxVfAljD5Bhm_XG2teCbPEj_m0Y,1069
+lyrics_transcriber-0.41.0.dist-info/METADATA,sha256=civcml2WAL40CDoeC8zOI76uVoIGkGXe4oyvwWSEZGc,5891
+lyrics_transcriber-0.41.0.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+lyrics_transcriber-0.41.0.dist-info/entry_points.txt,sha256=kcp-bSFkCACAEA0t166Kek0HpaJUXRo5SlF5tVrqNBU,216
+lyrics_transcriber-0.41.0.dist-info/RECORD,,