Upgrade Storage[SOLVED] Auto-Rename HTML Snapshots and Fix Sync Issues (Mac-Win iCloud) using ZotMoov in Zotero 8
Title: [SOLVED] Auto-Rename HTML Snapshots and Fix Sync Issues (Mac-Win iCloud) using ZotMoov in Zotero 8
Hi everyone,
I previously shared a solution for iCloud sync issues between Mac and Windows caused by filename length and NFD/NFC encoding conflicts ([Link to your previous post: https://forums.zotero.org/discussion/129877/solved-edited-icloud-sync-issues-file-not-found-on-windows-the-nfd-icloud-filename-conflict#latest]).
Today, I want to share a follow-up tip for HTML Snapshots.
Many users find that snapshots remain as link.html or fail to sync properly across devices. In Zotero 8, you can solve this by combining a hidden preference with the ZotMoov add-on.
The Problem:
By default, Zotero doesn't auto-rename HTML files, and snapshots stored in the local data directory often lead to "File Not Found" errors when synced via iCloud between Mac and Windows.
The Solution:
1. Enable HTML Renaming (Advanced Settings)
- Zotero 8 needs to be told to treat HTML files as renamable objects.
- Go to Settings -> Advanced -> Config Editor.
- Search for extensions.zotero.autoRenameFiles.fileTypes.
- Append ,text/html to the value (Final: application/pdf,application/epub+zip,text/html).
Restart Zotero.
2. Move and Auto-Rename with ZotMoov
- In ZotMoov Preferences, set your Destination Folder to your iCloud directory.
- Right-click any item with a snapshot -> ZotMoov -> Move attachment.
- Result: The link.html is automatically renamed to the item's title (respecting your naming rules) and moved to iCloud as a Linked File. This ensures the path is consistent across both Mac and Windows.
Bonus: Fully Automated Workflow for New Items
Once you've configured the settings above, you don't even need to move files manually for new captures:
- Zotero Connector: When you save a paper via the browser connector, Zotero 8 will now recognize the snapshot's MIME type (text/html).
- Auto-Rename: It immediately applies your advanced regex naming rule to the snapshot.
- Auto-Move (ZotMoov): In ZotMoov settings, if you enable "Move files automatically when adding new items", the renamed snapshot will be sent straight to your custom iCloud path.
- Sync-Ready: The file is instantly ready for cross-platform (Mac-Win) access without any "File Not Found" errors.
### Important Note on Filename Length:
As discussed in my previous post ([https://forums.zotero.org/discussion/129877/solved-edited-icloud-sync-issues-file-not-found-on-windows-the-nfd-icloud-filename-conflict#latest]), long filenames can still cause iCloud sync errors on Windows.
I highly recommend setting a character limit for filenames in Zotero settings to prevent "Path too long" or "File not found" issues after renaming.
Hi everyone,
I previously shared a solution for iCloud sync issues between Mac and Windows caused by filename length and NFD/NFC encoding conflicts ([Link to your previous post: https://forums.zotero.org/discussion/129877/solved-edited-icloud-sync-issues-file-not-found-on-windows-the-nfd-icloud-filename-conflict#latest]).
Today, I want to share a follow-up tip for HTML Snapshots.
Many users find that snapshots remain as link.html or fail to sync properly across devices. In Zotero 8, you can solve this by combining a hidden preference with the ZotMoov add-on.
The Problem:
By default, Zotero doesn't auto-rename HTML files, and snapshots stored in the local data directory often lead to "File Not Found" errors when synced via iCloud between Mac and Windows.
The Solution:
1. Enable HTML Renaming (Advanced Settings)
- Zotero 8 needs to be told to treat HTML files as renamable objects.
- Go to Settings -> Advanced -> Config Editor.
- Search for extensions.zotero.autoRenameFiles.fileTypes.
- Append ,text/html to the value (Final: application/pdf,application/epub+zip,text/html).
Restart Zotero.
2. Move and Auto-Rename with ZotMoov
- In ZotMoov Preferences, set your Destination Folder to your iCloud directory.
- Right-click any item with a snapshot -> ZotMoov -> Move attachment.
- Result: The link.html is automatically renamed to the item's title (respecting your naming rules) and moved to iCloud as a Linked File. This ensures the path is consistent across both Mac and Windows.
Bonus: Fully Automated Workflow for New Items
Once you've configured the settings above, you don't even need to move files manually for new captures:
- Zotero Connector: When you save a paper via the browser connector, Zotero 8 will now recognize the snapshot's MIME type (text/html).
- Auto-Rename: It immediately applies your advanced regex naming rule to the snapshot.
- Auto-Move (ZotMoov): In ZotMoov settings, if you enable "Move files automatically when adding new items", the renamed snapshot will be sent straight to your custom iCloud path.
- Sync-Ready: The file is instantly ready for cross-platform (Mac-Win) access without any "File Not Found" errors.
### Important Note on Filename Length:
As discussed in my previous post ([https://forums.zotero.org/discussion/129877/solved-edited-icloud-sync-issues-file-not-found-on-windows-the-nfd-icloud-filename-conflict#latest]), long filenames can still cause iCloud sync errors on Windows.
I highly recommend setting a character limit for filenames in Zotero settings to prevent "Path too long" or "File not found" issues after renaming.