https://github.com/fjebaker/zorro
A CLI for interacting with Zotero.
https://github.com/fjebaker/zorro
cli search zig zotero
Last synced: about 1 year ago
JSON representation
A CLI for interacting with Zotero.
- Host: GitHub
- URL: https://github.com/fjebaker/zorro
- Owner: fjebaker
- License: gpl-3.0
- Created: 2024-09-22T15:10:36.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-24T23:28:25.000Z (over 1 year ago)
- Last Synced: 2025-04-05T01:06:59.496Z (about 1 year ago)
- Topics: cli, search, zig, zotero
- Language: Zig
- Homepage:
- Size: 853 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zorro
Your clunky CLI for zeroing in on search results in Zotero
Zorro is a command line tool for more expressively and interactively searching through the Zotero library.
## Installation
Grab a binary from the [releases](https://github.com/fjebaker/zorro/releases/latest) for your OS.
### Building from source
Using the Zig master version, clone and `cd` and then:
```bash
zig build --release=safe
```
The binary will then be in `./zig-out/bin/zorro`.
To build statically (for distribution), specify the target with `musl` to avoid linking the system LibC:
```bash
zig build --release=safe -Dtarget=x86_64-linux-musl
```
## Features and planned features
The order below is arbitary:
- [x] A small interactive TUI for selecting and viewing the search results
- [x] Search author, scoring the author position (first author scores higher than second, etc.)
- [x] Search year including ranges (before, after, inbetween)
- [ ] Fuzzy searching in titles
- [ ] Fuzzy searching in abstracts
- [x] Zotero interaction: open or select items from the CLI directly in Zotero
- [ ] Sort based on tags / visualise tags. I use a `read` and `todo` tag to track what I've read and what I need to look at, and I want visual feedback for those.
- [ ] Search in and export highlights and notes.
- [ ] Open current browser with search engine of choice. My plan here to to take advantage of the search features that e.g. NASA's ADS library have, so that if I don't have something in Zotero, I can easily go find it using the same search query.
## Usage
```
$ zorro help
Commands:
find
[-a/--author name] Author (last) name.
[-y/--year YYYY] Publication year. Optionally may use `before:YYYY`,
`after:YYYY`, or `YYYY-YYYY` (range) to filter publication years.
help
```