nothing2obvi/pixelfin

어떤 프로젝트인가요?

핵심 기능

• 01미디어 항목별 및 라이브러리별로 누락되었거나 허용 범위를 벗어난 아트워크를 표시합니다.
• 02검색, 업로드, 삭제, Backdrop 순서 변경 등 앱 내 이미지 편집을 지원합니다.
• 03아트워크를 ZIP으로 내보내고 dry run 검토 및 나란히 놓은 비교 화면을 통해 복원합니다.
• 04요약 표와 Jellyfin으로 돌아가는 링크가 포함된 독립 실행형 HTML 갤러리를 생성합니다.
• 05Series, Movies, Music, Music Videos, Collections 라이브러리를 지원합니다.
• 06Python으로 로컬에서 실행하거나 amd64 및 arm64 환경에서 Docker로 실행할 수 있습니다.

활용 사례

• 대규모 Jellyfin 라이브러리에서 해상도가 낮거나 누락된 포스터와 배경 이미지를 찾을 때.
• Jellyfin 서버를 재구축하거나 이전하기 전에 아트워크를 백업할 때.
• 서버를 옮긴 뒤 ZIP에서 아트워크를 복원하되, 먼저 dry run으로 확인할 때.
• 아트워크를 눈으로 검토해 라이브러리 전체에 일관된 스타일을 적용할 때.

빠른 시작

1. 1

   requirements.txt에서 Python 종속성을 설치합니다

   pip install -r requirements.txt
2. 2

   Pixelfin을 시작합니다

   python app.py
3. 3

   브라우저에서 웹 앱을 엽니다

사용 전 알아둘 점

• !라이선스가 명시되어 있지 않아 사용 권한이 불분명합니다.
• !보안을 고려해 만들어진 앱이 아니므로 로컬 환경이나 신뢰할 수 있는 사설 네트워크에서만 실행해야 합니다.
• !실행 중인 Jellyfin 서버와 Jellyfin API 키가 필요합니다.
• !작성자는 이 앱을 보안이 강화된 프로덕션 앱이 아닌 로컬 도구로 설명합니다.

포함된 컬렉션

토픽

자주 묻는 질문

pixelfin은(는) 무엇인가요?

Jellyfin 아트워크를 점검하고, 누락되거나 크기가 맞지 않는 이미지를 표시해 편집한 뒤 ZIP으로 백업하는 로컬 웹 앱입니다. Pixelfin은 Jellyfin 라이브러리의 아트워크를 검토하는 로컬 웹 앱입니다. 미디어 항목별 요약 표와 시각적 갤러리를 제공하며, Primary, Backdrop, Logo, ClearArt, Banner, Thumb 등의 이미지 유형을 다룹니다. 이미지가 없으면 표시하고, 최소 해상도보다 낮거나 선택한 최대 해상도를 초과하는 이미지도 표시해 교체가 필요한 아트워크를 쉽게 찾을 수 있습니다.

pixelfin은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

pixelfin에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.

pixelfin은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. pixelfin의 마지막 커밋은 2026년 10월 23일입니다.

pixelfin은(는) 어디에 사용할 수 있나요?

대규모 Jellyfin 라이브러리에서 해상도가 낮거나 누락된 포스터와 배경 이미지를 찾을 때. Jellyfin 서버를 재구축하거나 이전하기 전에 아트워크를 백업할 때. 서버를 옮긴 뒤 ZIP에서 아트워크를 복원하되, 먼저 dry run으로 확인할 때. 아트워크를 눈으로 검토해 라이브러리 전체에 일관된 스타일을 적용할 때.

pixelfin는 어떻게 설치하나요?

requirements.txt에서 Python 종속성을 설치합니다: pip install -r requirements.txt Pixelfin을 시작합니다: python app.py 브라우저에서 웹 앱을 엽니다

pixelfin은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nothing2obvi/pixelfin