Zotfile Attachment GuideSAFE

🔬 A curated collection of 23,000+ agent skills for empirical research across 8 social science disciplines. | 精选 23,000+ AI Agent 技能库,覆盖8大社会科学学科的实证研究。CoPaper.AI 20分钟完成一篇可复现的规范实证论文,并支持用户上传 Skills。-- Maintained by CoPaper.AI from Stanford REAP.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: zotfile-attachment-guide
description: "Guide to ZotFile for Zotero attachment management, renaming, and syncing"
metadata:
  openclaw:
    emoji: "📂"
    category: "writing"
    subcategory: "citation"
    keywords: ["zotero", "zotfile", "attachment", "pdf-management", "file-organization", "sync"]
    source: "https://github.com/jlegewie/zotfile"
---

# ZotFile Attachment Management Guide

**WARNING: ZotFile is NOT compatible with Zotero 7.** For Zotero 7, use the built-in attachment management or the [Attanger](https://github.com/MuiseDestiny/zotero-attanger) plugin as a replacement.

## Overview

ZotFile is one of the most established Zotero plugins with over 4,000 GitHub stars, providing advanced file management capabilities for PDF attachments and other documents linked to your Zotero library. It handles the critical but often neglected task of organizing, renaming, and synchronizing the actual files that make up a research library.

Without ZotFile, researchers often end up with a chaotic collection of PDFs named with meaningless publisher-generated identifiers, scattered across different directories, and difficult to manage outside of Zotero itself. ZotFile brings order to this chaos by automatically renaming files according to customizable patterns based on bibliographic metadata, moving them to organized directory structures, and managing tablet-based reading workflows.

The plugin is especially valuable for researchers with large libraries who need their PDFs accessible outside Zotero, whether for backup, sharing, or use with other tools. By maintaining a predictable, human-readable file naming and directory structure, ZotFile ensures that your research documents remain organized and accessible regardless of how you access them.

## Installation and Setup

Install ZotFile through the Zotero add-on mechanism:

1. Download the latest `.xpi` file from https://github.com/jlegewie/zotfile/releases
2. In Zotero, navigate to Tools > Add-ons > gear icon > Install Add-on From File
3. Select the `.xpi` file and restart Zotero

Configure ZotFile after installation:

- Open Tools > ZotFile Preferences
- **General Settings**:
  - Set the source folder for new files (where your browser downloads PDFs)
  - Set the custom location for linked attachments (e.g., `~/Documents/Research/Papers`)
  - Choose between "Attach stored copy" (files in Zotero data directory) or "Linked file" (files in custom location)

- **Renaming Rules**:
  - Configure the filename pattern using wildcards:
    - `{%a}` - Author last name
    - `{%y}` - Year
    - `{%t}` - Title
    - `{%j}` - Journal abbreviation
  - Example pattern: `{%a}_{%y}_{%t}` produces `Smith_2024_Deep_Learning_for_Protein.pdf`
  - Set maximum title length to prevent overly long filenames
  - Configure treatment of special characters and spaces

- **Tablet Settings** (if using a tablet for reading):
  - Set the tablet files directory (e.g., a cloud-synced folder)
  - Configure background file handling
  - Enable automatic extraction of annotations from returned tablet PDFs

## Core Features

**Automatic File Renaming**: When you add a new item with an attachment to Zotero, ZotFile can automatically rename the PDF based on the item's metadata. This transforms `10.1038_s41586-024-07487-w.pdf` into `Smith_2024_Title_of_Paper.pdf` without any manual intervention.

Renaming patterns support rich formatting:

| Pattern | Output Example | Description |
|---------|---------------|-------------|
| `{%a}_{%y}_{%t}` | `Smith_2024_Deep_Learning` | Author, year, title |
| `{%a}_{%y}_{%j}` | `Smith_2024_Nature` | Author, year, journal |
| `{%y}/{%a}_{%t}` | `2024/Smith_Deep_Learning` | Year subfolder, author, title |
| `{%a_zotero}_{%y}` | `SmithAndJones_2024` | Multiple authors |

**Custom File Location**: Move attachments from Zotero's internal storage to a custom directory structure. This is essential for researchers who:
- Want PDFs accessible from file managers and other applications
- Need to store files on specific drives with more storage capacity
- Want a predictable directory structure for scripting and automation
- Prefer linked files over Zotero-managed storage for portability

**Subfolder Organization**: Create automatic subfolder structures based on metadata:
- Organize by year: `{%y}/` creates `2024/`, `2023/`, etc.
- Organize by author: `{%a}/` creates `Smith/`, `Jones/`, etc.
- Organize by collection: mirror your Zotero collection hierarchy
- Combine patterns: `{%y}/{%j}/` creates `2024/Nature/`, `2024/Science/`

**Tablet Reading Workflow**: ZotFile manages a bidirectional sync between your Zotero library and a tablet reading folder:

1. Select papers you want to read on your tablet
2. Right-click > Manage Attachments > Send to Tablet
3. ZotFile copies PDFs to your configured tablet directory (typically a cloud-synced folder)
4. Read and annotate on your tablet using your preferred PDF reader
5. When finished, right-click > Manage Attachments > Get from Tablet
6. ZotFile retrieves the annotated PDFs and extracts new annotations into Zotero notes

**PDF Annotation Extraction**: ZotFile can extract highlights and text annotations from PDFs and convert them into Zotero notes. This works with annotations made in any PDF reader, not just Zotero's built-in reader. Each annotation includes:
- The highlighted or annotated text
- The page number for reference
- Color coding information
- Any comments you added

**Batch Operations**: Process your entire library or selected collections at once:
- Rename all attachments according to current rules
- Move all files to the custom location
- Extract annotations from all PDFs
- Update file links after moving directories

## Research Workflow Best Practices

**Setting Up a New Library**:
1. Configure ZotFile with your preferred naming pattern and directory
2. Import your existing PDFs into Zotero with metadata
3. Select all items and run "Rename and Move Attachments" to normalize everything
4. Verify th

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.