photoshop-python-api

photoshop-python-api

将Photoshop自动化与Python结合的开源API

photoshop-python-api是一个开源Python库,用于实现Adobe Photoshop的自动化控制。该库支持CC2017至2024版本的Photoshop,提供简洁的API接口,让开发者能通过Python代码操作Photoshop的文档、图层和文本等元素。通过COM技术与Photoshop通信,该库可在任何具备Python环境的DCC软件中使用,有效提高Photoshop工作流程的效率。

PhotoshopPython APICOM自动化图像处理Github开源项目
<p align="center"> <img src="https://i.imgur.com/cjp1RH6.png" alt="logo"> </p> <p align="center"> <a href="https://img.shields.io/pypi/pyversions/photoshop-python-api"> <img src="https://img.shields.io/pypi/pyversions/photoshop-python-api" alt="python版本"></a> <a href="https://badge.fury.io/py/photoshop-python-api"> <img src="https://img.shields.io/pypi/v/photoshop-python-api?color=green" alt="PyPI版本"></a> <img src="https://img.shields.io/pypi/dw/photoshop-python-api" alt="下载状态"> <a href="https://pepy.tech/badge/photoshop-python-api"> <img src="https://pepy.tech/badge/photoshop-python-api" alt="下载量"></a> <img src="https://img.shields.io/pypi/l/photoshop-python-api" alt="许可证"> <img src="https://img.shields.io/pypi/format/photoshop-python-api" alt="pypi格式"> <a href="https://discord.gg/AnxSa6n"> <img src="https://img.shields.io/discord/724615671400628314" alt="Discord聊天"></a> <a href="https://github.com/loonghao/photoshop-python-api/graphs/commit-activity"> <img src="https://yellow-cdn.veclightyear.com/ab5030c0/4b12f9d7-09c4-4148-8982-5b46e6e5cb3e.svg" alt="维护状态"></a> <a href="https://github.com/loonghao/photoshop-python-api/actions/workflows/bumpversion.yml"> <img src="https://yellow-cdn.veclightyear.com/ab5030c0/d557391d-ecc4-41a7-a15b-5360389bade7.svg" alt="版本更新"></a> <a href="https://github.com/loonghao/photoshop-python-api/actions/workflows/pages/pages-build-deployment"> <img src="https://yellow-cdn.veclightyear.com/ab5030c0/e729f2a9-bb0f-432e-8d13-d5aa1931b0f8.svg" alt="页面构建部署"></a> <a href="https://github.com/loonghao/photoshop-python-api/actions/workflows/publish_docs.yml"> <img src="https://yellow-cdn.veclightyear.com/ab5030c0/074fd38d-e75d-4f8e-a1ff-2dc1d33fca2d.svg" alt="文档状态"></a> <a href="https://img.shields.io/badge/photoshop-2024-green"> <img src="https://img.shields.io/badge/photoshop-2024-green" alt="photoshop-2024"></a> <a href="https://img.shields.io/badge/photoshop-2023-green"> <img src="https://img.shields.io/badge/photoshop-2023-green" alt="photoshop-2023"></a> <a href="https://img.shields.io/badge/photoshop-2022-green"> <img src="https://img.shields.io/badge/photoshop-2022-green" alt="photoshop-2022"></a> <a href="https://img.shields.io/badge/photoshop-2021-green"> <img src="https://img.shields.io/badge/photoshop-2021-green" alt="photoshop-2021"></a> <a href="https://img.shields.io/badge/photoshop-2020-green"> <img src="https://img.shields.io/badge/photoshop-2020-green" alt="photoshop-2020"></a> <a href="https://img.shields.io/badge/photoshop-CC2019-green"> <img src="https://img.shields.io/badge/photoshop-CC2019-green" alt="photoshop-CC2019"></a> <a href="https://img.shields.io/badge/photoshop-CC2018-green"> <img src="https://img.shields.io/badge/photoshop-CC2018-green" alt="photoshop-CC2018"></a> <a href="https://img.shields.io/badge/photoshop-CC2017-green"> <img src="https://img.shields.io/badge/photoshop-CC2017-green" alt="photoshop-CC2017"></a> <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->

所有贡献者

<!-- ALL-CONTRIBUTORS-BADGE:END --> </p> <p align="center">Photoshop的Python API。</p> <p align="center"><em>上面的示例是使用Photoshop Python API创建的。查看更多示例请访问<a href="https://loonghao.github.io/photoshop-python-api/examples">https://loonghao.github.io/photoshop-python-api/examples</a>。</em></p>

已经测试并支持的Photoshop版本:

Photoshop版本是否支持
2023
2022
2021
2020
cc2019
cc2018
cc2017

安装

你可以通过pip安装。

pip install photoshop_python_api

由于它使用COM(组件对象模型)连接Photoshop,因此可以在任何具有Python解释器的DCC软件中使用。

Hello World

import photoshop.api as ps app = ps.Application() doc = app.documents.add() new_doc = doc.artLayers.add() text_color = ps.SolidColor() text_color.rgb.red = 0 text_color.rgb.green = 255 text_color.rgb.blue = 0 new_text_layer = new_doc new_text_layer.kind = ps.LayerKind.TextLayer new_text_layer.textItem.contents = 'Hello, World!' new_text_layer.textItem.position = [160, 167] new_text_layer.textItem.size = 40 new_text_layer.textItem.color = text_color options = ps.JPEGSaveOptions(quality=5) # # 保存为jpg jpg = 'd:/hello_world.jpg' doc.saveAs(jpg, options, asCopy=True) app.doJavaScript(f'alert("保存为jpg: {jpg}")')

演示

Photoshop会话

作为上下文使用。

from photoshop import Session 使用 Session 创建新文档: doc = ps.active_document 文本颜色 = ps.SolidColor() 文本颜色.rgb.green = 255 新文本图层 = doc.artLayers.add() 新文本图层.kind = ps.LayerKind.TextLayer 新文本图层.textItem.contents = 'Hello, World!' 新文本图层.textItem.position = [160, 167] 新文本图层.textItem.size = 40 新文本图层.textItem.color = 文本颜色 选项 = ps.JPEGSaveOptions(quality=5) jpg = 'd:/hello_world.jpg' doc.saveAs(jpg, 选项, asCopy=True) ps.app.doJavaScript(f'alert("已保存为jpg: {jpg}")')

贡献者 ✨

感谢这些优秀的人们(表情符号说明):

<!-- ALL-CONTRIBUTORS-LIST:START - 请勿删除或修改此部分 --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/loonghao"><img src="https://avatars1.githubusercontent.com/u/13111745?v=4?s=100" width="100px;" alt="Hal"/><br /><sub><b>Hal</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/commits?author=loonghao" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/voodraizer"><img src="https://avatars0.githubusercontent.com/u/1332729?v=4?s=100" width="100px;" alt="voodraizer"/><br /><sub><b>voodraizer</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3Avoodraizer" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/brunosly"><img src="https://avatars2.githubusercontent.com/u/4326547?v=4?s=100" width="100px;" alt="brunosly"/><br /><sub><b>brunosly</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3Abrunosly" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/tubi-carrillo"><img src="https://avatars3.githubusercontent.com/u/33004093?v=4?s=100" width="100px;" alt="tubi"/><br /><sub><b>tubi</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3Atubi-carrillo" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/wjxiehaixin"><img src="https://avatars0.githubusercontent.com/u/48039822?v=4?s=100" width="100px;" alt="wjxiehaixin"/><br /><sub><b>wjxiehaixin</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3Awjxiehaixin" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="http://it.econline.net"><img src="https://avatars0.githubusercontent.com/u/993544?v=4?s=100" width="100px;" alt="罗马钟"/><br /><sub><b>罗马钟</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3Aenzozhong" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/ClementHector"><img src="https://avatars.githubusercontent.com/u/7068597?v=4?s=100" width="100px;" alt="clement"/><br /><sub><b>clement</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3AClementHector" title="错误报告">🐛</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/krevlinmen"><img src="https://avatars.githubusercontent.com/u/56278440?v=4?s=100" width="100px;" alt="krevlinmen"/><br /><sub><b>krevlinmen</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3Akrevlinmen" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/SThomasN"><img src="https://avatars.githubusercontent.com/u/63218023?v=4?s=100" width="100px;" alt="Thomas"/><br /><sub><b>Thomas</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3ASThomasN" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/CaptainCsaba"><img src="https://avatars.githubusercontent.com/u/59013751?v=4?s=100" width="100px;" alt="CaptainCsaba"/><br /><sub><b>CaptainCsaba</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3ACaptainCsaba" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://ilharper.vbox.moe"><img src="https://avatars.githubusercontent.com/u/20179549?v=4?s=100" width="100px;" alt="Il Harper"/><br /><sub><b>Il Harper</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/commits?author=Afanyiyu" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/blunderedbishop"><img src="https://avatars.githubusercontent.com/u/56189376?v=4?s=100" width="100px;" alt="blunderedbishop"/><br /><sub><b>blunderedbishop</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3Ablunderedbishop" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/MrTeferi"><img src="https://avatars.githubusercontent.com/u/92750180?v=4?s=100" width="100px;" alt="MrTeferi"/><br /><sub><b>MrTeferi</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/commits?author=MrTeferi" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/damienchambe"><img src="https://avatars.githubusercontent.com/u/42462209?v=4?s=100" width="100px;" alt="Damien Chambe"/><br /><sub><b>Damien Chambe</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/commits?author=damienchambe" title="代码">💻</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/be42day"><img src="https://avatars.githubusercontent.com/u/20614168?v=4?s=100" width="100px;" alt="Ehsan Akbari Tabar"/><br /><sub><b>Ehsan Akbari Tabar</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3Abe42day" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="http://www.linkedin.com/in/michael-ikemann"><img src="https://avatars.githubusercontent.com/u/33489959?v=4?s=100" width="100px;" alt="Michael Ikemann"/><br /><sub><b>Michael Ikemann</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/issues?q=author%3AAlyxion" title="错误报告">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/dsmtE"><img src="https://avatars.githubusercontent.com/u/37016704?v=4?s=100" width="100px;" alt="Enguerrand DE SMET"/><br /><sub><b>Enguerrand DE SMET</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/commits?author=dsmtE" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="http://www.thbattle.net"><img src="https://avatars.githubusercontent.com/u/857880?v=4?s=100" width="100px;" alt="Proton"/><br /><sub><b>Proton</b></sub></a><br /><a href="https://github.com/loonghao/photoshop-python-api/commits?author=feisuzhu" title="代码">💻</a></td> </tr> </tbody> </table> 本项目遵循 [all-contributors](https://allcontributors.org) 规范。 欢迎任何形式的贡献!

Repobeats 分析

Repobeats 分析

如何获取 Photoshop 程序 ID

Get-ChildItem "HKLM:\SOFTWARE\Classes" | ?{ ($_.PSChildName -match "^[a-z]+\.[a-z]+(\.\d+)?$") -and ($_.GetSubKeyNames() -contains "CLSID") } | ?{ $_.PSChildName -match "Photoshop.Application" } | ft PSChildName

获取程序ID

如何从注册表获取 COM 对象列表

有用链接

编辑推荐精选

音述AI

音述AI

全球首个AI音乐社区

音述AI是全球首个AI音乐社区,致力让每个人都能用音乐表达自我。音述AI提供零门槛AI创作工具,独创GETI法则帮助用户精准定义音乐风格,AI润色功能支持自动优化作品质感。音述AI支持交流讨论、二次创作与价值变现。针对中文用户的语言习惯与文化背景进行专门优化,支持国风融合、C-pop等本土音乐标签,让技术更好地承载人文表达。

lynote.ai

lynote.ai

一站式搞定所有学习需求

不再被海量信息淹没,开始真正理解知识。Lynote 可摘要 YouTube 视频、PDF、文章等内容。即时创建笔记,检测 AI 内容并下载资料,将您的学习效率提升 10 倍。

AniShort

AniShort

为AI短剧协作而生

专为AI短剧协作而生的AniShort正式发布,深度重构AI短剧全流程生产模式,整合创意策划、制作执行、实时协作、在线审片、资产复用等全链路功能,独创无限画布、双轨并行工业化工作流与Ani智能体助手,集成多款主流AI大模型,破解素材零散、版本混乱、沟通低效等行业痛点,助力3人团队效率提升800%,打造标准化、可追溯的AI短剧量产体系,是AI短剧团队协同创作、提升制作效率的核心工具。

seedancetwo2.0

seedancetwo2.0

能听懂你表达的视频模型

Seedance two是基于seedance2.0的中国大模型,支持图像、视频、音频、文本四种模态输入,表达方式更丰富,生成也更可控。

nano-banana纳米香蕉中文站

nano-banana纳米香蕉中文站

国内直接访问,限时3折

输入简单文字,生成想要的图片,纳米香蕉中文站基于 Google 模型的 AI 图片生成网站,支持文字生图、图生图。官网价格限时3折活动

扣子-AI办公

扣子-AI办公

职场AI,就用扣子

AI办公助手,复杂任务高效处理。办公效率低?扣子空间AI助手支持播客生成、PPT制作、网页开发及报告写作,覆盖科研、商业、舆情等领域的专家Agent 7x24小时响应,生活工作无缝切换,提升50%效率!

堆友

堆友

多风格AI绘画神器

堆友平台由阿里巴巴设计团队创建,作为一款AI驱动的设计工具,专为设计师提供一站式增长服务。功能覆盖海量3D素材、AI绘画、实时渲染以及专业抠图,显著提升设计品质和效率。平台不仅提供工具,还是一个促进创意交流和个人发展的空间,界面友好,适合所有级别的设计师和创意工作者。

图像生成AI工具AI反应堆AI工具箱AI绘画GOAI艺术字堆友相机AI图像热门
码上飞

码上飞

零代码AI应用开发平台

零代码AI应用开发平台,用户只需一句话简单描述需求,AI能自动生成小程序、APP或H5网页应用,无需编写代码。

Vora

Vora

免费创建高清无水印Sora视频

Vora是一个免费创建高清无水印Sora视频的AI工具

Refly.AI

Refly.AI

最适合小白的AI自动化工作流平台

无需编码,轻松生成可复用、可变现的AI自动化工作流

下拉加载更多