{"id":32544435,"url":"https://github.com/cdzombak/lychee-meta-tool","last_synced_at":"2025-10-28T17:59:26.175Z","repository":{"id":308171115,"uuid":"1031881330","full_name":"cdzombak/lychee-meta-tool","owner":"cdzombak","description":"Quickly find \u0026 edit untitled photos in your Lychee photo library","archived":false,"fork":false,"pushed_at":"2025-10-20T16:54:05.000Z","size":990,"stargazers_count":0,"open_issues_count":6,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-23T21:41:33.536Z","etag":null,"topics":["lychee"],"latest_commit_sha":null,"homepage":"","language":"Go","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/cdzombak.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-04T13:22:39.000Z","updated_at":"2025-09-30T00:57:14.000Z","dependencies_parsed_at":"2025-09-30T02:23:36.218Z","dependency_job_id":"b929a8ee-a053-4dbd-9bd0-2f3e8cef62a7","html_url":"https://github.com/cdzombak/lychee-meta-tool","commit_stats":null,"previous_names":["cdzombak/lychee-meta-tool"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/cdzombak/lychee-meta-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Flychee-meta-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Flychee-meta-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Flychee-meta-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Flychee-meta-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cdzombak","download_url":"https://codeload.github.com/cdzombak/lychee-meta-tool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Flychee-meta-tool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281485702,"owners_count":26509764,"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","status":"online","status_checked_at":"2025-10-28T02:00:06.022Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["lychee"],"created_at":"2025-10-28T17:59:25.091Z","updated_at":"2025-10-28T17:59:26.164Z","avatar_url":"https://github.com/cdzombak.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lychee Meta Tool\n\nQuickly find \u0026 edit untitled photos in your [Lychee](https://github.com/LycheeOrg/Lychee) photo library. Automatically identifies photos with generic camera names (`IMG_1234`, `CD5_5678`, etc.) and provides an efficient interface for adding meaningful titles.\n\n![screenshot](metatool.jpeg)\n\n## Features\n\n- **Smart Detection**: Automatically finds photos with generic camera names, UUIDs, or empty titles\n- **Album Filtering**: Work on photos from specific albums only\n- **Keyboard Navigation**: Ctrl+J/K for previous/next photo\n- **Single Binary Deployment**: All frontend assets embedded\n- **Multi-Database Support**: MySQL, PostgreSQL, SQLite\n- **AI Title Suggestions:** optional Ollama integration for title suggestions\n\n### Photo Detection\n\nIdentifies photos needing titles by looking for the following patterns:\n\n- 3-character camera prefixes: `CD5_1234`, `IMG_5678`, `DSZ_9012`\n- UUID-based filenames\n- Screenshot and timestamp patterns\n- Empty or null titles\n\n## Installation\n\n### macOS via Homebrew\n\n```shell\nbrew install cdzombak/oss/lychee-meta-tool\n```\n\n### Debian via apt repository\n\n[Install my Debian repository](https://www.dzombak.com/blog/2025/06/updated-instructions-for-installing-my-debian-package-repositories/) if you haven't already:\n\n```shell\nsudo mkdir -p /etc/apt/keyrings\ncurl -fsSL https://dist.cdzombak.net/keys/dist-cdzombak-net.gpg -o /etc/apt/keyrings/dist-cdzombak-net.gpg\nsudo chmod 644 /etc/apt/keyrings/dist-cdzombak-net.gpg\nsudo mkdir -p /etc/apt/sources.list.d\nsudo curl -fsSL https://dist.cdzombak.net/cdzombak-oss.sources -o /etc/apt/sources.list.d/cdzombak-oss.sources\nsudo chmod 644 /etc/apt/sources.list.d/cdzombak-oss.sources\nsudo apt update\n```\n\nThen install `lychee-meta-tool` via `apt-get`:\n\n```shell\nsudo apt-get install lychee-meta-tool\n```\n\n### Manual installation from build artifacts\n\nPre-built binaries for Linux and macOS on various architectures are downloadable from each [GitHub Release](https://github.com/cdzombak/lychee-meta-tool/releases). Debian packages for each release are available as well.\n\n### Build and install locally\n\n```shell\ngit clone https://github.com/cdzombak/lychee-meta-tool.git\ncd lychee-meta-tool\nmake build\n\ncp out/lychee-meta-tool $INSTALL_DIR\n```\n\n## Docker images\n\nDocker images are available for a variety of Linux architectures from [Docker Hub](https://hub.docker.com/r/cdzombak/lychee-meta-tool) and [GHCR](https://github.com/cdzombak/dirshard/pkgs/container/lychee-meta-tool). Images are based on the `scratch` image and are as small as possible.\n\nRun them via, for example:\n\n```shell\ndocker run --rm cdzombak/lychee-meta-tool:1 [OPTIONS]\ndocker run --rm ghcr.io/cdzombak/lychee-meta-tool:1 [OPTIONS]\n```\n\n## Configuration\n\nConfiguration is provided via a JSON or YAML file. See [`config.example.yaml`](config.example.yaml). \n\n```yaml\ndatabase:\n  type: mysql  # mysql, postgres, or sqlite\n  host: localhost\n  port: 3306\n  user: lychee\n  password: your_password\n  database: lychee\n\nlychee_base_url: \"https://your-lychee-instance.com\"\n\nserver:\n  port: 8080\n```\n\n## Usage\n\n1. Select photos from the filmstrip at the top\n2. Use the album filter in the right panel to focus on specific albums\n3. Add titles in the right panel editor\n4. Press Enter to save and move to the next photo\n5. Use Ctrl+J/K for keyboard navigation\n6. _(optional)_ Use Ctrl-I for AI title suggestion\n\n## License\n\nMIT License; see [`LICENSE`](LICENSE) in this repo.\n\n## Author\n\n[Claude Code](https://www.anthropic.com/claude-code) wrote this code with management and changes by Chris Dzombak ([dzombak.com](https://www.dzombak.com) / [github.com/cdzombak](https://www.github.com/cdzombak)).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdzombak%2Flychee-meta-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcdzombak%2Flychee-meta-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdzombak%2Flychee-meta-tool/lists"}