immich go下载 - immich go源码下载

immich go

其他源码

0.22.1

下载

Immich-Go：将您的照片上传到您的 Immich 服务器

Immich-Go是一款开源工具，旨在简化将大型照片集上传到自托管 Immich 服务器的过程。

您现在可以支持我在`Immich-go`上的工作：

Github 赞助商
贝宝捐赠

主要特点：

轻松上传大型 Google Photos Takeout： Immich-Go 擅长处理您使用 Google Takeout 从 Google Photos 下载的大量档案。它可以有效地处理这些档案，同时保留有价值的元数据，例如 GPS 位置、拍摄日期和专辑信息。
灵活上传： Immich-Go 不仅限于 Google Photos。您可以直接从计算机文件夹、文件夹树和 ZIP 存档上传照片。
安装简单： Immich-Go 不需要 NodeJS 或 Docker 来安装。这使得即使对于那些不太熟悉技术环境的人来说也可以轻松上手。
质量优先： Immich-Go 会丢弃 Google Photos Takeout 中可能包含的任何低分辨率版本，确保您在 Immich 服务器上拥有尽可能最佳的副本。
堆栈连拍和 raw/jpg 照片：在 Immich 中将相关照片分组在一起。

Google 照片最佳实践：

拿出你的照片：
- 创建外卖时选择 ZIP 格式以便于导入。
- 选择可用的最大文件大小 (50GB) 以最大限度地减少存档部分的数量。
- 将所有部件下载到您的计算机上。
导入您的照片：
- 如果您的外卖是ZIP格式，您可以直接导入，无需先解压文件。
- 将外卖的所有部分一起导入非常重要，因为某些数据可能分布在多个文件中。
  使用/path/to/your/files/takeout-*.zip作为文件名。
- 对于.tgz文件（压缩的 tar 存档），您需要在导入之前将所有文件解压缩到一个文件夹中。使用导入工具时，不要忘记-google-photos选项。
- 您可以在导入之前从导出中删除任何不需要的文件或文件夹。
- 重新启动中断的导入不会造成任何问题，并且会从原来的位置恢复工作。
很多文件未导入：有哪些选项？
- 验证所有外卖零件是否已包含在处理中。
- 请求另一次外卖，可以是一整年，也可以是较小的增量。
- 尽管缺少 JSON，仍强制导入文件。使用选项-upload-when-missing-JSON

要深入了解immich-cli替代方案背后的原因，请阅读此处的动机。

⚠️这是早期版本，尚未经过广泛测试
⚠️为了安全起见，保留文件的备份副本

执行`immich-go`

immich-go是一个必须从终端窗口运行的命令行工具。
immich-go程序使用 Immich API。因此它需要服务器地址和有效的 API 密钥。

使用 Linux、macOS 和 FreeBSD 的朋友：

./immich-go -server=URL -key=KEY -general_options COMMAND -command_options... {path/to/files}

重要的

macOS 用户必须明确允许 immich-go 运行。打开隐私和安全 > 安全设置以允许

在 Windows 系统上：

.immich - go - server = URL - key = KEY - general_options COMMAND - command_options.. . {path / to / files}

如何处理布尔选项

布尔选项具有如下所示的默认值。提及公共行上的任何选项都会将该选项更改为 TRUE。要将选项强制为 FALSE，请使用以下语法： -option=FALSE 。

示例：Immich-go 检查服务器的 SSL 证书。您可以通过打开skip-verify-ssl选项来禁用此行为。只需添加-skip-verify-ssl 。 -skip-verify-ssl相当于-skip-verify-ssl=TRUE 。要关闭该功能（这是默认行为），请使用-skip-verify-ssl=FALSE

与所有命令共享选项

范围	描述	默认值
`-use-configuration=path/to/config/file`	指定要使用的配置文件。服务器 URL 和 API 密钥存储在 immich-go 配置文件中。下次运行时可以省略它们。	Linux `$HOME/.config/immich-go/immich-go.json` Windows `%AppData%immich-goimmich-go.json` macOS `$HOME/Library/Application Support/immich-go/immich-go.json`
`-server=URL`	Immich 服务的 URL，例如 http://:2283 或 https://your-domain.tld
`-api=URL`	Immich api 端点的 URL (http://container_ip:3301)
`-device-uuid=VALUE`	强制设备识别	`$HOSTNAME`
`-client-timeout=duration`	设置服务器调用的超时时间。持续时间是带有单位后缀的十进制数，例如“300ms”、“1.5m”或“45m”。有效的时间单位为“ms”、“s”、“m”、“h”。	`5m`
`-skip-verify-ssl`	跳过 SSL 验证以与自签名证书一起使用	`false`
`-key=KEY`	由用户生成的密钥。上传的照片将属于密钥的所有者。
`-log-level=LEVEL`	按如下方式调整日志详细程度： - `ERROR` ：仅显示错误 - `WARNING` ：与前一个相同加上非阻塞错误 - `INFO` ：信息消息	`INFO`
`-log-file=/path/to/log/file`	将所有消息写入文件	Linux `$HOME/.cache/immich-go/immich-go_YYYY-MM-DD_HH-MI-SS.log` Windows `%LocalAppData%immich-goimmich-go_YYYY-MM-DD_HH-MI-SS.log` macOS `$HOME/Library/Caches/immich-go/immich-go_YYYY-MM-DD_HH-MI-SS.log`
`-log-json`	将日志输出为行分隔的 JSON 文件	`false`
`-time-zone=time_zone_name`	为没有时区信息的日期设置时区	系统时区
`-no-ui`	禁用用户界面	`false`
`-debug-counters`	启用在日志文件旁边生成 CSV	`false`
`-api-trace`	启用 API 调用跟踪	`false`

命令`upload`

使用此命令可从本地目录、压缩文件夹或 Google Photos 导出过程生成的所有 zip 文件上传照片和视频。

开关和选项：

范围	描述	默认值
`-album="ALBUM NAME"`	将资源导入到 Immich 专辑`ALBUM NAME`中。
`-dry-run`	预览所有将要完成的操作。	`FALSE`
`-create-album-folder`	在文件夹名称后生成 immich 相册。	`FALSE`
`-use-full-path-album-name`	使用文件的完整路径来确定专辑名称。	`FALSE`
`-album-name-path-separator`	确定如何连接多个（子）文件夹（如果有）
`-create-stacks`	堆叠 jpg/raw 或连拍。	`FALSE`
`-stack-jpg-raw`	控制 jpg/raw 照片的堆叠。	`FALSE`
`-stack-burst`	控制堆叠突发。	`FALSE`
`-select-types=".ext,.ext,.ext..."`	接受的扩展列表。
`-exclude-types=".ext,.ext,.ext..."`	排除的扩展名列表。
`-when-no-date=FILE\|NOW`	当无法确定拍摄日期时，请使用文件的日期或当前时间 NOW。	`FILE`
`-exclude-files=pattern`	根据模式忽略文件。不区分大小写。对您需要的每个图案重复该选项。	`@eaDir/` `@__thumb/` `SYNOFILE_THUMB_.` `Lightroom Catalog/` `thumbnails/`

日期选择：

根据特定日期微调导入：

范围	描述
`-date=YYYY-MM-DD`	导入在特定日期拍摄的照片。
`-date=YYYY-MM`	选择特定月份拍摄的照片。
`-date=YYYY`	选择特定年份拍摄的照片。

根据模式排除文件

使用-exclude-files=PATTERN从上传中排除某些文件或目录。对您需要的每个图案重复该选项。自动排除以下目录：

@eaDir/
@__拇指/
SYNOFILE_THUMB_*.*
Lightroom 目录/
缩略图/
.DS_Store/

例如，以下命令排除名为 backup 或草稿的目录中的所有文件以及名称以“copy)”结尾的任何文件，如 PXL_20231006_063121958（另一个副本）.jpg：

immich-go -server=xxxxx -key=yyyyy upload -exclude-files=backup/ -exclude-files=draft/ -exclude=copy). *  /path/to/your/files

谷歌照片选项：

Google 照片管理的专用选项：

范围	描述	默认值
`-google-photos`	从 Google Photos 结构化存档导入，重新创建相应的相册。
`-from-album="GP Album"`	在`immich`中创建相册并导入相册的资源。
`-create-albums`	控制在 Immich 中创建 Google Photos 相册。	`TRUE`
`-keep-untitled-albums`	无标题专辑将导入到`immich`中，并以文件夹名称作为标题。	`FALSE`
`-use-album-folder-as-name`	使用文件夹名称而不是专辑标题。	`FALSE`
`-keep-partner`	指定包含或排除合作伙伴拍摄的照片。	`TRUE`
`-partner-album="partner's album"`	将合作伙伴的资产导入给定专辑。
`-discard-archived`	不要导入存档资产。	`FALSE`
`-auto-archive`	自动存档同时存档在 Google 相册中的照片	`TRUE`
`-upload-when-missing-JSON`	上传与 JSON 元数据文件不关联的照片	`FALSE`

请阅读此处，了解为什么 Google Photos 外卖不容易处理。

突发检测

目前检测到遵循此模式的突发：

xxxxx_BURSTnnn.*
xxxxx_BURSTnnn_COVER.*
xxxxx.RAW-01.COVER.jpg 和 xxxxx.RAW-02.ORIGINAL.dng
xxxxx.RAW-01.MP.COVER.jpg 和 xxxxx.RAW-02.ORIGINAL.dng
xxxxxIMG_xxxxx_BURSTyyyymmddhhmmss.jpg 和 xxxxxIMG_xxxxx_BURSTyyyymmddhhmmss_COVER.jpg（华为 Nexus 6P）
yyyymmdd_hhmmss_xxx.jpg（三星）

所有图像必须在同一分钟内拍摄。 COVER 图像将成为堆栈的父图像

情侣jpg/raw检测

两张图像应在同一分钟内拍摄。 JPG 图像将作为封面。

请打开一个问题以涵盖更多可能性。

用法示例：上传 Google Photos 外卖存档

为了说明这一点，以下命令用于从 Google Photos 导出存档中导入 2019 年 6 月 1 日至 6 月 30 日期间拍摄的照片，同时自动生成相册：

./immich-go -server=http://mynas:2283 -key=zzV6k65KGLNB9mpGeri9n8Jk1VaNGHSCdoH1dY8jQ upload
-create-albums -google-photos -date=2019-06 ~ /Download/takeout- * .zip

元数据确定

Immich-go 按以下顺序获取第一个可用数据。

捕获日期：

谷歌照片外卖
1. Google 相册 JSON 字段photoTakenTime
2. 照片的文件名：ex PXL_20220909_154515546.jpg
3. 照片的 exif 数据
文件夹导入
1. XMP文件
2. 照片文件名：ex PXL_20220909_154515546.jpg
3. 照片的文件路径：ex /photos/2022/11/09/IMG_1234.HEIC
4. 照片的 exif 数据

GPS位置：

谷歌照片外卖
1. Google 相册 JSON 字段geoDataExif
2. Google Photos JSON 字段geoData
3. Google 相册相册 JSON 字段locationEnrichment
4. 照片的 exif 数据
文件夹导入
1. XMP文件
2. 照片的 exif 数据

导入 Google Photos 外卖存档时：

immich-go从关联的 JSON 文件中获取照片的日期。

服务器会忽略 immich-go 提供的日期，并采用 MP4 的日期，即使它不正确。
请参阅#322 元数据的创建时间戳错误

从目录导入照片时：

Immich-go 尝试通过文件名或文件路径确定捕获日期。

前任：

小路	照片的拍摄日期
照片/相册/PXL_20220909_154515546.jpg	2022-09-09 15:51:55
照片/扫描/19991231.jpg	1999-12-31 00:00:00
照片/20221109/IMG_1234.HEIC	2022-11-19 00:00:00
照片/2022.11.09T20.30/IMG_1234.HEIC	2022-11-19 20:30:00
照片/2022/11/09/IMG_1234.HEIC	2022-11-19 00:00:00

如果该路径无法用于确定捕获日期，则 immich-go 读取文件的metadata或exif 。

命令`duplicate`

使用此命令分析immich服务器的内容，以查找共享相同文件名、捕获日期但大小不同的任何文件。在删除下级副本之前，系统会获取其所属的所有相册，并将上级副本添加到其中。

开关和选项：

范围	描述	默认值
`-yes`	假设所有问题都回答“是”	`FALSE`
`-date`	仅检查捕获日期在给定范围内的资产	`1850-01-04,2030-01-01`
`-ignore-tz-errors`	搜索重复项时忽略时区差异	`FALSE`
`-ignore-extension`	搜索重复项时忽略文件类型扩展名	`FALSE`

用法示例：合并 Google Photos 存档和原始文件后清理`immich`服务器

此命令检查 immich 服务器内容，删除质量较差的图像并保留相册。

./immich-go -server=http://mynas:2283 -key=zzV6k65KGLNB9mpGeri9n8Jk1VaNGHSCdoH1dY8jQ duplicate -yes

命令`stack`

immich版本 1.83 引入了堆叠图像的功能。让我们用它来将连拍图像和 jpg/raw 图像分组在一起。

开关和选项：

范围	描述	默认值
`-yes`	假设所有问题都回答“是”	`FALSE`
`-date=date_range`	仅检查捕获日期在给定范围内的资产	`1850-01-04,2030-01-01`

命令`tool`

该命令引入了命令行工具来操作您的immich服务器

子命令`album delete [regexp]`

此命令删除与给定模式匹配的专辑

开关

-yes假设所有问题都是“是”（默认值：FALSE）。

例子

./immich-go -server=http://mynas:2283 -key=zzV6k65KGLNB9mpGeri9n8Jk1VaNGHSCdoH1dY8jQ tool album delete d {4}- d {2}- d {2}

此命令删除所有使用 YYYY-MM-DD 模式创建的相册

安装

从 Github 版本安装：

安装immich-go过程非常简单。访问最新版本页面并选择与您的系统兼容的二进制文件：

达尔文臂-64、x86-64
Linuxarm-64、armv6-64、x86-64
Windows arm-64、x86-64
Freebsd ARM-64，x86-64

下载与您的计算机上的操作系统/架构相对应的存档并解压缩。

打开命令窗口，进入immich-go所在目录，输入带有必填参数和命令的命令immich-go 。

⚠️请注意，linux x86-64 版本是唯一经过测试的版本。

从源安装

对于基于源的安装，请确保您拥有必要的 Go 语言开发工具 (https://go.dev/doc/install)。下载源文件或克隆存储库。

go build -ldflags " -X 'main.version= $( git describe --tag ) ' -X 'main.date= $( date ) ' "

使用 Nix 安装

immich-go与 nix 一起打包并通过 nixpkgs 分发。您可以尝试不安装immich-go ：

nix-shell -I " nixpkgs=https://github.com/NixOS/nixpkgs/archive/nixos-unstable-small.tar.gz " -p immich-go
# Or with flakes enabled
nix run " github:nixos/nixpkgs?ref=nixos-unstable-small#immich-go " -- -help

或者您可以将immich-go添加到configuration.nix的environment.systemPackages部分。

致谢

感谢 Immich 团队的出色项目！？

该程序使用以下第三方库：

https://github.com/rivo/t查看终端用户界面
github.com/rwcarlsen/goexif 从 JPEG 文件获取捕获日期
github.com/thlib/go-timezone-local 用于 Windows 时区管理

非常感谢项目贡献者：

rodneyosodo gitub CI、go linter 和建议
sigmahour SSL 管理
mrwulf 合作伙伴分享相册
erkexzcx 根据文件路径和文件名确定日期

展开

附加信息

版本 0.22.1
类型其他源码
更新时间 2024-11-04
大小 50MB
来自于 Github

immich go

Immich-Go：将您的照片上传到您的 Immich 服务器

您现在可以支持我在Immich-go上的工作：

主要特点：

Google 照片最佳实践：

执行immich-go

如何处理布尔选项

与所有命令共享选项

命令upload

开关和选项：

日期选择：

根据模式排除文件

谷歌照片选项：

突发检测

情侣jpg/raw检测

用法示例：上传 Google Photos 外卖存档

元数据确定

捕获日期：

GPS位置：

导入 Google Photos 外卖存档时：

从目录导入照片时：

命令duplicate

开关和选项：

用法示例：合并 Google Photos 存档和原始文件后清理immich服务器

命令stack

开关和选项：

命令tool

子命令album delete [regexp]

开关

例子

安装

从 Github 版本安装：

从源安装

使用 Nix 安装

致谢

您现在可以支持我在`Immich-go`上的工作：

执行`immich-go`

命令`upload`

命令`duplicate`

用法示例：合并 Google Photos 存档和原始文件后清理`immich`服务器

命令`stack`

命令`tool`

子命令`album delete [regexp]`