StarNet2 Photoshop Panel

English | 한국어

English

StarNet2 Photoshop Panel is a Windows CEP extension that runs the StarNet2 CLI from Photoshop and imports the star-removal results as layers.

Current version: v0.9.6

Features

• Process the selected regular pixel layer with StarNet2
• Create Starless, Stars, and Star Boost (Large) result layers
• Automatically apply a Photoshop selection or the current layer mask to the results
• Preserve the source layer through a non-destructive workflow
• Cancel processing, roll back partial results on failure, and automatically clean temporary files
• Detect the system language automatically and provide Korean and English UI options

Requirements

• Windows
• A version of Adobe Photoshop that supports CEP Extensions (Legacy)
• StarNet2 CLI 2.5.x or 2.6.x
• The StarNet2 distribution for Windows DirectML

End users do not need to install Node.js separately. The panel uses the Node runtime included with Photoshop CEP.

This repository does not include the StarNet2 executable or models. Install the StarNet2 CLI separately.

Installation

1. Close Photoshop completely.
2. Download the entire repository and extract it.
3. Run Install_Windows.bat.
4. Restart Photoshop after installation finishes.
5. Open Window > Extensions (Legacy) > StarNet2.

The panel is installed in:

%APPDATA%\Adobe\CEP\extensions\StarNet-Panel

This panel is currently an unsigned CEP extension. When necessary, the installer asks whether it may enable PlayerDebugMode for the current Windows user. It skips this step when the setting is already enabled.

The installer and uninstaller detect the Windows user language and display Korean or English. To override the detected language, set STARNET_LANG=ko or STARNET_LANG=en before running the script.

Configuring the StarNet2 executable

1. Select the settings icon in the upper-right corner of the panel.
2. Enter the full path to starnet2.exe under StarNet2 Executable.
3. Select Save to validate and store the executable path.

If starnet2.exe is available through the Windows PATH, you may enter only its filename.

Using Star Removal

1. Open the document to process in Photoshop.
2. Select a regular pixel layer.
3. If needed, open Show Details and choose the result layers and processing quality.
4. Select Run StarNet2.

To process the composite of multiple visible layers, first create a merged pixel layer in Photoshop and then select that layer.

Result layers

Layer	Blend mode	Purpose
Starless	Normal	Image with stars removed
Stars	Screen	Restores all stars in their default state
Star Boost (Large)	Screen	Adds extra emphasis to large stars

Large Star Boost Strength controls the opacity of the Star Boost (Large) layer. Its default value is 60%.

2× Upsample can improve the processing of small stars or difficult star shapes, but increases processing time and memory usage.

Automatic result masks

Star Removal determines the result mask in this order when processing begins:

1. If a Photoshop selection exists, it is applied as the mask of each result layer.
2. If there is no selection and the current layer has a mask, that mask is copied to the results.
3. If neither exists, result layers are created without masks.

When both a selection and a layer mask exist, the selection takes priority. The source pixels are processed without applying the existing layer mask, and the selected result mask is applied to each result only once.

Source protection and temporary files

• The source Photoshop document and source layer are not modified directly.
• Results are placed immediately above the layer that was selected when processing started.
• Input and result TIFF files are removed after success, failure, or cancellation.
• StarNet2 temporary files older than 24 hours are cleaned when the panel starts.
• Temporary Photoshop documents created during processing are closed without saving.
• The input document's ICC profile information is reassigned while importing the result layers.

Uninstallation

1. Close Photoshop completely.
2. Run Uninstall_Windows.bat.
3. Keep PlayerDebugMode enabled if another unsigned CEP panel still requires it.

Development and testing

Node.js is not required for ordinary panel use. It is required only in the development environment to run the repository's Node-based tests.

node tests/run-tests.js

With Photoshop running, you can execute the integration test:

powershell -NoProfile -ExecutionPolicy Bypass -File .\tests\Run_Photoshop_Integration.ps1

The integration test creates a temporary Photoshop document and closes it automatically without saving.

License

This project is distributed under the GNU General Public License v3.0.

Project structure

StarNet-Panel/
├─ CSXS/manifest.xml
├─ client/
│  ├─ index.html
│  ├─ style.css
│  ├─ i18n.js
│  └─ main.js
└─ host/host.jsx

Install_Windows.bat
Uninstall_Windows.bat
LICENSE
tests/

---

한국어

StarNet2 CLI를 Photoshop 안에서 실행하고 별 제거 결과를 레이어로 가져오는 Windows CEP 패널입니다.

현재 버전: v0.9.6

주요 기능

• 선택한 일반 픽셀 레이어를 StarNet2로 처리
• Starless, Stars, Star Boost (Large) 결과 레이어 생성
• 선택 영역 또는 현재 레이어 마스크를 결과에 자동 적용
• 원본 레이어를 직접 변경하지 않는 비파괴 작업 흐름
• 처리 취소, 실패 시 결과 롤백 및 임시 파일 자동 정리
• 시스템 언어 자동 감지 및 한국어/영어 UI 선택

요구 사항

• Windows
• Adobe Photoshop CEP Extensions (Legacy) 지원 버전
• StarNet2 CLI 2.5.x 또는 2.6.x
• Windows DirectML용 StarNet2 배포판

일반 사용자는 Node.js를 별도로 설치할 필요가 없습니다. 패널 실행에는 Photoshop CEP에 포함된 Node 런타임을 사용합니다.

이 저장소에는 StarNet2 실행 파일과 모델이 포함되어 있지 않습니다. StarNet2 CLI를 별도로 준비해야 합니다.

설치

1. Photoshop을 완전히 종료합니다.
2. 저장소 전체를 내려받아 압축을 풉니다.
3. Install_Windows.bat을 실행합니다.
4. 설치가 끝나면 Photoshop을 다시 실행합니다.
5. Window > Extensions (Legacy) > StarNet2를 엽니다.

설치 위치는 다음과 같습니다.

%APPDATA%\Adobe\CEP\extensions\StarNet-Panel

현재 패널은 서명되지 않은 CEP 확장입니다. 설치 프로그램은 필요한 경우 현재 Windows 사용자의 PlayerDebugMode 활성화 여부를 묻고, 이미 활성화되어 있으면 해당 단계를 건너뜁니다.

설치 및 제거 프로그램은 Windows 사용자 언어를 감지해 한국어 또는 영어로 표시합니다. 필요하면 실행 전에 STARNET_LANG=ko 또는 STARNET_LANG=en을 지정할 수 있습니다.

StarNet2 실행 파일 설정

1. 패널 오른쪽 위의 설정 아이콘을 누릅니다.
2. StarNet2 실행 파일에서 starnet2.exe의 전체 경로를 지정합니다.
3. 저장을 눌러 실행 파일 확인을 완료합니다.

starnet2.exe가 Windows PATH에 등록되어 있다면 파일명만 사용할 수도 있습니다.

Star Removal 사용법

1. Photoshop에서 처리할 문서를 엽니다.
2. 처리할 일반 픽셀 레이어를 선택합니다.
3. 필요하면 세부 설정 보기에서 생성할 결과와 처리 품질을 조정합니다.
4. StarNet2 실행을 누릅니다.

보이는 여러 레이어의 합성 결과를 처리하려면 Photoshop에서 합성 픽셀 레이어를 만든 뒤 그 레이어를 선택하세요.

결과 레이어

레이어	혼합 모드	용도
Starless	표준	별이 제거된 이미지
Stars	스크린	모든 별을 기본 상태로 복원
Star Boost (Large)	스크린	큰 별만 추가로 강조

큰 별 강조 강도는 Star Boost (Large) 레이어의 불투명도를 조절합니다. 기본값은 **60%**입니다.

2× Upsample은 작은 별이나 어려운 별 형상의 처리를 개선할 수 있지만 처리 시간과 메모리 사용량이 늘어납니다.

결과 마스크 자동 처리

Star Removal은 처리 시작 시 다음 순서로 결과 마스크를 결정합니다.

1. Photoshop 선택 영역이 있으면 선택 영역을 결과 레이어 마스크로 적용합니다.
2. 선택 영역이 없고 현재 레이어에 마스크가 있으면 해당 마스크를 결과에 복사합니다.
3. 둘 다 없으면 마스크 없이 결과 레이어를 생성합니다.

선택 영역과 레이어 마스크가 모두 있으면 선택 영역이 우선합니다. 입력 픽셀은 기존 레이어 마스크를 적용하지 않은 상태로 처리하고, 결정된 결과 마스크를 결과 레이어에 한 번만 적용합니다.

원본 보호와 임시 파일

• 원본 Photoshop 문서와 원본 레이어는 직접 변경하지 않습니다.
• 결과는 처리 시작 시 선택한 레이어 바로 위에 배치합니다.
• 입력·결과 TIFF는 성공, 실패 또는 취소 후 자동으로 정리합니다.
• 24시간 이상 지난 StarNet2 임시 파일은 패널 시작 시 정리합니다.
• 처리 중 생성한 Photoshop 임시 문서는 저장하지 않고 닫습니다.
• 입력 문서의 ICC 프로파일 정보를 결과 레이어를 가져오는 과정에서 다시 지정합니다.

제거

1. Photoshop을 완전히 종료합니다.
2. Uninstall_Windows.bat을 실행합니다.
3. 다른 서명되지 않은 CEP 패널을 사용 중이라면 PlayerDebugMode를 유지합니다.

개발 및 테스트

일반 사용에는 Node.js가 필요하지 않지만, 저장소의 Node 기반 테스트를 실행하려면 개발 환경에 Node.js가 필요합니다.

node tests/run-tests.js

Photoshop을 실행한 상태에서 통합 테스트를 실행할 수 있습니다.

powershell -NoProfile -ExecutionPolicy Bypass -File .\tests\Run_Photoshop_Integration.ps1

통합 테스트는 테스트용 Photoshop 문서를 만든 뒤 저장하지 않고 자동으로 닫습니다.

라이선스

이 프로젝트는 GNU General Public License v3.0에 따라 배포됩니다.

프로젝트 구조

StarNet-Panel/
├─ CSXS/manifest.xml
├─ client/
│  ├─ index.html
│  ├─ style.css
│  ├─ i18n.js
│  └─ main.js
└─ host/host.jsx

Install_Windows.bat
Uninstall_Windows.bat
LICENSE
tests/