{"id":24994191,"url":"https://github.com/trikko/trovatore","last_synced_at":"2026-02-09T10:31:32.141Z","repository":{"id":275111355,"uuid":"924895369","full_name":"trikko/trovatore","owner":"trikko","description":"A fast command-line tool for searching files by name","archived":false,"fork":false,"pushed_at":"2025-04-17T06:08:42.000Z","size":2087,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-30T21:21:46.471Z","etag":null,"topics":["cli","command-line","command-line-tool","d","dlang","file","file-search","files"],"latest_commit_sha":null,"homepage":"","language":"D","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trikko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":"trikko","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2025-01-30T20:46:50.000Z","updated_at":"2025-07-15T01:47:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"da62e484-4564-4785-a6f4-f4bb9ac8454b","html_url":"https://github.com/trikko/trovatore","commit_stats":null,"previous_names":["trikko/trovatore"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/trikko/trovatore","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trikko%2Ftrovatore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trikko%2Ftrovatore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trikko%2Ftrovatore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trikko%2Ftrovatore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trikko","download_url":"https://codeload.github.com/trikko/trovatore/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trikko%2Ftrovatore/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29261913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T04:11:57.159Z","status":"ssl_error","status_checked_at":"2026-02-09T04:11:56.117Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","command-line","command-line-tool","d","dlang","file","file-search","files"],"created_at":"2025-02-04T14:40:01.304Z","updated_at":"2026-02-09T10:31:32.120Z","avatar_url":"https://github.com/trikko.png","language":"D","funding_links":["https://github.com/sponsors/trikko"],"categories":["\u003ca name=\"find\"\u003e\u003c/a\u003eFile finding (alternatives to find)"],"sub_categories":[],"readme":"# Trovatore\n\nA fast tool for searching files by name.\n\nWhen using `find` or similar tools, searches often dive into useless directories full of temporary files and subfolders (cache, build, node_modules, etc.). When looking for *that file* you saved somewhere, it's definitely not in one of those. In fact, it's probably in one of the most obvious places (Desktop, Documents, etc.).\n\nTrovatore combines these two insights: it ignores \"blackhole\" folders and prioritizes searching in directories where your file is most likely to be found.\n\nUnlike other solutions, it doesn't rely on an indexed database, performing real-time searches directly on the filesystem.\n\n## Quick install\n\nSimply run the following command in your terminal:\n\n```bash\ncurl https://trikko.github.io/trovatore/install.sh | bash\n```\n\n## Usage\n\nBasic usage:\n```bash\ntrovatore report.pdf\n```\n\n### Search Patterns\n\n```bash\n# Wildcards\n# it matches report.pdf, report-blah.pdf, report-blah.pdf.2, ...\ntrovatore re?or*f\n\n# Search modes (-m option):\n# exact   - exact match\n# ends    - matches if filename ends with pattern\n# starts  - matches if filename starts with pattern\n# contains - matches if filename contains pattern (default)\ntrovatore -m ends report.pdf\n```\n\n\u003e [!WARNING]\n\u003e When using shells like zsh (default on macOS), wildcards need to be quoted to prevent shell expansion. For example:\n\u003e ```bash\n\u003e # This won't work in zsh\n\u003e trovatore re?or*f\n\u003e\n\u003e # Use this instead\n\u003e trovatore \"re?or*f\"\n\u003e ```\n\n\n## Download\n\nAutomatically compiled binaries are available [here](https://trikko.github.io/trovatore/)\n\n## Building from source\n\n### Prerequisites\n- D compiler [dlang.org](https://dlang.org)\n\n### Build\n\nClone the repository and build with DUB:\n\n```bash\ngit clone https://github.com/trikko/trovatore\ncd trovatore\ndub build --build=release\n```\n## Configuration\n\nTrovatore allows you to customize the directories it searches and excludes by modifying configuration files.\n\n### Sources and Blacklist\n\nThe directories to be searched are specified in the `sources.d` directory. Each file in this directory can list one or more directories to include in the search. By default, if no sources are found, Trovatore will create default sources including user directories, the home directory, and some system directories.\n\nDirectories to be excluded from the search are specified in the `blacklist` file. This file contains a list of directories that Trovatore will ignore during the search. If the `blacklist` file does not exist, a default blacklist is created, which includes common temporary and system directories.\n\nTo customize these settings, edit the files in the `sources.d` directory and the `blacklist` file located in the configuration directory. The configuration directory path varies by operating system:\n- On Linux: `~/.config/trovatore/`\n- On macOS: `~/Library/Application Support/trovatore/`\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrikko%2Ftrovatore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrikko%2Ftrovatore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrikko%2Ftrovatore/lists"}