bazarrbulksync 0.0.0__py3-none-any.whl

bazarrbulksync-0.0.0.dist-info/METADATA

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: bazarrbulksync
+Version: 0.0.0
+Summary: An optimized command-line tool for bulk syncing media subtitles in Bazarr
+Home-page: https://github.com/BrianWeiHaoMa/bazarrbulksync
+Author: Brian Wei Hao Ma
+Author-email: brianmaytc@gmail.com
+License: MIT
+Keywords: bazarr,subtitles,subtitle-sync,subtitle-synchronization,media,video,movies,tv,cli,command-line,automation,bulk,sync,media-server,plex,emby,jellyfin,sonarr,radarr,streaming
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Classifier: Topic :: Multimedia :: Video
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML<7.0.0,>=6.0.0
+Requires-Dist: requests<3.0.0,>=2.32.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# BazarrBulkSync
+An optimized command-line tool for bulk syncing media subtitles in Bazarr.
+
+## Use Cases
+- You want to sync all of your Bazarr media subtitles in one go. BazarrBulkSync allows you to do this with a single command.
+- Your Bazarr collection is MASSIVE and you want to save RAM while syncing. BazarrBulkSync supports chunking to limit the amount of resources used during the sync.
+- You want to bulk sync more than once. BazarrBulkSync supports ignoring recently synced subtitles to avoid redundant syncing, saving a significant amount of time and computational resources.
+- You want to record the syncing process and know which subtitles were synced at what time. BazarrBulkSync supports logging to a file and/or outputting to the screen.
+
+## Installation and Usage
+### Local Python
+Make sure you have Python installed on your machine. You can install Python from [python.org](https://www.python.org/downloads/).
+BazarrBulkSync has been tested for Python versions 3.10, 3.11, 3.12, and 3.13.
+
+In the working directory of your choice, do
+```
+python -m venv .venv
+source .venv/bin/activate # This is for Linux. On Windows use .venv\Scripts\activate instead
+pip install bazarrbulksync
+```
+
+Each time you run the command-line tool, make sure that the virtual environment is activated (by using `source .venv/bin/activate` or `.venv\Scripts\activate` in the same working directory).
+
+You can now run BazarrBulkSync:
+```
+bazarrbulksync --help
+```
+You should create a [config file](#config-file-template) in the same working directory as the one where you want to run BazarrBulkSync.
+
+### Docker
+Make sure you have Docker installed on your machine. You can install Docker from [docker.com](https://www.docker.com/). 
+
+Pull the official BazarrBulkSync image from DockerHub:
+```
+docker pull wayhowma/bazarrbulksync:latest
+```
+
+After replacing `/my_absolute_path` below with the directory path that you want to mount (this is the place you would like to store BazarrBulkSync's config file and log file), you can run BazarrBulkSync:
+```
+docker run --rm -v /my_absolute_path:/app wayhowma/bazarrbulksync --help
+```
+You should create a [config file](#config-file-template) in the mounted directory `/my_absolute_path`.
+
+### Config File Template
+It is recommended to create the config file `bazarrbulksync_cli.yaml` in the same working directory as the one where you want to run BazarrBulkSync. This allows you to easily run BazarrBulkSync each time without need to respecify the parameters. The content of `bazarrbulksync_cli.yaml` should follow the template below. 
+```yaml
+# bazarrbulksync_cli.yaml
+
+bazarr:
+  base_url: http://192.168.1.251:6767/ # replace this with your bazarr service url
+  api_key: asdai21g3isufykasgfs7iodftas9d8f # replace this with your bazarr API key
+
+output_messages_to_screen: true # false if you don't want to see messages on the screen
+log_messages_to_file: true # false if you don't want to log messages to a file
+log_messages_file_path: ./bazarrbulksync.log # the file path to store the log messages
+
+# These are values for controlling maximum API request payload sizes.
+# If you are running out of ram, reducing these values may help
+# especially if the number of movies/series in your bazarr is large.
+max_movies_per_request: 25 
+max_series_per_request: 25
+
+# The maximum number of retries for a failed API request.
+max_request_retries: 3
+
+# The maximum amount of time to wait (in seconds) for the bazarr server 
+# to respond before automatically failing a request.
+request_timeout: 1600
+
+# A request failure is when the same request fails max_request_retries times.
+stop_on_request_failure: false # true if you want the program to stop on the first request failure
+
+# These are additional optional parameters for the API when syncing subtitles.
+original_format: null # Use original subtitles format from ["True", "False"]
+max_offset_seconds: null # Maximum offset seconds to allow as a string ex. "300"
+no_fix_framerate: null # Don't try to fix framerate from ["True", "False"]
+gss: null # Use Golden-Section Search from ["True", "False"]
+```
+
+## Examples
+### Local Python
+Assuming we use [this](#config-file-template) config file, we can run the below command to sync all movies. Note: you need to activate the virtual environment that you set up [earlier](#local-python) before running this command.
+```
+bazarrbulksync --sync movies
+```
+
+```
+2025-09-28 00:15:24,289 | Bazarr Bulk Sync CLI Tool Arguments: Namespace(sync='movies', bazarr_base_url='http://192.168.1.251:6767/', bazarr_api_key='asdai21g3isufykasgfs7iodftas9d8f', output_messages_to_screen=True, log_messages_to_file=True, log_messages_file_path='./bazarrbulksync.log', max_movies_per_request=25, max_series_per_request=25, max_request_retries=1, request_timeout=1600, latest_to_sync='9999-12-31', original_format=None, max_offset_seconds=None, no_fix_framerate=None, gss=None, stop_on_request_failure=False)
+2025-09-28 00:15:24,291 | Syncing movies...
+2025-09-28 00:15:24,364 | Syncing /data/media/media/movies/5 Centimeters per Second (2007)/[Arid] 5 Centimeters per Second (BDRip 1920x1080 Hi10 FLAC) [FD8B6FF2].ja.srt (previous sync 2025-09-28 00:08:13)
+2025-09-28 00:15:28,332 | Finished syncing /data/media/media/movies/5 Centimeters per Second (2007)/[Arid] 5 Centimeters per Second (BDRip 1920x1080 Hi10 FLAC) [FD8B6FF2].ja.srt (newest sync 2025-09-28 00:15:28)
+2025-09-28 00:15:28,332 | Movies synced so far: 1
+2025-09-28 00:15:28,354 | Syncing /data/media/media/movies/Django Unchained (2012)/Django.Unchained.2012.1080p.BluRay.x264.YIFY.en.srt (previous sync 2025-09-28 00:08:32)
+2025-09-28 00:15:47,170 | Finished syncing /data/media/media/movies/Django Unchained (2012)/Django.Unchained.2012.1080p.BluRay.x264.YIFY.en.srt (newest sync 2025-09-28 00:15:47)
+2025-09-28 00:15:47,171 | Movies synced so far: 2
+2025-09-28 00:15:47,213 | Syncing /data/media/media/movies/KPop Demon Hunters (2025)/KPop.Demon.Hunters.2025.1080p.WEBRip.x264.AAC5.1-[YTS.MX].en.srt (previous sync 2025-09-28 00:01:43)
+2025-09-28 00:16:04,363 | Finished syncing /data/media/media/movies/KPop Demon Hunters (2025)/KPop.Demon.Hunters.2025.1080p.WEBRip.x264.AAC5.1-[YTS.MX].en.srt (newest sync 2025-09-28 00:16:04)
+2025-09-28 00:16:04,364 | Movies synced so far: 3
+2025-09-28 00:16:04,394 | Syncing /data/media/media/movies/Kung Fu Panda 3 (2016)/Kung.Fu.Panda.3.2016.1080p.BluRay.x264-[YTS.AG].en.srt (previous sync 2025-09-28 00:01:55)
+2025-09-28 00:16:15,712 | Finished syncing /data/media/media/movies/Kung Fu Panda 3 (2016)/Kung.Fu.Panda.3.2016.1080p.BluRay.x264-[YTS.AG].en.srt (newest sync 2025-09-28 00:16:15)
+2025-09-28 00:16:15,712 | Movies synced so far: 4
+2025-09-28 00:16:15,764 | Syncing /data/media/media/movies/Penguins of Madagascar (2014)/Penguins.of.Madagascar.2014.1080p.BluRay.x264.YIFY.en.srt (previous sync 2025-09-28 00:02:06)
+2025-09-28 00:16:26,659 | Finished syncing /data/media/media/movies/Penguins of Madagascar (2014)/Penguins.of.Madagascar.2014.1080p.BluRay.x264.YIFY.en.srt (newest sync 2025-09-28 00:16:26)
+2025-09-28 00:16:26,659 | Movies synced so far: 5
+2025-09-28 00:16:26,688 | Finished syncing movies. Total movies synced: 5
+```
+
+### Docker
+Assuming we use [this](#config-file-template) config file, we can run the following command to sync all movies:
+```
+docker run --rm -v /bazarrbulksync:/app wayhowma/bazarrbulksync:latest --sync movies
+```
+
+```
+2025-09-28 04:01:04,012 | Bazarr Bulk Sync CLI Tool Arguments: Namespace(sync='movies', bazarr_base_url='http://192.168.1.251:6767/', bazarr_api_key='asdai21g3isufykasgfs7iodftas9d8f', output_messages_to_screen=True, log_messages_to_file=True, log_messages_file_path='./bazarrbulksync.log', max_movies_per_request=25, max_series_per_request=25, max_request_retries=1, request_timeout=1600, latest_to_sync='9999-12-31', original_format=None, max_offset_seconds=None, no_fix_framerate=None, gss=None, stop_on_request_failure=False)
+2025-09-28 04:01:04,018 | Syncing movies...
+2025-09-28 04:01:04,060 | Syncing /data/media/media/movies/5 Centimeters per Second (2007)/[Arid] 5 Centimeters per Second (BDRip 1920x1080 Hi10 FLAC) [FD8B6FF2].ja.srt (previous sync 2025-09-27 23:57:21)
+2025-09-28 04:01:08,200 | Finished syncing /data/media/media/movies/5 Centimeters per Second (2007)/[Arid] 5 Centimeters per Second (BDRip 1920x1080 Hi10 FLAC) [FD8B6FF2].ja.srt (newest sync 2025-09-28 00:01:08)
+2025-09-28 04:01:08,201 | Movies synced so far: 1
+2025-09-28 04:01:08,212 | Syncing /data/media/media/movies/Django Unchained (2012)/Django.Unchained.2012.1080p.BluRay.x264.YIFY.en.srt (previous sync 2025-09-27 23:57:39)
+2025-09-28 04:01:27,074 | Finished syncing /data/media/media/movies/Django Unchained (2012)/Django.Unchained.2012.1080p.BluRay.x264.YIFY.en.srt (newest sync 2025-09-28 00:01:27)
+2025-09-28 04:01:27,075 | Movies synced so far: 2
+2025-09-28 04:01:27,105 | Syncing /data/media/media/movies/KPop Demon Hunters (2025)/KPop.Demon.Hunters.2025.1080p.WEBRip.x264.AAC5.1-[YTS.MX].en.srt (previous sync 2025-09-27 21:11:54)
+2025-09-28 04:01:43,846 | Finished syncing /data/media/media/movies/KPop Demon Hunters (2025)/KPop.Demon.Hunters.2025.1080p.WEBRip.x264.AAC5.1-[YTS.MX].en.srt (newest sync 2025-09-28 00:01:43)
+2025-09-28 04:01:43,847 | Movies synced so far: 3
+2025-09-28 04:01:43,858 | Syncing /data/media/media/movies/Kung Fu Panda 3 (2016)/Kung.Fu.Panda.3.2016.1080p.BluRay.x264-[YTS.AG].en.srt (previous sync 2025-09-27 21:12:06)
+2025-09-28 04:01:55,179 | Finished syncing /data/media/media/movies/Kung Fu Panda 3 (2016)/Kung.Fu.Panda.3.2016.1080p.BluRay.x264-[YTS.AG].en.srt (newest sync 2025-09-28 00:01:55)
+2025-09-28 04:01:55,180 | Movies synced so far: 4
+2025-09-28 04:01:55,209 | Syncing /data/media/media/movies/Penguins of Madagascar (2014)/Penguins.of.Madagascar.2014.1080p.BluRay.x264.YIFY.en.srt (previous sync 2025-09-27 21:12:16)
+2025-09-28 04:02:06,189 | Finished syncing /data/media/media/movies/Penguins of Madagascar (2014)/Penguins.of.Madagascar.2014.1080p.BluRay.x264.YIFY.en.srt (newest sync 2025-09-28 00:02:06)
+2025-09-28 04:02:06,189 | Movies synced so far: 5
+2025-09-28 04:02:06,205 | Finished syncing movies. Total movies synced: 5
+```
+
+Using the same config file as above, we run the sync again but only for movies that were never synced after 2025-09-28 00:01:30 using
+```
+docker run --rm -v /bazarrbulksync:/app wayhowma/bazarrbulksync:latest --sync movies --latest-to-sync "2025-09-28 00:01:30"
+```
+
+```
+2025-09-28 04:08:08,920 | Bazarr Bulk Sync CLI Tool Arguments: Namespace(sync='movies', bazarr_base_url='http://192.168.1.251:6767/', bazarr_api_key='asdai21g3isufykasgfs7iodftas9d8f', output_messages_to_screen=True, log_messages_to_file=True, log_messages_file_path='./bazarrbulksync.log', max_movies_per_request=25, max_series_per_request=25, max_request_retries=1, request_timeout=1600, latest_to_sync='2025-09-28 00:01:30', original_format=None, max_offset_seconds=None, no_fix_framerate=None, gss=None, stop_on_request_failure=False)
+2025-09-28 04:08:08,928 | Syncing movies...
+2025-09-28 04:08:08,971 | Syncing /data/media/media/movies/5 Centimeters per Second (2007)/[Arid] 5 Centimeters per Second (BDRip 1920x1080 Hi10 FLAC) [FD8B6FF2].ja.srt (previous sync 2025-09-28 00:01:08)
+2025-09-28 04:08:13,115 | Finished syncing /data/media/media/movies/5 Centimeters per Second (2007)/[Arid] 5 Centimeters per Second (BDRip 1920x1080 Hi10 FLAC) [FD8B6FF2].ja.srt (newest sync 2025-09-28 00:08:13)
+2025-09-28 04:08:13,115 | Movies synced so far: 1
+2025-09-28 04:08:13,125 | Syncing /data/media/media/movies/Django Unchained (2012)/Django.Unchained.2012.1080p.BluRay.x264.YIFY.en.srt (previous sync 2025-09-28 00:01:27)
+2025-09-28 04:08:32,166 | Finished syncing /data/media/media/movies/Django Unchained (2012)/Django.Unchained.2012.1080p.BluRay.x264.YIFY.en.srt (newest sync 2025-09-28 00:08:32)
+2025-09-28 04:08:32,167 | Movies synced so far: 2
+2025-09-28 04:08:32,197 | Skipping /data/media/media/movies/KPop Demon Hunters (2025)/KPop.Demon.Hunters.2025.1080p.WEBRip.x264.AAC5.1-[YTS.MX].en.srt (last synced at 2025-09-28 00:01:43)
+2025-09-28 04:08:32,206 | Skipping /data/media/media/movies/Kung Fu Panda 3 (2016)/Kung.Fu.Panda.3.2016.1080p.BluRay.x264-[YTS.AG].en.srt (last synced at 2025-09-28 00:01:55)
+2025-09-28 04:08:32,234 | Skipping /data/media/media/movies/Penguins of Madagascar (2014)/Penguins.of.Madagascar.2014.1080p.BluRay.x264.YIFY.en.srt (last synced at 2025-09-28 00:02:06)
+2025-09-28 04:08:32,250 | Finished syncing movies. Total movies synced: 2
+```
+
+## Contributing
+Contributions are welcome. Please open up an issue if you have ideas for improvements or submit a pull request on GitHub.
+
+## Licensing
+BazarrBulkSync is distributed under the MIT License.

bazarrbulksync-0.0.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+bazarrbulksync-0.0.0.dist-info/licenses/LICENSE,sha256=xS6JKiweSchBZBoSfD1D0tKPupwYH26T7dkq0Vk2t9k,1092
+cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli/cli.py,sha256=MyyZwwsiBokaXCUOgDoaRvYz8846MXRTJG2MxvKDy8Y,9063
+cli/config.py,sha256=eIGy3RwNg5YG-aiyKLXUHI-OXPnhoQbzanL55kuEUL4,1964
+sync/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sync/bazarr.py,sha256=-cd1R8JY1On9gaqgA-luinp3RRhn_SnGKLrGhr_ttZ0,10549
+sync/sync.py,sha256=UQbp7RhPF0kLXt-1blIsy9mZZOSUktsDA1e0wfAwteA,12198
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/config.py,sha256=DgPHNFLqEEs_MiQ9RwiXn9LyEKW36jRix-kvzxxsWm8,385
+tests/test_bazarr.py,sha256=o3AeFYOYR_840ntK9dYVfcj3Mhrm1GwMOXRAbLL9GpE,2906
+tests/test_bazarr_api.py,sha256=9NYDpxys4hHQmOa4fkhrILNCYWeH53hvHJScrA3ZOVw,2654
+bazarrbulksync-0.0.0.dist-info/METADATA,sha256=TdgzFfoWKl0oMQirFgAMElkvEMD3YXe7i9ZY6Vm-01Q,14407
+bazarrbulksync-0.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+bazarrbulksync-0.0.0.dist-info/entry_points.txt,sha256=lsopl1HKYcVuE4V5gCSFsTeBc8XL7ZQenurREm_AKls,48
+bazarrbulksync-0.0.0.dist-info/top_level.txt,sha256=rJ5KyWeMLnYTSORFkVL8DDjPL_OpwkGvluPWgqZq360,15
+bazarrbulksync-0.0.0.dist-info/RECORD,,

bazarrbulksync-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bazarrbulksync-0.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bazarrbulksync = cli.cli:main

bazarrbulksync-0.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Brian Wei Hao Ma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bazarrbulksync-0.0.0.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+cli
+sync
+tests

cli/cli.py

@@ -0,0 +1,268 @@
+import logging
+from datetime import datetime
+from argparse import ArgumentParser
+import traceback
+
+import requests
+
+from sync.sync import (
+    Syncer,
+)
+from sync.bazarr import (
+    BazarrAPI,
+)
+from .config import (
+    BAZARR_BASE_URL,
+    BAZARR_API_KEY,
+    OUTPUT_MESSAGES_TO_SCREEN,
+    LOG_MESSAGES_TO_FILE,
+    LOG_MESSAGES_FILE_PATH,
+    MAX_MOVIES_PER_REQUEST,
+    MAX_SERIES_PER_REQUEST,
+    REQUEST_TIMEOUT,
+    STOP_ON_REQUEST_FAILURE,
+    MAX_REQUEST_RETRIES,
+    ORIGINAL_FORMAT,
+    MAX_OFFSET_SECONDS,
+    NO_FIX_FRAMERATE,
+    GSS,
+)
+
+
+def main():
+    parser = ArgumentParser(
+        prog="bazarrbulksync",
+        description="A CLI tool to bulk sync subtitles in Bazarr. "
+        "You can find out more about the project at: https://github.com/BrianWeiHaoMa/bazarrbulksync",
+    )
+
+    parser.add_argument(
+        "--sync",
+        type=str,
+        choices=["movies", "episodes", "both"],
+        required=True,
+        help="What to run the sync for",
+    )
+    parser.add_argument(
+        "--bazarr-base-url",
+        type=str,
+        default=BAZARR_BASE_URL,
+        help="The bazarr base url (ex: http://192.168.1.251:6767/)",
+    )
+    parser.add_argument(
+        "--bazarr-api-key",
+        type=str,
+        default=BAZARR_API_KEY,
+        help="The bazarr API key (ex: asdai21g3isufykasgfs7iodftas9d8f)",
+    )
+    parser.add_argument(
+        "--output-messages-to-screen",
+        type=lambda x: (str(x).lower() == "true"),
+        default=OUTPUT_MESSAGES_TO_SCREEN,
+        help="True if you want to enable outputting log messages to screen",
+    )
+    parser.add_argument(
+        "--log-messages-to-file",
+        type=lambda x: (str(x).lower() == "true"),
+        default=LOG_MESSAGES_TO_FILE,
+        help="True if you want to save log messages to a file",
+    )
+    parser.add_argument(
+        "--log-messages-file-path",
+        type=str,
+        default=LOG_MESSAGES_FILE_PATH,
+        help="The file path to save the log messages to (ex: ./bazarr_bulk_sync.log)",
+    )
+    parser.add_argument(
+        "--max-movies-per-request",
+        type=int,
+        default=MAX_MOVIES_PER_REQUEST,
+        help="The maximum number of movies to query per request",
+    )
+    parser.add_argument(
+        "--max-series-per-request",
+        type=int,
+        default=MAX_SERIES_PER_REQUEST,
+        help="The maximum number of series to query per request",
+    )
+    parser.add_argument(
+        "--max-request-retries",
+        type=int,
+        default=MAX_REQUEST_RETRIES,
+        help="The maximum number of retries for a failed API request",
+    )
+    parser.add_argument(
+        "--request-timeout",
+        type=int,
+        default=REQUEST_TIMEOUT,
+        help="The request timeout in seconds for each API request",
+    )
+    parser.add_argument(
+        "--latest-to-sync",
+        type=str,
+        default=datetime.max.strftime("%Y-%m-%d"),
+        help="The most latest sync time to sync from (up until the present time) \
+                '%%Y-%%m-%%d %%H:%%M:%%S' or '%%Y-%%m-%%d' format. Items previously already \
+                    synced more recently than this time will be skipped.",
+    )
+    parser.add_argument(
+        "--original-format",
+        type=str,
+        choices=["True", "False"],
+        default=ORIGINAL_FORMAT,
+        help="Use original subtitles format when syncing subtitles",
+    )
+    parser.add_argument(
+        "--max-offset-seconds",
+        type=str,
+        default=MAX_OFFSET_SECONDS,
+        help="Maximum offset seconds to allow when syncing subtitles",
+    )
+    parser.add_argument(
+        "--no-fix-framerate",
+        type=str,
+        choices=["True", "False"],
+        default=NO_FIX_FRAMERATE,
+        help="Don't try to fix framerate when syncing subtitles",
+    )
+    parser.add_argument(
+        "--gss",
+        type=str,
+        choices=["True", "False"],
+        default=GSS,
+        help="Use Golden-Section Search when syncing subtitles",
+    )
+    parser.add_argument(
+        "--stop-on-request-failure",
+        type=lambda x: (str(x).lower() == "true"),
+        choices=["True", "False"],
+        default=STOP_ON_REQUEST_FAILURE,
+        help="True if you want to stop the sync when a request fails",
+    )
+
+    parsed_args = parser.parse_args()
+
+    if parsed_args.bazarr_base_url is None:
+        raise ValueError("Bazarr URL must be set via config file or CLI argument")
+
+    if parsed_args.bazarr_api_key is None:
+        raise ValueError("Bazarr API key must be set via config file or CLI argument")
+
+    sync = parsed_args.sync
+
+    LOGGER_NAME = "Bazarr Bulk Sync CLI Tool"
+    logging_fmt = "%(asctime)s | %(message)s"
+    if parsed_args.output_messages_to_screen:
+        logging.basicConfig(
+            level=logging.INFO,
+            format=logging_fmt,
+        )
+        logger = logging.getLogger(LOGGER_NAME)
+
+        if parsed_args.log_messages_to_file:
+            file_handler = logging.FileHandler(
+                parsed_args.log_messages_file_path, mode="a"
+            )
+            file_handler.setLevel(logging.INFO)
+            file_formatter = logging.Formatter(logging_fmt)
+            file_handler.setFormatter(file_formatter)
+            logger.addHandler(file_handler)
+    else:
+        disable_logging = False
+        if parsed_args.log_messages_to_file:
+            logging.basicConfig(
+                level=logging.INFO,
+                format=logging_fmt,
+                filename=parsed_args.log_messages_file_path,
+                filemode="a",
+            )
+        else:
+            disable_logging = True
+
+        logger = logging.getLogger(LOGGER_NAME)
+        if disable_logging:
+            logger.disabled = True
+
+    logger.info(f"Bazarr Bulk Sync CLI Tool Arguments: {parsed_args}")
+
+    try:
+        latest_to_sync = datetime.strptime(
+            parsed_args.latest_to_sync,
+            "%Y-%m-%d",
+        )
+    except Exception:
+        try:
+            latest_to_sync = datetime.strptime(
+                parsed_args.latest_to_sync,
+                "%Y-%m-%d %H:%M:%S",
+            )
+        except Exception:
+            raise ValueError(
+                f"latest_to_sync ({parsed_args.latest_to_sync}) must be in"
+                "'%%Y-%%m-%%d %%H:%%M:%%S' or '%%Y-%%m-%%d' format"
+            )
+
+    bazarr_api = BazarrAPI(
+        base_url=parsed_args.bazarr_base_url,
+        api_key=parsed_args.bazarr_api_key,
+        request_timeout=parsed_args.request_timeout,
+        max_request_retries=parsed_args.max_request_retries,
+    )
+
+    syncer = Syncer(
+        bazarr_api=bazarr_api,
+        latest_to_sync=latest_to_sync,
+        logger=logger,
+        stop_on_request_failure=parsed_args.stop_on_request_failure,
+    )
+
+    try:
+        if sync == "movies":
+            syncer.sync_movies(
+                lastest_to_sync=latest_to_sync,
+                original_format=parsed_args.original_format,
+                max_offset_seconds=parsed_args.max_offset_seconds,
+                no_fix_framerate=parsed_args.no_fix_framerate,
+                gss=parsed_args.gss,
+                max_payload_size=parsed_args.max_movies_per_request,
+            )
+        elif sync == "episodes":
+            syncer.sync_episodes(
+                lastest_to_sync=latest_to_sync,
+                original_format=parsed_args.original_format,
+                max_offset_seconds=parsed_args.max_offset_seconds,
+                no_fix_framerate=parsed_args.no_fix_framerate,
+                gss=parsed_args.gss,
+                max_payload_size=parsed_args.max_movies_per_request,
+            )
+        elif sync == "both":
+            syncer.sync_movies(
+                lastest_to_sync=latest_to_sync,
+                original_format=parsed_args.original_format,
+                max_offset_seconds=parsed_args.max_offset_seconds,
+                no_fix_framerate=parsed_args.no_fix_framerate,
+                gss=parsed_args.gss,
+                max_payload_size=parsed_args.max_movies_per_request,
+            )
+            syncer.sync_episodes(
+                lastest_to_sync=latest_to_sync,
+                original_format=parsed_args.original_format,
+                max_offset_seconds=parsed_args.max_offset_seconds,
+                no_fix_framerate=parsed_args.no_fix_framerate,
+                gss=parsed_args.gss,
+                max_payload_size=parsed_args.max_series_per_request,
+            )
+        else:
+            assert False, "this should never be reached"
+    except Exception as e:
+        if isinstance(e, requests.RequestException):
+            logger.warning(f"A request failure occurred during the sync: {e}")
+        else:
+            logger.critical(
+                f"A critical error occurred during the sync:\n{traceback.format_exc()}"
+            )
+            raise e
+
+
+if __name__ == "__main__":
+    main()

cli/config.py

@@ -0,0 +1,64 @@
+import os
+
+import yaml
+
+CONFIG_PATH = "./bazarrbulksync_cli.yaml"
+
+config = {}
+if os.path.exists(CONFIG_PATH):
+    with open(CONFIG_PATH, "r") as f:
+        config = yaml.safe_load(f)
+
+
+def _get_nested_value(
+    *args,
+    default=None,
+    data: dict,
+):
+    try:
+        if len(args) == 1:
+            return data.get(args[0], default)
+
+        idx = 1
+        holder = data[args[0]]
+        while idx < len(args) - 1:
+            holder = holder[args[idx]]
+
+        return holder.get(args[-1], default)
+    except:
+        return default
+
+
+BAZARR_BASE_URL = _get_nested_value("bazarr", "base_url", default=None, data=config)
+BAZARR_API_KEY = _get_nested_value("bazarr", "api_key", default=None, data=config)
+
+OUTPUT_MESSAGES_TO_SCREEN = _get_nested_value(
+    "output_messages_to_screen", default=True, data=config
+)
+LOG_MESSAGES_TO_FILE = _get_nested_value(
+    "log_messages_to_file", default=True, data=config
+)
+LOG_MESSAGES_FILE_PATH = _get_nested_value(
+    "log_messages_file_path", default="./bazarr_bulk_sync.log", data=config
+)
+
+MAX_MOVIES_PER_REQUEST = _get_nested_value(
+    "max_movies_per_request", default=25, data=config
+)
+MAX_SERIES_PER_REQUEST = _get_nested_value(
+    "max_series_per_request", default=25, data=config
+)
+
+MAX_REQUEST_RETRIES = _get_nested_value("max_request_retries", default=3, data=config)
+
+REQUEST_TIMEOUT = _get_nested_value("request_timeout", default=30, data=config)
+
+STOP_ON_REQUEST_FAILURE = _get_nested_value(
+    "stop_on_request_failure", default=False, data=config
+)
+
+ORIGINAL_FORMAT = _get_nested_value("original_format", default=None, data=config)
+REFERENCE = _get_nested_value("reference", default=None, data=config)
+MAX_OFFSET_SECONDS = _get_nested_value("max_offset_seconds", default=None, data=config)
+NO_FIX_FRAMERATE = _get_nested_value("no_fix_framerate", default=None, data=config)
+GSS = _get_nested_value("gss", default=None, data=config)