ZotFile Version History

30 versions

Be careful with old versions!

These versions are displayed for reference and testing purposes. You should always use the latest version of an add-on.

Version 4.2.7 488.1 kB Works with Firefox 31.0 and later

- Disable add-on if Zotero 5.0 is installed.

Version 4.2.6 488.0 kB Works with Firefox 31.0 and later

- fix regression from 4.2.5 (extraction of annotations)

Version 4.2.5 480.9 kB Works with Firefox 31.0 and later

- Compatibility with [Juris-M](https://juris-m.github.io/)

Version 4.2.4 479.7 kB Works with Firefox 31.0 and later

- fix regression with from 4.2.3

Version 4.2.3 479.7 kB Works with Firefox 31.0 and later

- Support for non ascii characters in source, destination and tablet directory
- Fix: regression from 4.2.2
- Fix: Error reporting for better debugging
- Fix: Correct parsing of page number from Zotero item for extracted annotations

Version 4.2.2 478.5 kB Works with Firefox 31.0 and later

- Fix: %c wildcard on Windows
- Fix: Problem with deleting empty folders

Version 4.2.1 478.5 kB Works with Firefox 31.0 and later

- Fix: Renaming attachments without author failed

Version 4.2 478.5 kB Works with Firefox 31.0 and later

- Add wildcard %g for author's full name (thanks to [QingQYang](https://github.com/QingQYang))
- Support for PDF Expert and other PDF readers on mac to open links in Zotero notes (the hidden option `pdfExtraction.openPdfMac_skim` changed to `pdfExtraction.openPdfMac`. `openPdfMac` is a string with the exact name of the application such as "Preview", "Skim" or "PDF Expert").
- Wild-cards for (senior) last author (`q`, `Q`, `u`, and `U`) (thanks to [bwiernik](https://github.com/bwiernik))
- Fix: Small fixes for extraction of annotations
- Fix: Delete folder(s) if last file is moved out (thanks to [Renato Alves](https://github.com/Unode))
- Fix: Renaming same file a second time truncates and indexes filename (thanks to [Renato Alves](https://github.com/Unode))
- Fix: Better handle spacial character in TOC

Version 4.1.6 478.4 kB Works with Firefox 25.0 and later

- Fixed problem with downloading of poppler-based extraction tool

Version 478.5 kB Works with Firefox 26.0 and later

- Fix problem when renaming files in place
- Fix problem with "Restrict saved search"

Version 478.5 kB Works with Firefox 26.0 and later

- Rename file at current location if "Custom Location" is not specified (thanks to [Soham Sinha](https://github.com/sohamm17))
- Fix bug with files that are renamed when sent to the tablet

Version 478.3 kB Works with Firefox 28.0 and later

- fix problem with location of tablet files

Version 478.3 kB Works with Firefox 28.0 and later

- fix problem with poppler-based extraction and annotation color

Version 478.2 kB Works with Firefox 28.0 and later

#### Changes in 4.x (4.0, 4.1 and 4.1.1)

- **Goto annotation in pdf**

This is not really a new feature but with two recent changes in Zotero (see [this](https://github.com/zotero/zotero/pull/450) and [this](https://github.com/zotero/zotero/pull/452) pull request), it became much more useful! Simply click on the link that is part of your extracted annotations, and zotfile will open the pdf on the page with the annotation. The feature now works on Windows as well (thanks to aurimasv) and I have added support for Skim on Mac. Check out the [documentation](http://zotfile.com/index.html#extract-pdf-annotations) for some more details.

- **Improved extraction of annotation**

This version includes four improvements for the extraction of annotations. First, the new version greatly improves the detection of correct spaces between words. Second, the extraction is now based on the most recent pdf.js version ([here](https://github.com/jlegewie/pdf.js/tree/extract-v3) is my fork with the modified version of [pdf.js](https://github.com/mozilla/pdf.js) used in zotfile). With this update, zotfile should work with more pdfs. Second, the extraction is now about 40-60% faster (depending on the pdf) thanks to some improvements in the extraction code. Third, the extraction now runs in the background so that Zotero is not blocked while annotations are extracted.

- **Get Table of Contents from PDF**

Similar to [Mendeley](http://blog.mendeley.com/progress-update/desktop-contents-tables-and-figures/), ZotFile can now get the table of contents from PDF and save it with links to the correct page in attachment notes. Simply click on the the desired section and zotfile opens the pdf on the correct page. Zotfile automatically extracts the table of content for all newly added pdf attachments (disable with `zotfile.pdfOutline.getToc` setting) or you can manually extract the toc using 'Manage Attachments->Get Table of Contents' (remove menu item with `zotfile.pdfOutline.menuItem` setting). This feature only works for pdfs that have an embedded table of content. Unfortunately, many don't.

- **Support for sub-folders based on collection path** (via wildcard %c) (thanks to [simpzan](https://github.com/simpzan))

- **Tablet status is now shown in right-pane with other attachment information**

The right pane now includes a row with the current tablet status such as `No` for files that are not on the tablet or `[Basefolder]` for files that are in the tablet base-folder. Click on this information to change the tablet status and open or reveal the file on the tablet (very convenient because double-clicking on the attachment opens the imported zotero attachment and not the file on the tablet).

- **Extract Annotation Color** (thanks to [RAG2ko](https://github.com/RAG2ko))

Zotfile now extracts the color of annotations. The color can be used in two ways: (a) To format extracted annotations: Just add some css styling to the hidden options for formatting. For example, change `formatAnnotationHighlight` to `<p style="">"%(content)" (%(cite))</p>`. The wildcard `%(color)` is replaced by the annotation color (you can also use %(color_category) for the color category---reddish is red etc). This styling has the same effect but looks a little better: `<p><span style="">"%(content)"</span> (%(cite))</p>` (b) To create separate notes for color categories: The hidden option `pdfExtraction.colorNotes` allows you to create a separate note for each color category (yellow, red, green etc annotations).

- **Improved formatting of extracted annotations with hidden options** (`formatNoteTitle`, `formatAnnotationNote`, `formatAnnotationHighlight`, `formatAnnotationUnderline`)

The available wildcards are `%(content)` for the highlights text, `%(cite)` for the in-text citation of the zotero item, `%(page)` for the page of the annotation, `%(uri)` for the uri that open the pdf on the correct page, `%(label)` for the text label displayed in the title bar of the annotation pop-up commonly used for the user who added the annotation, and `%(color)`/`%(color_category)` for the annotation color as described above. The default for `formatAnnotationHighlight` is `<p>"%(content)" (%(cite))</p>`. WARNING: I removed the old settings. You will have to change the new settings if you want to customize the format of the note with extracted annotations.

- Improved default PDF reader detection on Windows (thanks to aurimasv)
- Hidden option `pdfExtraction.replacements` for custom, regular expression-based replacements in extracted annotations. This can be useful because some pdfs contain 'broken' characters. For example, `[{"regex":" ?\u00f0", "replacement": " ("}]` replaces the unicode character `ð` with `(` to fix a problem in pdfs from a certain publisher. In this case, `ð` is a problem with the pdf and not with zotfile's extraction. The hidden option can be used to fix it.
- Information for attachments on the tablet is now hidden in the attachment note
- Improved information windows
- Improved renaming function (avoids re-indexing of linked attachments)
- New wildcards for editors (`%d`, `%D`, `%L`, `%l`)
- Fix bug with unnecessary suffix after multiple renames of same file
- further improvements for the extraction of annotations in 4.1
- truncate title after '!'
- Add .docx files to the default file types

Version 3.1.1-signed 546.1 kB Works with Firefox 18.0 and later

- New zotfile webpage at www.zotfile.com (please update links)
- User-defined wildcards
- watch folder now adds an attachment and retrieves metadata if no file is selected
(change message, change version)
- fix pdf.js issue with some pdf annotation (see here https://forums.zotero.org/discussion/31903/extract-pdf-annotations-message-hangs-on-linuxubuntu/#Comment_177201)
- New hidden preferences for duration of info windows (`info_window_duration` and `info_window_duration_clickable`)
- The `%w` wildcard now maps to the correct field for most item types
- The `%u` wildcard as redundant (use `%y` instead)
- Choose the number of authors to display when truncating authors during renaming (thanks to bwiernik)
- fix problem that small info window does not disappear

Version 548.4 kB Works with Firefox 16.0 and later

- fix for issue with showing website on every restart
- fix for issue when adding new attachment

Version 548.4 kB Works with Firefox 16.0 and later

Small fixes mainly for Italian translation, restriction of saved searches and renaming based on collections.

Version 438.6 kB Works with Firefox 3.6.13 and later

- fix that problem that only the first annotation on page was extracted

Version 438.7 kB Works with Firefox 3.6 and later

- fix compatibility with FF 20 and Zotero 4

Version 438.6 kB Works with Firefox 3.6.13 and later

- bug fix for subfolders based on wildcards
- adding attachments from watched folder now works when child item is selected
- language improvements for French and German

Version 2.3.1-signed 438.1 kB Works with Firefox 3.6 and later

- enhanced renaming rules (thanks to Midnighter):
1) Optional wild-cards: `{-%y}` only includes `-` if `%y` is defined.
2) Exclusive wild-cards: `%s|%j` journal abbr. or if not defined full journal name.
(for examples see below)
- additional wild-cards for author formating (author initials `%I` and lastnameF `%F`), pages (`%f`) and short title (`%h`)
- watch source folder for new files:
Whenever the focus changes to the item list in Zotero, Zotfile checks for new files in the source folder. If a new file was added to the folder, zotfile uses a clickable, non-disruptive window to ask the user whether s/he wants to attach that file to the currently selected Zotero item.
- revised auto rename with additional options
(four options: Never, Always ask, Only ask if item has other atts, Always rename. The 'asking' uses a clickable, non-disruptive window that appears in the bottom right corner - same as previous info window but clickable)
- revised notifications and error handling
- Zotfile translation to German (thanks to wuffi) and French (thanks to gracile-fr)
- Allow periods as delimiter in filenames (thanks to jjatria)
- new option: "lower case" filenames (thanks to jjatria)
- new option: disable renaming so that attachments are only moved (hidden: `.disable_renaming`)
- new option: set opening and closing quotation mark for extracted annotations (hidden: `.openingQuotationMarks`, `.closingQuotationMarks`)
- new option: remove periods from filenames (hidden: `removePeriods`)
- bug fix: download of poppler tool was broken
- bug fix: preview of renaming rules for Unix and Windows
- bug fix: sending to and getting from tablet deleted note content

Version 406.9 kB Works with Firefox 3.6.13 and later

- fix bug in last update that always showed "web attachment" message

Version 406.8 kB Works with Firefox 3.6.4 and later

- bug fix: check whether selected attachments are valid (no top-level item, no web attachments and attachment exists)
- bug fix: editing custom folder created error if user had maximum number of custom folders

Version 406.4 kB Works with Firefox 3.6 and later

- Add option to change delimiter between multiple authors (thanks to gracile-fr)

Version 406.2 kB Works with Firefox 3.6 and later

- bug fix for moving tablet files to different subfolders

Version 2.2.1-signed 405.5 kB Works with Firefox 3.6 and later

- New feature: automatic renaming of attachment files (thanks to Robin Wilson)
- Bug fix: zotfile produced error when trying to move open files on Windows (thanks to Dominik)

Version 2.1.1-signed 404.5 kB Works with Firefox 3.6 and later

- Important: the tag for tablet files was changed from '_READ' to '_tablet'
- New saved search for modified files on tablet

(updates automatically, replaces 'Scan Tablet Files' function, which has been removed)
- Zotfile menu items only appear for bibliographic items and attachments (not for notes)
- Bug fix: allow the extraction of annotations in group libraries
- Other bug fixes

Version 2.0.1-signed 402.4 kB Works with Firefox 3.6 and later

- Sync Zotero Attachments with your iPad or Android tablet
- Extract Annotations from PDF Files
- redesigned preference pane
- many more features and bug fixes

Version 16.4 kB Works with Firefox 3.0 and later

- Compatible with Zotero Standalone
(for instructions see http://www.columbia.edu/~jpl2136/zotfile.html#install)
- restore selection after renaming of attachments
- cleaned preference window
- %y is now the issue date for patents
- Bug resolved: Rename Existing Attachment created 2 as a suffix if filename did not changed

Version 16.4 kB Works with Firefox 3.0 and later

- Bug: The 'Rename Existing Attachment' function selects the correct zotero item after renaming
- Bug: The 'Rename Existing Attachment' function preserves tags assigned to the attachment item and the attachment note
- Bug: confirmation for attaching new file now contains the correct filename
- Bug: Preview renaming rule in preference dialog corrected