From 478537bf0a45a738079599137072b3d23ef4ac37 Mon Sep 17 00:00:00 2001 From: DarkFighterLuke <31162436+DarkFighterLuke@users.noreply.github.com> Date: Wed, 22 Oct 2025 17:13:02 +0200 Subject: [PATCH 1/2] Revise synchronization and add playlists features Updated synchronization sections and added playlists synchronization details. --- README.md | 41 ++++++++++++++++++++++++++++++----------- 1 file changed, 30 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 30c844c..837086b 100644 --- a/README.md +++ b/README.md @@ -77,23 +77,42 @@ _NOTE: If you are using Docker containers, it is important to mount the TubeArch 5. Save and come back to Home, you will see the newly added library. Jellyfin will have executed the metadata fetching for you after the collection creation and then you will see the metadata and the images of channels and videos -## Playback synchronization -

Starting from v1.3.1 this plugin offers playback progress and watched status bidirectional synchronization, but you can choose to enable only a one way synchronization (Jellyfin->TubeArchivist or TubeArchivist->Jellyfin) too.

+## Synchronization +This plugin has different bidirectional sycnhronization features, that can be configured in the specific section in the plugin configuration page: +![Synchronization settings](https://github.com/user-attachments/assets/b0bb556b-fce3-4a3e-bc6c-b0a2b482cedc) -### Jellyfin->TubeArchivist synchronization +### Playback synchronization +

Starting from v1.3.1 this plugin offers playback progress and watched status bidirectional synchronization, but you can choose to enable only a one way synchronization (Jellyfin -> TubeArchivist or TubeArchivist -> Jellyfin) too.

+ +#### Jellyfin -> TubeArchivist playback synchronization

This kind of synchronization is done listening for progress and watched status changes while playing the videos for the specified users.
Furthermore, there is a task that runs at Jellyfin startup to synchronize the whole library.

-

In the plugin configuration you will find these settings:

- -![JF->TA playback synchronization settings](https://github.com/user-attachments/assets/dc6be82f-e685-4896-a502-317681c47fc7)

In the text field you can specify one Jellyfin username to synchronize data of to TubeArchivist.

-### TubeArchivist->Jellyfin synchronization +#### TubeArchivist -> Jellyfin playback synchronization

This kind of synchronization is done using a Jellyfin scheduled task that regularly synchronizes data from TubeArchivist API to Jellyfin.

-

In the plugin configuration you will find these settings:

+

In the text field you can specify one or more Jellyfin usernames to update data for.

-![TA->JF playback synchronization settings](https://github.com/user-attachments/assets/1b4c33af-834f-45b3-9057-71830e7c8b4f) -

In the first text field you can specify one or more Jellyfin usernames to update data for.
-In the second field you can specify the interval in seconds the task should run at, so that you can choose according to your system requirements. The lower is the interval the higher will be the resources consuption on your system.

+### Playlists synchronization +

Starting from v.1.4.1 this plugin offers playlists bidirectional synchronization, but you can choose to enable only a one way synchronization (Jellyfin -> TubeArchivist or TubeArchivist -> Jellyfin) too.

+ +#### Jellyfin -> TubeArchivist playlists synchronization +

There is a task that retrieves playlists and recreates them on TubeArchivist with the videos in the same order. Please note that playlists can also have videos not beloging from TubeArchivist, they will be simply ignored, so you won't find them on TubeArchivist playlist.

+

It is present also a setting to automatically delete playlists from TubeArchivist when they are no more available on Jellyfin.

+ +#### TubeArchivist -> Jellyfin playlists synchronization +

There is a task that retrieves playlists from TubeArchivist and recreates them on Jellyfin with videos in the same order.

+

It is present, also in this case, a setting to automatically delete playlists from Jellyfin when they are no more present on TubeArchivist, but beware that the will be deleted also if they contain videos not beloning to TubeArchivist.

+ +> [!CAUTION] +> Pay attention when you enable the automatic deletion options, be sure that is your wanted behavior, especially when playlists contain also other videos not belonging from TubeArchivist, playlists removed won't be available again, there's no undo! + + +## Tasks intervals +

Since many of the feature are implemented as background tasks periodically executing, in the `Tasks intervals` section you will find the settings to adjust this period in seconds.
+Keep in mind that Jellyfin lowest accepted period is of 1 minute (60 seconds).

+

Here are the configurable intervals:

+ +![Tasks intervals settings](https://github.com/user-attachments/assets/19db6b83-6715-477d-8ce7-b78526e87ba9) ## Build From 5dc99e2fcf50b0478375f5c50098e9c6fb940210 Mon Sep 17 00:00:00 2001 From: DarkFighterLuke <31162436+DarkFighterLuke@users.noreply.github.com> Date: Wed, 22 Oct 2025 17:28:39 +0200 Subject: [PATCH 2/2] Update tasks intervals section in README Added note about resource consumption with lower intervals. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 837086b..7d90674 100644 --- a/README.md +++ b/README.md @@ -109,7 +109,7 @@ This plugin has different bidirectional sycnhronization features, that can be co ## Tasks intervals

Since many of the feature are implemented as background tasks periodically executing, in the `Tasks intervals` section you will find the settings to adjust this period in seconds.
-Keep in mind that Jellyfin lowest accepted period is of 1 minute (60 seconds).

+Keep in mind that Jellyfin lowest accepted period is of 1 minute (60 seconds) and the lower is the interval the higher will be the resources consuption on your system.

Here are the configurable intervals:

![Tasks intervals settings](https://github.com/user-attachments/assets/19db6b83-6715-477d-8ce7-b78526e87ba9)