2 | 
3 |
6 | 
7 | 
8 |
9 |
10 |
11 |
12 |
7 |
8 | 13 | A unofficial plugin to keep your watched movie history from Jellyfin automatically updated to your Letterboxd diary. 14 |
15 | 16 | ## About 17 | 18 | This plugin sends daily updates to the Letterboxd diary informing the films watched on Jellyfin. Since the Letterboxd API is not publicly available, this project uses the HtmlAgilityPack package to interact directly with the website's interface. 19 | 20 | ## Installation 21 | 22 | 1. Open the dashboard in Jellyfin, then select `Catalog` and open `Settings` at the top with the `⚙️` button. 23 | 24 | 2. Click the `+` button and add the repository URL below, naming it whatever you like and save. 25 | 26 | ``` 27 | https://raw.githubusercontent.com/danielveigasilva/jellyfin-plugin-letterboxd-sync/master/manifest.json 28 | ``` 29 | 30 | 3. Go back to `Catalog`, click on 'LetterboxdSync' at 'General' group and install the most recent version. 31 | 32 | 4. Restart Jellyfin and go back to the plugin settings. Go to `My Plugins` and click on 'LetterboxdSync' to configure. 33 | 34 | ## Configure 35 | 36 | - You can associate one Letterboxd account for each Jellyfin user. You need click `Save` for each one. 37 | 38 | - The synchronization task runs every 24 hours and only for uses accounts marked as `Enable`. 39 | 40 | - Check `Send Favorite` if you want films marked as favorites on Jellyfin to be marked as favorites on Letterboxd. 41 | 42 |
43 | 
44 |
2 |
49 |
--------------------------------------------------------------------------------
/manifest.json:
--------------------------------------------------------------------------------
1 | [
2 | {
3 | "guid": "b1fb3d98-3336-4b87-a5c9-8a948bd87233",
4 | "name": "LetterboxdSync",
5 | "overview": "Syncs watched movies with Letterboxd diary",
6 | "description": "A third party plugin to keep your watched movie history automatically updated to a Letterboxd account",
7 | "owner": "danielveigasilva",
8 | "category": "General",
9 | "imageUrl": "https://raw.githubusercontent.com/danielveigasilva/jellyfin-plugin-letterboxd-sync/master/images/letterboxd-sync.png",
10 | "versions": [
11 | {
12 | "version": "1.1.2.0",
13 | "changelog": "- fix: check date last review correct (f9f499e)",
14 | "targetAbi": "10.9.0.0",
15 | "sourceUrl": "https://github.com/danielveigasilva/jellyfin-plugin-letterboxd-sync/releases/download/v1.1.2/jellyfin-plugin-letterboxd-sync-v1.1.2.zip",
16 | "checksum": "ca795994cd1c9ac01a586e28ba9b2a8b",
17 | "timestamp": "2025-06-15T00:45:35Z"
18 | },
19 | {
20 | "version": "1.1.1.0",
21 | "changelog": "- fix: log movies watched just one day before (b817d28)\n- fix: ignore readme in publish (c2d97b0)\n- fix: update release names (8ac3ba7)\n- docs: update README with count downloads (357a8cd)",
22 | "targetAbi": "10.9.0.0",
23 | "sourceUrl": "https://github.com/danielveigasilva/jellyfin-plugin-letterboxd-sync/releases/download/v1.1.1/jellyfin-plugin-letterboxd-sync-v1.1.1.zip",
24 | "checksum": "fdfbf9b188fecd6cde3116a8773a729b",
25 | "timestamp": "2025-06-11T17:38:14Z"
26 | },
27 | {
28 | "version": "1.1.0.0",
29 | "changelog": "- feat(publish): automate publish release (ca44bc3)\n- feat(search): find movie only by tmdbid (7cc9d9d)",
30 | "targetAbi": "10.9.0.0",
31 | "sourceUrl": "https://github.com/danielveigasilva/jellyfin-plugin-letterboxd-sync/releases/download/v1.1.0/jellyfin-plugin-letterboxd-sync-v1.1.0.zip",
32 | "checksum": "d5514462054943fc4ef88e1ca7d7a206",
33 | "timestamp": "2025-03-20T22:26:45Z"
34 | },
35 | {
36 | "version": "1.0.2.0",
37 | "changelog": "- Fix: prevent failure when review id is blank (#1)\n- Refactor: clearer logs",
38 | "targetAbi": "10.9.0.0",
39 | "sourceUrl": "https://github.com/danielveigasilva/jellyfin-plugin-letterboxd-sync/releases/download/v1.0.2/jellyfin-plugin-letterboxd-sync-v1.0.2.0.zip",
40 | "checksum": "a42d4734f41a1f45131abf142ba62fe6",
41 | "timestamp": "2025-03-07T00:00:00Z"
42 | },
43 | {
44 | "version": "1.0.1.0",
45 | "changelog": "- Fix #2: All research with a TMDB id return no results",
46 | "targetAbi": "10.9.0.0",
47 | "sourceUrl": "https://github.com/danielveigasilva/jellyfin-plugin-letterboxd-sync/releases/download/v1.0.1/jellyfin-plugin-letterboxd-sync-v1.0.1.0.zip",
48 | "checksum": "c998b14487096209b505a02513a05026",
49 | "timestamp": "2025-03-05T00:00:00Z"
50 | },
51 | {
52 | "version": "1.0.0.0",
53 | "changelog": "- Initial version",
54 | "targetAbi": "10.9.0.0",
55 | "sourceUrl": "https://github.com/danielveigasilva/jellyfin-plugin-letterboxd-sync/releases/download/v1.0.0/jellyfin-plugin-letterboxd-sync-v1.0.0.0.zip",
56 | "checksum": "89f9d6e5b02c6907c6952703f30a8c9e",
57 | "timestamp": "2025-01-18T00:00:00Z"
58 | }
59 | ]
60 | }
61 | ]
62 |
--------------------------------------------------------------------------------
/LetterboxdSync/Web/configLetterboxd.js:
--------------------------------------------------------------------------------
1 |
2 | export const pluginId = 'b1fb3d98-3336-4b87-a5c9-8a948bd87233';
3 |
4 | export default function (view, params) {
5 |
6 | view.addEventListener('viewshow', function (e) {
7 |
8 | const selectUsers = view.querySelector('#usersJellyfin');
9 | selectUsers.innerHTML = '';
10 |
11 | ApiClient.getUsers().then(users => {
12 | for (let user of users){
13 | const option = document.createElement('option');
14 | option.value = user.Id;
15 | option.textContent = user.Name;
16 | selectUsers.appendChild(option);
17 | }
18 |
19 | const userSelectedId = document.getElementById('usersJellyfin').value;
20 | ApiClient.getPluginConfiguration(pluginId).then(config => {
21 | let configUserFilter = config.Accounts.filter(function (item) {
22 | return item.UserJellyfin == userSelectedId;
23 | });
24 | view.querySelector('#username').value = configUserFilter[0].UserLetterboxd;
25 | view.querySelector('#password').value = configUserFilter[0].PasswordLetterboxd;
26 | view.querySelector('#enable').checked = configUserFilter[0].Enable;
27 | view.querySelector('#sendfavorite').checked = configUserFilter[0].SendFavorite;
28 | });
29 | });
30 | });
31 |
32 |
33 | view.querySelector('#usersJellyfin').addEventListener('change', function(e) {
34 |
35 | e.preventDefault();
36 | const userSelectedId = e.target.value;
37 |
38 | ApiClient.getPluginConfiguration(pluginId).then(config => {
39 |
40 | let configUserFilter = config.Accounts.filter(function (item) {
41 | return item.UserJellyfin == userSelectedId;
42 | });
43 |
44 | if (configUserFilter.length > 0) {
45 | view.querySelector('#username').value = configUserFilter[0].UserLetterboxd;
46 | view.querySelector('#password').value = configUserFilter[0].PasswordLetterboxd;
47 | view.querySelector('#enable').checked = configUserFilter[0].Enable;
48 | view.querySelector('#sendfavorite').checked = configUserFilter[0].SendFavorite;
49 | }
50 | else {
51 | view.querySelector('#username').value = '';
52 | view.querySelector('#password').value = '';
53 | view.querySelector('#enable').checked = false;
54 | view.querySelector('#sendfavorite').checked = false;
55 | }
56 |
57 | });
58 | });
59 |
60 | view.querySelector('#LetterboxdSyncConfigForm').addEventListener('submit', function (e) {
61 |
62 | e.preventDefault();
63 |
64 | Dashboard.showLoadingMsg();
65 |
66 | const userSelectedId = document.getElementById('usersJellyfin').value;
67 |
68 | ApiClient.getPluginConfiguration(pluginId).then(config => {
69 |
70 | let AccountsUpdate = [];
71 |
72 | for (let account of config.Accounts)
73 | if (account.UserJellyfin != userSelectedId)
74 | AccountsUpdate.push(account);
75 |
76 | let configUser = {};
77 | configUser.UserJellyfin = userSelectedId;
78 | configUser.UserLetterboxd = view.querySelector('#username').value;
79 | configUser.PasswordLetterboxd = view.querySelector('#password').value;
80 | configUser.Enable = view.querySelector('#enable').checked;
81 | configUser.SendFavorite = view.querySelector('#sendfavorite').checked;
82 |
83 | const data = JSON.stringify(configUser);
84 | const url = ApiClient.getUrl('Jellyfin.Plugin.LetterboxdSync/Authenticate');
85 |
86 | console.log(configUser);
87 | if (!configUser.Enable){
88 | Dashboard.hideLoadingMsg();
89 |
90 | AccountsUpdate.push(configUser);
91 | config.Accounts = AccountsUpdate;
92 |
93 | ApiClient.updatePluginConfiguration(pluginId, config).then(function (result) {
94 | Dashboard.processPluginConfigurationUpdateResult(result);
95 | });
96 | }
97 | else {
98 | ApiClient.ajax({ type: 'POST', url, data, contentType: 'application/json'}).then(function (response) {
99 |
100 | Dashboard.hideLoadingMsg();
101 |
102 | AccountsUpdate.push(configUser);
103 | config.Accounts = AccountsUpdate;
104 |
105 | ApiClient.updatePluginConfiguration(pluginId, config).then(function (result) {
106 | Dashboard.processPluginConfigurationUpdateResult(result);
107 | });
108 |
109 | }).catch(function (response) {
110 | response.json().then(res => {
111 | console.log(res);
112 | Dashboard.hideLoadingMsg();
113 | Dashboard.processErrorResponse({statusText: `${response.statusText} - ${res.Message}`});
114 | });
115 | });
116 | }
117 | })
118 | })
119 | }
120 |
--------------------------------------------------------------------------------
/jellyfin.ruleset:
--------------------------------------------------------------------------------
1 |
2 |
3 |
48 |
4 |
46 |
47 |