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

有用链接

编辑推荐精选

TRAE编程

TRAE编程

AI辅助编程,代码自动修复

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

AI工具TraeAI IDE协作生产力转型热门
博思AIPPT

博思AIPPT

AI一键生成PPT,就用博思AIPPT!

博思AIPPT,新一代的AI生成PPT平台,支持智能生成PPT、AI美化PPT、文本&链接生成PPT、导入Word/PDF/Markdown文档生成PPT等,内置海量精美PPT模板,涵盖商务、教育、科技等不同风格,同时针对每个页面提供多种版式,一键自适应切换,完美适配各种办公场景。

AI办公办公工具AI工具博思AIPPTAI生成PPT智能排版海量精品模板AI创作热门
潮际好麦

潮际好麦

AI赋能电商视觉革命,一站式智能商拍平台

潮际好麦深耕服装行业,是国内AI试衣效果最好的软件。使用先进AIGC能力为电商卖家批量提供优质的、低成本的商拍图。合作品牌有Shein、Lazada、安踏、百丽等65个国内外头部品牌,以及国内10万+淘宝、天猫、京东等主流平台的品牌商家,为卖家节省将近85%的出图成本,提升约3倍出图效率,让品牌能够快速上架。

iTerms

iTerms

企业专属的AI法律顾问

iTerms是法大大集团旗下法律子品牌,基于最先进的大语言模型(LLM)、专业的法律知识库和强大的智能体架构,帮助企业扫清合规障碍,筑牢风控防线,成为您企业专属的AI法律顾问。

SimilarWeb流量提升

SimilarWeb流量提升

稳定高效的流量提升解决方案,助力品牌曝光

稳定高效的流量提升解决方案,助力品牌曝光

Sora2视频免费生成

Sora2视频免费生成

最新版Sora2模型免费使用,一键生成无水印视频

最新版Sora2模型免费使用,一键生成无水印视频

Transly

Transly

实时语音翻译/同声传译工具

Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手,它拥有超精准的音频识别翻译能力,几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球,无论你是留学生、商务人士、韩剧美剧爱好者,还是出国游玩、多国会议、跨国追星等等,都可以满足你所有需要同传的场景需求,线上线下通用,扫除语言障碍,让全世界的语言交流不再有国界。

讯飞绘文

讯飞绘文

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

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

热门AI辅助写作AI工具讯飞绘文内容运营AI创作个性化文章多平台分发AI助手
商汤小浣熊

商汤小浣熊

最强AI数据分析助手

小浣熊家族Raccoon,您的AI智能助手,致力于通过先进的人工智能技术,为用户提供高效、便捷的智能服务。无论是日常咨询还是专业问题解答,小浣熊都能以快速、准确的响应满足您的需求,让您的生活更加智能便捷。

imini AI

imini AI

像人一样思考的AI智能体

imini 是一款超级AI智能体,能根据人类指令,自主思考、自主完成、并且交付结果的AI智能体。

下拉加载更多