Item Management¶

Add by DOI¶

zot add --doi "10.1038/s41586-023-06139-9"

Add by URL¶

zot add --url "https://arxiv.org/abs/2301.00001"

Add from Local PDF¶

zot add --pdf paper.pdf

Extracts DOI from the PDF, creates the item, and attaches the file.

Batch Import¶

zot add --from-file dois.txt

The file should contain one DOI or URL per line.

Update Metadata¶

zot update ABC123 --title "Corrected Title"
zot update ABC123 --date "2024-01-15"
zot update ABC123 --field publicationTitle="Nature"

Delete Items¶

zot delete ABC123                 # Confirmation prompt
zot delete ABC123 --yes           # Skip confirmation
zot --no-interaction delete ABC123  # Script mode

Items are moved to Zotero's trash, not permanently deleted.

Trash Management¶

zot trash list                    # View trashed items
zot trash restore ABC123          # Restore from trash

Upload Attachments¶

zot attach ABC123 --file supplementary.pdf

Find Duplicates¶

zot duplicates                         # Both DOI and title matching
zot duplicates --by doi                # DOI only
zot duplicates --by title              # Fuzzy title only
zot duplicates --threshold 0.9         # Stricter matching