Skip to content

Photographic Style Port v0.6.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 07 Oct 15:24
· 8 commits to master since this release
v0.6.2
803e605

English · 中文

How to use

You need a Windows PC or Mac (Linux works too). The tool can't run on an iPhone.

1. Download the file for your computer from Assets below:

Computer File
Windows photographic-style-port-0.6.2-windows-x86_64.zip
Mac with Apple silicon (M1 or later) photographic-style-port-0.6.2-macos-arm64.tar.gz
Mac with Intel photographic-style-port-0.6.2-macos-x86_64.tar.gz
Linux photographic-style-port-0.6.2-linux-x86_64.tar.gz

Not sure which Mac you have? Apple menu → About This Mac → look at "Chip".

2. Get the original photos onto the computer as HEIC files, e.g. by AirDrop, or on a Mac in Photos with File → Export → Export Unmodified Original. Photos converted to JPEG won't work.

3. Run it

  • Windows: unzip, then drag your HEIC photos (or a folder of them) onto photographic-style-port.exe. If Windows says it "protected your PC", click More info → Run anyway. That happens because the tool isn't code-signed.
  • Mac: double-click the .tar.gz to unpack it. Open Terminal and type cd (with a space). Drag the unpacked folder into the Terminal window and press Return. Then run this once, so macOS lets the tool run: 
    xattr -d com.apple.quarantine photographic-style-port
    Type ./photographic-style-port (with a space), drag your photos into the Terminal window, and press Return.

Each photo gets a new copy next to the original: NAME_PhotographicStyle.HEIC, or NAME_TextureGrain.HEIC for iPhone 16/17 photos. Existing files are never overwritten.

4. Send the new file back to your iPhone as a file (AirDrop, or save it to Files), not by syncing it into your Photo Library. Syncing converts it to JPEG and removes everything the tool added. Open it in Photos and tap Edit to use Photographic Styles.

"No embedded thumbnail"? Copies re-saved by iOS often have no thumbnail, and creating one needs two free tools. On a Mac, install Homebrew, then run brew install ffmpeg libheif, and run the tool again. On Windows, follow Install from source. If you can, export the original photo again instead.

More options: photographic-style-port --help and the README.

使用方法

需要一台 Windows 电脑或 Mac（Linux 也可以），无法在 iPhone 上运行。

1. 下载：在下方 Assets 中选择对应文件：

电脑 文件
Windows photographic-style-port-0.6.2-windows-x86_64.zip
Apple 芯片的 Mac（M1 及以后） photographic-style-port-0.6.2-macos-arm64.tar.gz
Intel 芯片的 Mac photographic-style-port-0.6.2-macos-x86_64.tar.gz
Linux photographic-style-port-0.6.2-linux-x86_64.tar.gz

不确定 Mac 的芯片？点按苹果菜单 →“关于本机”，查看“芯片”一项。

2. 把原始照片传到电脑上，保持 HEIC 格式。例如用隔空投送，或在 Mac 的“照片”App 中选择“文件 → 导出 → 导出未修改的原件”。已转换为 JPEG 的照片无法处理。

3. 运行

  • Windows： 解压后，把 HEIC 照片（或装有照片的文件夹）拖到 photographic-style-port.exe 上。如果出现“Windows 已保护你的电脑”，点按“更多信息 → 仍要运行”。出现这个提示是因为本工具没有代码签名。
  • Mac： 双击 .tar.gz 解压。打开“终端”，输入 cd （后面带一个空格），把解压出的文件夹拖进终端窗口，按回车。首次使用先运行下面这行，让 macOS 允许运行本工具： 
    xattr -d com.apple.quarantine photographic-style-port
    然后输入 ./photographic-style-port （后面带一个空格），把照片拖进终端窗口，按回车。

每张照片会在原图旁边生成新文件 文件名_PhotographicStyle.HEIC。iPhone 16/17 拍摄的照片生成 文件名_TextureGrain.HEIC。已有文件不会被覆盖。

4. 以文件形式把新照片传回 iPhone（隔空投送，或存储到“文件”），不要同步到照片图库。同步会把照片转成 JPEG，并去掉本工具添加的全部内容。在“照片”App 中打开，点按“编辑”即可使用摄影风格。

提示“没有内嵌缩略图”？ 经 iOS 重新存储的副本常常没有缩略图，生成缩略图需要另外两个免费工具。Mac 上先安装 Homebrew，运行 brew install ffmpeg libheif，再重新运行本工具。Windows 上请参照从源码安装。也可以重新导出原始照片再试。

更多选项见 photographic-style-port --help 和 中文说明。

Full Changelog: v0.5.1...v0.6.2

Assets 7
Loading