From aa83de49a3a6153636c3237536fcbaf1bc48316e Mon Sep 17 00:00:00 2001 From: ajmandourah Date: Tue, 28 May 2024 12:06:55 +0300 Subject: [PATCH] Create README.md --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..daf3797 --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +![bazarr-sync](https://github.com/ajmandourah/bazarr-sync/assets/27051374/6c4acde4-bb9b-4172-8c67-c985c7994b28) +### Bulk sync your subtitles to your media. + +Bazarr let you download subs for your titles automatically. +But if for some reason you needed to sync old subtitles, wither you need to do it because you have not synced them before or you have edited them elsewhere, you will be forced to do it one by one as there is no option to bulk sync them. +This cli tool help you achieve that by utilizing bazarr's api. + +## Configuration +use the provided config.yaml file as a template. fill in the required fields. +either direct the flag --config to your config file or place it in the working directiory where you bazarr-sync is located. +```yaml +#config file example, please don't use quotes +########################### +# +#Address: the address of your bazarr instance. this can be either an ip address or a url (if you reverse proxy bazarr), +#this can also be bazarr's container name if you use docker, make sure bazarr-sync instance is in the same network as bazarr and the network not the default +#docker network as name resolution won't happen there. +Address: +# +#Port: bazarrs port. by default bazarr uses 6767. in case of reverse proxy, you can use 443 or 80 as per your configuration +Port: +# +#protocol: this can be http or https +Protocol: https +# +#ApiToken: you can get this from bazarr setting>general . no quotes needed. +ApiToken: +``` +## Usage: + +``` +Make sure to create a config.yaml file including your configuration in it. +Use the provided config file as a template. + +Usage: + bazarr-sync [command] + +Examples: +bazarr-sync --config config.yaml sync movies --no-framerate-fix + +Available Commands: + completion Generate the autocompletion script for the specified shell + help Help about any command + sync Sync subtitles to the audio track of the media + +Flags: + --config string config file (default is ./config.yaml) + --golden-section Use Golden-Section Search + -h, --help help for bazarr-sync + --no-framerate-fix Don't try to fix framerate +``` +Sync all movies subtitles +``` +bazarr-sync --config config.yaml sync movies +``` +Sync all tv shows subtitles +``` +bazarr-sync --config config.yaml sync shows +```