{"id":23302269,"url":"https://github.com/fjebaker/zorro","last_synced_at":"2025-04-06T22:29:19.916Z","repository":{"id":268071562,"uuid":"861313088","full_name":"fjebaker/zorro","owner":"fjebaker","description":"A CLI for interacting with Zotero.","archived":false,"fork":false,"pushed_at":"2024-09-24T23:28:25.000Z","size":873,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T01:06:59.496Z","etag":null,"topics":["cli","search","zig","zotero"],"latest_commit_sha":null,"homepage":"","language":"Zig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fjebaker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-22T15:10:36.000Z","updated_at":"2024-09-24T23:28:00.000Z","dependencies_parsed_at":"2024-12-14T04:43:34.626Z","dependency_job_id":"b96f915f-369d-462e-9688-6bf2b9c3647c","html_url":"https://github.com/fjebaker/zorro","commit_stats":null,"previous_names":["fjebaker/zorro"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjebaker%2Fzorro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjebaker%2Fzorro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjebaker%2Fzorro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjebaker%2Fzorro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fjebaker","download_url":"https://codeload.github.com/fjebaker/zorro/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247563065,"owners_count":20958964,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","search","zig","zotero"],"created_at":"2024-12-20T10:28:33.526Z","updated_at":"2025-04-06T22:29:19.898Z","avatar_url":"https://github.com/fjebaker.png","language":"Zig","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zorro\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"./assets/example.gif\" style=\"max-width: 800px;\"/\u003e\n    \u003cp align=\"center\"\u003e\n    \u003ci\u003eYour clunky CLI for zeroing in on search results in Zotero\u003c/i\u003e\n    \u003c/p\u003e\n\u003c/div\u003e\n\nZorro is a command line tool for more expressively and interactively searching through the Zotero library.\n\n## Installation\n\nGrab a binary from the [releases](https://github.com/fjebaker/zorro/releases/latest) for your OS.\n\n### Building from source\n\nUsing the Zig master version, clone and `cd` and then:\n\n```bash\nzig build --release=safe\n```\n\nThe binary will then be in `./zig-out/bin/zorro`.\n\nTo build statically (for distribution), specify the target with `musl` to avoid linking the system LibC:\n```bash\nzig build --release=safe -Dtarget=x86_64-linux-musl\n```\n\n\n\n## Features and planned features\n\nThe order below is arbitary:\n\n- [x] A small interactive TUI for selecting and viewing the search results\n- [x] Search author, scoring the author position (first author scores higher than second, etc.)\n- [x] Search year including ranges (before, after, inbetween)\n- [ ] Fuzzy searching in titles\n- [ ] Fuzzy searching in abstracts\n- [x] Zotero interaction: open or select items from the CLI directly in Zotero\n- [ ] 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.\n- [ ] Search in and export highlights and notes.\n- [ ] 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.\n\n## Usage\n\n```\n$ zorro help\nCommands:\n\n find\n    [-a/--author name]        Author (last) name.\n    [-y/--year YYYY]          Publication year. Optionally may use `before:YYYY`,\n                                `after:YYYY`, or `YYYY-YYYY` (range) to filter publication years.\n\n help\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffjebaker%2Fzorro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffjebaker%2Fzorro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffjebaker%2Fzorro/lists"}