Jellyfin, Plex, Emby 라이브러리의 영화 및 TV 프로그램 요청과 승인 절차를 관리하는 오픈소스 웹 앱입니다.
Maintainerr/Maintainerr
규칙에 따라 시청하지 않았거나 요청되지 않은 미디어를 모아 유예 기간 후 정리하는 Plex, Jellyfin, Emby용 라이브러리 관리 도구입니다.
- 스타
- 2,355
- 포크
- 126
- 열린 이슈
- 3
- 마지막 커밋
- 어제
어떤 프로젝트인가요?
Maintainerr는 미디어 라이브러리 정리를 자동화합니다. 시청 활동, 요청 여부, 콘텐츠의 오래된 정도 같은 속성을 AND/OR 논리와 조합해 규칙을 작성하면 됩니다. 규칙에 해당하는 타이틀은 컬렉션에 모아 사용자가 시청할 수 있도록 설정 가능한 유예 기간 동안 보류한 뒤 처리합니다. 처리 방식으로는 디스크에서 파일 삭제, Radarr, Sonarr, Sportarr에서 항목 모니터링 해제 또는 삭제, 화질 프로필 변경, Seerr 또는 Ombi에서 요청 삭제 등이 있습니다.
미디어 서버와 *arr 앱에서 IMDB, TMDB, TVDB ID 및 개봉 연도를 확인해 항목을 매칭하므로 잘못된 타이틀을 처리하는 일을 방지합니다. 컬렉션은 자동 또는 수동으로 관리할 수 있으며, cron 일정에 따라 규칙을 실행할 수 있습니다. Discord, Slack, Telegram, ntfy, 이메일 등의 서비스를 통해 알림을 보냅니다.
Maintainerr는 Docker, Podman 또는 Kubernetes로 배포할 수 있으며, Swagger/OpenAPI 인터페이스와 상태 확인 엔드포인트를 제공합니다.
핵심 기능
- 01Plex, Jellyfin, Emby, Radarr, Sonarr, Seerr, Ombi, Tautulli의 속성을 사용하는 규칙 작성기입니다.
- 02삭제 전 유예 기간을 설정할 수 있으며, 컬렉션을 Plex 홈 화면에 표시할 수도 있습니다.
- 03디스크에서 파일을 삭제하고 Radarr, Sonarr, Sportarr의 항목을 처리합니다.
- 04포스터 오버레이와 사용자 지정 컬렉션 포스터를 지원합니다.
- 05YAML 형식의 규칙 가져오기/내보내기와 서버 간 마이그레이션을 지원합니다.
- 06Discord, Slack, Telegram, ntfy, 이메일, 웹훅을 통해 알림을 보냅니다.
활용 사례
- 오랫동안 아무도 시청하지 않은 영화와 TV 프로그램을 삭제해 디스크 공간을 확보합니다.
- 타이틀이 삭제된 뒤 Seerr 또는 Ombi의 오래된 미디어 요청을 정리합니다.
- 삭제 전에 '곧 종료' 컬렉션을 통해 가족 구성원에게 미리 알립니다.
- 미디어 서버별로 별도의 인스턴스를 실행해 규칙을 분리합니다.
빠른 시작
- 1
Docker 설치
- 2
Docker run으로 Maintainerr 시작
docker run -d --name maintainerr -e TZ=Europe/Brussels -v ./data:/opt/data -u 1000:1000 -p 6246:6246 --restart unless-stopped ghcr.io/maintainerr/maintainerr:latest - 3
포트 6246에서 웹 UI를 열고 미디어 서버에 연결
사용 전 알아둘 점
- 유예 기간이 지나면 미디어가 자동으로 삭제되므로 규칙을 신중하게 설정해야 합니다.
- x86 시스템에서 이미지 오버레이와 컬렉션 포스터를 사용하려면 x86-64-v2를 지원하는 CPU가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- Maintainerr은(는) 무엇인가요?
- 규칙에 따라 시청하지 않았거나 요청되지 않은 미디어를 모아 유예 기간 후 정리하는 Plex, Jellyfin, Emby용 라이브러리 관리 도구입니다. Maintainerr는 미디어 라이브러리 정리를 자동화합니다. 시청 활동, 요청 여부, 콘텐츠의 오래된 정도 같은 속성을 AND/OR 논리와 조합해 규칙을 작성하면 됩니다. 규칙에 해당하는 타이틀은 컬렉션에 모아 사용자가 시청할 수 있도록 설정 가능한 유예 기간 동안 보류한 뒤 처리합니다. 처리 방식으로는 디스크에서 파일 삭제, Radarr, Sonarr, Sportarr에서 항목 모니터링 해제 또는 삭제, 화질 프로필 변경, Seerr 또는 Ombi에서 요청 삭제 등이 있습니다.
- Maintainerr은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- Maintainerr은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- Maintainerr은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. Maintainerr의 마지막 커밋은 2026년 10월 23일입니다.
- Maintainerr은(는) 어디에 사용할 수 있나요?
- 오랫동안 아무도 시청하지 않은 영화와 TV 프로그램을 삭제해 디스크 공간을 확보합니다. 타이틀이 삭제된 뒤 Seerr 또는 Ombi의 오래된 미디어 요청을 정리합니다. 삭제 전에 '곧 종료' 컬렉션을 통해 가족 구성원에게 미리 알립니다. 미디어 서버별로 별도의 인스턴스를 실행해 규칙을 분리합니다.
- Maintainerr는 어떻게 설치하나요?
- Docker 설치 Docker run으로 Maintainerr 시작: docker run -d --name maintainerr -e TZ=Europe/Brussels -v ./data:/opt/data -u 1000:1000 -p 6246:6246 --restart unless-stopped ghcr.io/maintainerr/maintainerr:latest 포트 6246에서 웹 UI를 열고 미디어 서버에 연결
- Maintainerr은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Maintainerr/Maintainerr
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Ombi는 사용자가 영화, 음악, TV 프로그램을 요청하고 Plex, Emby, Jellyfin과 동기화할 수 있는 셀프 호스팅 미디어 요청 도구입니다.
Plex, Jellyfin, Emby 서버의 스트림, 재생 분석, 계정 공유 감지를 실시간으로 모니터링하는 대시보드입니다.
Sonarr, Radarr 등에서 멈췄거나 차단된 다운로드와 악성 토렌트를 자동으로 정리하는 Servarr 생태계용 다운로드 관리 도구입니다.
Sonarr와 Radarr를 위한 보조 앱으로, TV 프로그램과 영화의 자막을 자동으로 찾고 다운로드하며 더 나은 자막으로 교체합니다.
Wizarr는 Plex, Jellyfin, Emby 등의 미디어 서버 초대 링크를 보내고 신규 사용자의 설정 과정을 안내하는 셀프 호스팅 시스템입니다.