{"id":21823449,"url":"https://github.com/f2calv/cascap.googlephotoscli","last_synced_at":"2025-06-13T14:01:58.108Z","repository":{"id":36976481,"uuid":"314598131","full_name":"f2calv/CasCap.GooglePhotosCli","owner":"f2calv","description":"Google Photos CLI - to upload/download/analyze media items in your library.","archived":false,"fork":false,"pushed_at":"2024-07-31T05:14:11.000Z","size":97,"stargazers_count":10,"open_issues_count":11,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T18:13:53.298Z","etag":null,"topics":["google-photos-cli"],"latest_commit_sha":null,"homepage":"","language":"C#","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/f2calv.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":"2020-11-20T15:46:12.000Z","updated_at":"2024-03-12T03:00:45.000Z","dependencies_parsed_at":"2023-01-17T10:32:27.886Z","dependency_job_id":"a3949dc8-c309-44a0-bfe0-751084d3aac3","html_url":"https://github.com/f2calv/CasCap.GooglePhotosCli","commit_stats":{"total_commits":30,"total_committers":5,"mean_commits":6.0,"dds":0.6333333333333333,"last_synced_commit":"e10cff151b0928ae283629e87fd8e0186c7d8587"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f2calv%2FCasCap.GooglePhotosCli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f2calv%2FCasCap.GooglePhotosCli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f2calv%2FCasCap.GooglePhotosCli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f2calv%2FCasCap.GooglePhotosCli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/f2calv","download_url":"https://codeload.github.com/f2calv/CasCap.GooglePhotosCli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248819910,"owners_count":21166567,"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":["google-photos-cli"],"created_at":"2024-11-27T17:32:09.465Z","updated_at":"2025-04-14T04:22:59.383Z","avatar_url":"https://github.com/f2calv.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Google Photos CLI (a work in progress)\n\n## _Unofficial_ Google Photos Command Line Interface\n\n[azdo-badge]: https://dev.azure.com/f2calv/github/_apis/build/status/f2calv.CasCap.GooglePhotosCli?branchName=master\n[azdo-url]: https://dev.azure.com/f2calv/github/_build/latest?definitionId=11\u0026branchName=master\n[azdo-coverage-url]: https://img.shields.io/azure-devops/coverage/f2calv/github/11\n[cascap.apis.googlephotoscli-badge]: https://img.shields.io/nuget/v/googlephotos?color=blue\n[cascap.apis.googlephotoscli-url]: https://nuget.org/packages/googlephotos\n\n![CI](https://github.com/f2calv/CasCap.GooglePhotosCli/actions/workflows/ci.yml/badge.svg) [![Coverage Status](https://coveralls.io/repos/github/f2calv/CasCap.GooglePhotosCli/badge.svg?branch=main)](https://coveralls.io/github/f2calv/CasCap.GooglePhotosCli?branch=main) [![SonarCloud Coverage](https://sonarcloud.io/api/project_badges/measure?project=f2calv_CasCap.GooglePhotosCli\u0026metric=code_smells)](https://sonarcloud.io/component_measures/metric/code_smells/list?id=f2calv_CasCap.GooglePhotosCli) [![Nuget][cascap.apis.googlephotoscli-badge]][cascap.apis.googlephotoscli-url]\n\nThis is an _unofficial_ Google Photos CLI which can be installed as a .NET Global Tool.\n\nGoogle Photos CLI is an _unofficial_ utility which leverages the [CasCap.Apis.GooglePhotos](https://github.com/f2calv/CasCap.Apis.GooglePhotos) library to perform common and helpful operations against the media items held in your Google Photos account.\n\nIf you find this tool of use then please give it a thumbs-up by giving this repository a :star: ... :wink:\n\nKey functionality;\n\n- Media item upload\n- Media item download/backup\n- Media item duplicate detection\n\n## Installation/Set-up\n\nThe Google Photos CLI is distributed as a [.NET Core Global Tool](https://docs.microsoft.com/en-us/dotnet/core/tools/global-tools), to install the tool follow these steps;\n\n- Follow [these instructions](https://github.com/f2calv/CasCap.Apis.GooglePhotos#google-photos-api-set-up) to set-up OAuth login details.\n- Download and install either the [.NET Core 3.1 SDK](https://dotnet.microsoft.com/download/dotnet-core/3.1) or [.NET 6.0 SDK](https://dotnet.microsoft.com/download/dotnet/6.0).\n- From a command line shell install the tool `dotnet tool update --global googlephotos`\n\nNow check the tool is installed by entering `googlephotos` at a shell.\n\n## Usage\n\nUse the context-sensitive help command to discover additional functionality/arguments;\n\n- `googlephotos --help`\n\nThe tool will download and cache album and media item _metadata_ locally for speed during duplicate detection. This local cache data is stored in your user profile. If you use the `logout` command this local cache will be deleted;\n\n- `googlephotos logout`\n\n### Albums\n\nShow context-senstive help for the albums sub-command;\n\n- `googlephotos albums --help`\n\nList all albums;\n\n- `googlephotos albums list`\n\nShow albums with duplicate names;\n\n- `googlephotos albums list --duplicates`\n\nAdd/create a new empty album with a title of 'my album title';\n\n- `googlephotos albums add -t \"my album title\"`\n\nDownload media items from specified album title into a folder;\n\n- `googlephotos albums download -t \"my album title\" -o c:/temp/download`\n\nDownload media items from specified album title into a folder, thumbnails, cropped, with EXIF information (except location);\n\n- `googlephotos albums download -t \"my album title\" -o c:/temp/download --maxwidth 100`\n- `googlephotos albums download -t \"my album title\" -o c:/temp/download --maxheight 100`\n- `googlephotos albums download -t \"my album title\" -o c:/temp/download --maxheight 100 --crop`\n- `googlephotos albums download -t \"my album title\" -o c:/temp/download --maxheight 100 --crop --exif`\n- `googlephotos albums download -t \"my album title\" -o c:/temp/download --maxheight 100 --crop --exif --overwrite`\n\nRe-sync local album data with the latest data from the API;\n\n- `googlephotos albums sync`\n\n### MediaItems\n\nShow context-senstive help for the media items sub-command;\n\n- `googlephotos mediaitems --help`\n\nList all media items (this could be a very long list!);\n\n- `googlephotos mediaitems list`\n\nAnaylse all meta data and search for possible duplicates;\n\n- `googlephotos mediaitems duplicates`\n\nUpload media items into your google photos account, with optional pattern;\n\n- `googlephotos mediaitems upload -s C:/temp/fotos`\n- `googlephotos mediaitems upload -s C:/temp/fotos --pattern *.jpg`\n\n### Feedback/Issues\n\nThis CLI is a work in progress, I have started lots of features or left stubs in the code which I hope to eventually complete...\nPlease post any issues or feedback [here](https://github.com/f2calv/CasCap.GooglePhotosCli/issues).\n\n### License\n\nGooglePhotosCli is Copyright \u0026copy; 2020 [@f2calv](https://github.com/f2calv) under the [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff2calv%2Fcascap.googlephotoscli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff2calv%2Fcascap.googlephotoscli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff2calv%2Fcascap.googlephotoscli/lists"}