Skip to content

비디오 다운로드

로컬 비디오 도구를 사용하여 YouTube 및 TikTok 비디오를 vault에 직접 다운로드하세요.

개요

YouTube 또는 TikTok 포스트를 아카이빙한 후, 컴퓨터에 필요한 비디오 처리 도구가 설치되어 있으면 Social Archiver가 실제 비디오 파일을 vault에 다운로드할 수 있습니다.

왜 이런 접근 방식인가요?

이 기능은 두 가지 고려 사항을 염두에 두고 설계되었습니다:

  1. Vault 크기 관리: 일부 사용자는 Obsidian vault에 대용량 비디오 파일을 저장하기를 원하지 않습니다. 파일 크기 제한이 있는 Obsidian Sync를 사용하는 경우 특히 중요합니다:

    • Sync Standard: 파일당 5MB
    • Sync Plus: 파일당 200MB

    비디오 다운로드를 선택 사항으로 만들고 로컬 도구를 필요로 함으로써, vault에 저장되고 기기 간에 동기화되는 항목을 완전히 제어할 수 있습니다.

  2. 기술적 제한: YouTube 및 TikTok는 자동화된 비디오 다운로드에 대해 강력한 보호 기능을 구현합니다. 웹 기반 스크래핑 방법으로는 이러한 플랫폼에서 비디오를 안정적으로 다운로드할 수 없습니다. 대신, 이러한 플랫폼의 다운로드 메커니즘을 처리하도록 특별히 설계된 입증된 오픈 소스 도구(yt-dlp, ffmpeg)를 활용합니다.

이러한 접근 방식을 통해 메타데이터와 썸네일을 빠르게 아카이빙한 다음 필요할 때만 선택적으로 전체 비디오를 다운로드할 수 있는 유연성을 제공합니다.

요구사항

다음 오픈 소스 도구 중 하나가 설치되어 있어야 합니다:

yt-dlp (권장)

여러 플랫폼을 지원하는 현대적이고 활발히 유지 관리되는 YouTube 다운로더입니다.

설치:

bash
# macOS (Homebrew 사용)
brew install yt-dlp

# Windows (Scoop 사용)
scoop install yt-dlp

# Linux (pip 사용)
pip install yt-dlp

설치 확인:

bash
yt-dlp --version

ffmpeg

비디오 처리를 위한 멀티미디어 프레임워크입니다. 포맷 변환을 위해 yt-dlp와 함께 자주 사용됩니다.

설치:

bash
# macOS (Homebrew 사용)
brew install ffmpeg

# Windows (Scoop 사용)
scoop install ffmpeg

# Linux (Debian/Ubuntu)
sudo apt install ffmpeg

설치 확인:

bash
ffmpeg -version

작동 방식

  1. 포스트 아카이브: 먼저 YouTube 또는 TikTok 포스트를 정상적으로 아카이브
  2. 완료 대기: 메타데이터 및 썸네일과 함께 아카이브 프로세스 완료
  3. 비디오 다운로드 배너: yt-dlp 또는 ffmpeg가 감지되면 포스트 카드에 배너가 나타남
  4. 클릭하여 다운로드: 배너를 클릭하여 비디오 파일 다운로드
  5. 비디오 저장됨: 비디오가 vault의 첨부 파일 폴더에 저장됨

비디오 저장 위치

비디오는 다음 위치에 저장됩니다:

attachments/social-archives/{platform}/{date}_{postId}.mp4

예시:

attachments/social-archives/youtube/2024-11-14_abc123xyz.mp4

지원 플랫폼

  • YouTube: 여러 품질 옵션이 있는 Full HD 다운로드
  • TikTok: 워터마크가 있는 원본 비디오 (플랫폼 제한으로 인해)

문제 해결

배너가 나타나지 않음

원인: yt-dlp 또는 ffmpeg가 시스템 PATH에서 찾을 수 없음

해결 방법:

  1. yt-dlp --version 또는 ffmpeg -version으로 설치 확인
  2. 도구 설치 후 Obsidian 재시작
  3. 도구가 시스템 PATH에 있는지 확인

다운로드 실패

일반적인 원인:

  • 비디오가 비공개이거나 삭제됨
  • 네트워크 연결 문제
  • 디스크 공간 부족
  • 플랫폼 속도 제한

해결 방법:

  • 브라우저에서 비디오에 여전히 액세스할 수 있는지 확인
  • 인터넷 연결 확인
  • 충분한 여유 디스크 공간이 있는지 확인
  • 몇 분 기다렸다가 다시 시도

느린 다운로드

대용량 비디오 파일(특히 4K)은 다운로드하는 데 시간이 걸릴 수 있습니다. 배너에 진행 상황 업데이트가 표시됩니다.

디스크 공간

비디오 파일은 대용량(100MB - 1GB 이상)일 수 있습니다. 여러 비디오를 다운로드하기 전에 충분한 디스크 공간이 있는지 확인하세요.

품질 설정

비디오 품질은 다음에 따라 자동으로 선택됩니다:

  • 플랫폼에서 사용 가능한 포맷
  • 디스크 공간
  • 네트워크 속도

YouTube의 경우 yt-dlp는 일반적으로 최대 1080p까지 사용 가능한 최상의 품질을 다운로드합니다.

개인정보 보호 및 저작권

중요

저장할 권한이 있는 비디오만 다운로드하세요. 저작권법 및 플랫폼 서비스 약관을 존중하세요. 이 기능은 개인 아카이빙 전용입니다.

MIT 라이선스로 배포됩니다.