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 对象列表

有用链接

编辑推荐精选

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

热门AI工具AI办公办公工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图
讯飞星火

讯飞星火

深度推理能力全新升级,全面对标OpenAI o1

科大讯飞的星火大模型,支持语言理解、知识问答和文本创作等多功能,适用于多种文件和业务场景,提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台,涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能,能为不同需求的用户提供便捷高效的帮助,助力用户轻松获取信息、解决问题,满足多样化使用场景。

模型训练热门AI工具内容创作智能问答AI开发讯飞星火大模型多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目,由多个知名机构联合参与。该项目提供了高效的 LLM(大语言模型)驱动的语音合成方案,支持语音克隆和语音创建功能,可通过命令行界面(CLI)和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数,生成高质量的语音。该项目适用于多种场景,如有声读物制作、智能语音助手开发等。

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

热门AI工具生产力协作转型TraeAI IDE
咔片PPT

咔片PPT

AI助力,做PPT更简单!

咔片是一款轻量化在线演示设计工具,借助 AI 技术,实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT,提供海量模板、智能美化、素材替换等功能,适用于销售、教师、学生等各类人群,能高效制作出高品质 PPT,满足不同场景演示需求。

讯飞绘文

讯飞绘文

选题、配图、成文,一站式创作,让内容运营更高效

讯飞绘文,一个AI集成平台,支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容,加速品牌传播,提升内容营销效果。

AI助手热门AI工具AI创作AI辅助写作讯飞绘文内容运营个性化文章多平台分发
材料星

材料星

专业的AI公文写作平台,公文写作神器

AI 材料星,专业的 AI 公文写作辅助平台,为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能,支持 30 + 文稿类型生成,助力快速完成领导讲话、工作总结、述职报告等材料,提升办公效率,是体制打工人的得力写作神器。

openai-agents-python

openai-agents-python

OpenAI Agents SDK,助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK,它为开发者提供了与 OpenAI 模型交互的高效工具,支持工具调用、结果处理、追踪等功能,涵盖多种应用场景,如研究助手、财务研究等,能显著提升开发效率,让开发者更轻松地利用 OpenAI 的技术优势。

Hunyuan3D-2

Hunyuan3D-2

高分辨率纹理 3D 资产生成

Hunyuan3D-2 是腾讯开发的用于 3D 资产生成的强大工具,支持从文本描述、单张图片或多视角图片生成 3D 模型,具备快速形状生成能力,可生成带纹理的高质量 3D 模型,适用于多个领域,为 3D 创作提供了高效解决方案。

3FS

3FS

一个具备存储、管理和客户端操作等多种功能的分布式文件系统相关项目。

3FS 是一个功能强大的分布式文件系统项目,涵盖了存储引擎、元数据管理、客户端工具等多个模块。它支持多种文件操作,如创建文件和目录、设置布局等,同时具备高效的事件循环、节点选择和协程池管理等特性。适用于需要大规模数据存储和管理的场景,能够提高系统的性能和可靠性,是分布式存储领域的优质解决方案。

下拉加载更多