Metadata-Version: 2.4
Name: zotero-tui
Version: 0.1.0
Summary: A minimal fzf-powered TUI for browsing Zotero collections and opening PDFs
Project-URL: Homepage, https://github.com/vv111y/zot-tui
Project-URL: Repository, https://github.com/vv111y/zot-tui
Author: Will
License: MIT
Keywords: cli,fzf,tui,zotero
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: pyfzf>=0.3.1
Requires-Dist: typer>=0.12.3
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == 'test'
Requires-Dist: ruff>=0.5.0; extra == 'test'
Description-Content-Type: text/markdown

# zotero-tui

fzf-powered TUI for browsing Zotero collections and opening PDFs.

Features (initial):

- Search whole library by title with preview
- Search by collection, then title with preview
- Ctrl-O to open the first attachment; Alt-O to choose among multiple
- Preview shows title, authors, date, item key, citation key, DOI, URL, and abstract
- Press Enter to open a full-page view (paged via bat/less) of the entire entry
- Missing attachments are highlighted as [missing] in bright yellow

Install (local dev):

- pipx install .

Usage:

- zotero-tui
	- Default mode: All items
	- Keys:
		- Enter: full-page view of selected entry (bat/less)
		- Ctrl-C: toggle Collections mode
		- Ctrl-S: toggle Query mode
		- Ctrl-Q: quit
		- Ctrl-H: back to Collections list when inside a collection
		- Ctrl-O: open first attachment; Alt-O: choose attachment

Environment:

- Set `ZOTERO_SQLITE` to the path of your `zotero.sqlite` if auto-detection fails.

License: MIT
