차세대 YouTube 미디어 관리자

기능

PinchFlat은 yt-dlp를 사용하여 제작된 YouTube 콘텐츠를 다운로드하기 위한 자체 호스팅 앱입니다. 가볍고 독립적이며 사용하기 쉽도록 설계되었습니다. YouTube 채널이나 재생 목록에서 콘텐츠를 다운로드하는 방법에 대한 규칙을 설정하면 나머지는 정기적으로 새 콘텐츠를 확인하여 수행됩니다. 미디어 센터 앱(Plex, Jellyfin, Kodi)에서 사용할 콘텐츠를 다운로드하려는 사람들이나 미디어를 보관하려는 사람들에게 적합합니다!

개별 비디오를 다운로드할 수도 있지만 PinchFlat은 채널이나 재생 목록에서 콘텐츠를 다운로드하는 데 가장 적합합니다. 또한 앱 내에서 콘텐츠를 소비하기 위한 것도 아닙니다. PinchFlat은 콘텐츠를 디스크에 다운로드한 다음 미디어 센터 앱이나 VLC로 시청할 수 있습니다.

귀하의 사용 사례에 적합하지 않은 경우 기능을 요청하세요! Tube Archivist, ytdl-sub 및 TubeSync와 같은 훌륭한 대안을 확인할 수도 있습니다.

특징

자체 포함 - 외부 종속성이 없는 단 하나의 Docker 컨테이너
콘텐츠를 원하는 위치와 방식으로 저장할 수 있는 강력한 이름 지정 시스템
바로 시작할 수 있도록 사전 설정이 포함된 사용하기 쉬운 웹 인터페이스
Plex, Jellyfin 및 Kodi와 같은 미디어 센터 앱에 대한 최고 수준의 지원(문서)
즐겨 사용하는 팟캐스트 앱에 RSS 피드 제공 지원(문서)
채널 및 재생 목록에서 새 콘텐츠를 자동으로 다운로드합니다.

새로운 접근 방식을 사용하여 다른 앱보다 더 빠르게 새로운 콘텐츠를 다운로드합니다.

오디오 콘텐츠 다운로드 지원
YouTube Shorts 및 실시간 스트림 처리를 위한 맞춤 규칙
알림 지원 알림
일정 기간이 지나면 새 미디어를 자동으로 다시 다운로드할 수 있습니다.

이는 새로운 콘텐츠의 다운로드 품질을 향상하거나 SponsorBlock 태그를 개선하는 데 도움이 될 수 있습니다.

선택적으로 오래된 콘텐츠(문서)를 자동으로 삭제합니다.
마감일 설정 및 제목별 필터링과 같은 고급 옵션(문서)
안정적인 무인 작동
비공개 재생목록(문서)을 다운로드하기 위해 쿠키를 YouTube에 전달할 수 있습니다.
스폰서블록 통합
[고급]에서는 맞춤 yt-dlp 옵션을 허용합니다(문서).
[고급] 미디어 다운로드/삭제 후 사용자 정의 스크립트 실행 지원(알파 - 문서)

스크린샷

핀치플랫 스크린샷

설치

미습

커뮤니티 앱 스토어에서 PinchFlat을 검색해 보세요!

포터

중요한

네트워크 파일 공유에 구성을 저장하는 방법은 아래 참고 사항을 참조하세요. 가능하다면 구성을 로컬 디스크에 저장하는 것이 좋습니다.

Docker Compose 파일:

 버전: '3'services: 핀치플랫: 이미지: ghcr.io/kieraneglin/pinchFlat:latest 환경: # 시간대를 현지 시간대로 설정합니다.
      - TZ=America/New_York 포트:
      - '8945:8945' 볼륨:
      - /호스트/경로/to/config:/config
      - /호스트/경로/대상/다운로드:/다운로드

도커

호스트 시스템에 두 개의 디렉터리를 만듭니다. 하나는 구성 저장용이고 다른 하나는 다운로드한 미디어 저장용입니다. Docker 컨테이너를 실행하는 사용자가 둘 다 쓸 수 있는지 확인하세요.
아래 두 가지 방법 중 하나로 Docker 이미지를 준비합니다.

참고: Docker Hub keglin/pinchflat:latest 에서도 사용 가능

GHCR에서: docker pull ghcr.io/kieraneglin/pinchflat:latest
로컬로 빌드: docker build . --file docker/selfhosted.Dockerfile -t ghcr.io/kieraneglin/pinchflat:latest

컨테이너를 실행합니다.

 # 아래의 /host/path/to/config 및 /host/path/to/downloads를 # 1단계에서 생성한 디렉터리 경로로 바꾸십시오.# America/New_York를 현지 시간대로 바꾸십시오. run
   -e TZ=미국/New_York
   -p 8945:8945
   -v /호스트/경로/to/config:/config
   -v /호스트/경로/to/downloads:/downloads
   ghcr.io/kieraneglin/pinchFlat:최신

중요: 파일 권한

탑재한 호스트 디렉터리가 Docker 컨테이너를 실행하는 사용자가 쓸 수 있는지 확인 해야 합니다 . 권한 오류가 발생하면 제안된 단계를 따르세요. 자세한 내용은 #106을 참조하세요.

중요한

컨테이너를 루트로 실행하는 것은 권장되지 않습니다. 그렇게 하면 다른 앱이 다운로드한 미디어를 사용해야 하는 경우 권한 문제가 발생할 수 있습니다.

고급: 네트워크 공유에 PinchFlat 구성 디렉터리 저장

#137에서 지적했듯이 SQLite는 네트워크 공유에서 WAL 모드로 실행되는 것을 좋아하지 않습니다. 네트워크 공유에서 PinchFlat을 실행하는 경우 JOURNAL_MODE 환경 변수를 delete 로 설정하여 WAL 모드를 비활성화할 수 있습니다. 이렇게 하면 성능은 떨어지지만 네트워크 공유에서는 작동하는 롤백 저널 모드에서 PinchFlat이 실행됩니다.

주의

이 설정을 WAL에서 기존 PinchFlat 인스턴스에서 delete 하도록 변경하면 데이터가 손실될 수 있습니다. 수행 중인 작업, 이것이 중요한 이유를 알고 있고 데이터 손실이나 DB 손상 가능성이 있어도 괜찮을 경우에만 이 설정을 변경하십시오. 먼저 데이터베이스를 백업하세요!

이 설정을 변경하시고 잘 되셨다면 #137에 댓글을 남겨주세요! 잘 작동하지 않으면 두 배로 늘어납니다.

환경변수

이름	필수의?	기본	메모
`TZ`	아니요	`UTC`	IANA TZ 형식을 따라야 합니다.
`LOG_LEVEL`	아니요	`debug`	`info` 로 설정할 수 있지만 `debug` 적극 권장합니다.
`BASIC_AUTH_USERNAME`	아니요		인증 문서 보기
`BASIC_AUTH_PASSWORD`	아니요		인증 문서 보기
`EXPOSE_FEED_ENDPOINTS`	아니요	`false`	RSS 피드 문서 보기
`ENABLE_IPV6`	아니요	`false`	공백이 아닌 값 으로 설정하면 IPv6가 활성화됩니다.
`JOURNAL_MODE`	아니요	`wal`	구성 디렉터리가 네트워크 공유에 저장된 경우 `delete` 하도록 설정(권장하지 않음)
`TZ_DATA_DIR`	아니요	`/etc/elixir_tzdata_data`	시간대 데이터베이스가 저장되는 컨테이너 경로
`BASE_ROUTE_PATH`	아니요	`/`	경로 생성을 위한 기본 경로입니다. 특정 역방향 프록시 뒤에서 실행할 때 유용하지만 접두사는 제거되어야 합니다.
`YT_DLP_WORKER_CONCURRENCY`	아니요	`2`	대기열당 `yt-dlp` 사용하는 동시 작업자 수입니다. IP가 제한되는 경우 1로 설정하고, 그렇지 않으면 만지지 마세요.