anime-sh

검색 및 재생

사용자는 애니메이션 제목의 일부만 입력해도 유추 검색을 통해 원하는 작품을 찾을 수 있습니다. 예를 들어 ‘atack on titan’ 또는 ‘dont toy with me’와 같이 오타가 있어도 정확한 작품을 찾아 재생합니다. 재생은 mpv를 통해 이루어지며, 사용자의 mpv 설정을 존중합니다.

에피소드 관리

시청한 에피소드를 자동으로 기록하고, 이어보기 기능을 통해 마지막 시청 위치부터 재생할 수 있습니다. 즐겨찾기 추가, 히스토리 조회, 통계 확인도 가능하며, AniList와 연동 시 두 방향 동기화가 지원됩니다.

다운로드 및 오프라인 재생

ffmpeg가 설치된 경우 에피소드를 다운로드하여 오프라인에서 재생할 수 있습니다. 다운로드는 resumable하며, 저장된 파일을 자동으로 재생합니다. 다운로드 범위는 특정 에피소드 목록 또는 범위로 지정할 수 있습니다.

테마 및 레이아웃 커스터마이징

‘t’ 키를 눘 테마 picker를 통해 실시간으로 테마를 변경할 수 있습니다. 기본 제공 테마로는 midnight, ember, paper이 있으며, tokyo-night, nord, gruvbox 등 인기 테마도 지원됩니다. 에피소드 목록은 그리드, 리스트, 컴팩트 레이아웃 중 선택 가능하며, 홈 화면의 밀도도 조절할 수 있습니다.

AniList 연동

AniList 계정을 연동하면 시청 기록을 양방향으로 동기화할 수 있습니다. anime-sh에서 에피소드를 완료하면 모바일 앱에도 반영되고, 반대로 `anime sync pull` 명령으로 다른 기기의 시청 기록을 가져올 수 있습니다. 인증은 사용자만의 클라이언트 ID와 시크릿을 발급받아 진행되며, 토큰은 로컬에 안전하게 저장됩니다.

Windows용 설치 (Scoop 기준)

1. PowerShell을 관리자가 아닌 일반 사용자로 열고 다음 명령을 실행합니다:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

1. 필요한 버킷을 추가하고 anime-sh를 설치합니다:

scoop bucket add extras
scoop bucket add anime-sh https://github.com/Anime123450/scoop-anime-sh
scoop install anime-sh

설치 후 새로운 터미널을 열면 `anime` 명령이 정상적으로 작동합니다. 관리자 권한으로 실행하지 마세요 — Scoop은 per-user 설치를 위해 일반 권한에서만 작동합니다.

Chocolatey를 통한 설치

Chocolatey가 설치되어 있다면 간단히 다음 명령으로 설치할 수 있습니다. 이 경우에도 mpv가 함께 설치되지만, 다운로드 기능을 사용하려면 ffmpeg를 별도로 설치해야 합니다.

choco install anime-sh

다운로드 기능을 사용하려면 ffmpeg를 추가로 설치합니다:

choco install ffmpeg

WinGet을 통한 설치 (미리보기 단계)

WinGet을 통해 설치할 수 있으나 현재 검토 중입니다. 설치 후 PATH가 갱신되지 않을 수 있으니 새로운 터미널을 열어야 합니다.

winget install AnimeshSharma.anime-sh

어떤 OS에서도 Python과 uv를 사용한 설치

Python이 없는 환경에서도 uv를 사용해 설치할 수 있습니다. uv는 자체 Python을 번들로 포함하므로 깨끗한 시스템에서도 동작합니다.

# Windows
winget install astral-sh.uv ; winget install shinchiro.mpv
# macOS
brew install uv mpv
# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh && sudo apt install mpv

uv tool install "anime-sh[tui]"
anime doctor

첫 실행 및 TUI 실행

설치 후 터미널에서 간단히 `anime` 명령을 입력하면 TUI가 실행됩니다. 여기서 Continue Watching, Airing This Season, 트렌딩 작품들을 확인할 수 있으며, 오른쪽 패널에서는 선택된 작품의 포스터, 장르, 진행 상황, 다음 에피소드 정보 등을 확인할 수 있습니다.

직접 재생 및 검색

작품 이름을 인수로 전달해 바로 재생할 수 있습니다. 예를 들어 `anime “Frieren”`은 해당 작품을 검색해 첫 번째 에피소드를 재생합니다. 특정 에피소드를 재생하려면 다음과 같이 입력합니다:

anime play "Frieren" -e 18 --dub -q 1080p

이 명령은 더빙 버전의 1080p 품질로 18화를 재생합니다. shell 탭 완성을 활성화하려면 다음 명령을 한 번 실행합니다:

anime --install-completion

에피소드 다운로드

ffmpeg가 설치된 상태에서 에피소드를 다운로드할 수 있습니다. 범위 지정이나 특정 화 목록으로 다운로드가 가능하며, 다운로드된 파일은 자동으로 오프라인 재생 목록에 추가됩니다.

anime download "Frieren" -e 1-12
anime download "Frieren" -e 1,3,5

저장된 파일을 재생하려면 다음과 같이 입력합니다:

anime play "Frieren" -e 1

테마 변경

TUI 내에서 ‘t’ 키를 눘 테마 목록을 볼 수 있으며, 방향 키로 이동해 실시간 미리보기를 확인할 수 있습니다. Enter를 눘 현재 테마를 적용하거나, Esc를 눘 이전 테마로 돌아갈 수 있습니다. 명령줄에서도 테마를 변경할 수 있습니다:

anime themes --set ember

지원 환경·시스템 요구사항

anime-sh는 Windows 10 이상에서 정상적으로 동작합니다. 설치는 Scoop, Chocolatey, WinGet, 또는 PyPI를 통해 이루어지며, 모든 설치 방식은 사용자 권한 내에서 동작합니다. 관리자 권한이 필요하지 않습니다. 핵심 의존성은 mpv이며, 다운로드 기능을 사용하려면 ffmpeg가 필요합니다. Python 3.11 이상은 소스 또는 PyPI 설치 시에만 필요하며, 패키지 관리자(Scoop, Chocolatey 등)를 통해 설치할 경우 내부적으로 처리되어 사용자가 별도로 설치할 필요가 없습니다.

제한 사항·확인 사항

일부 스트리밍 제공자는 Cloudflare 보호 또는 지리적 제한으로 인해 간헐적으로 접근이 차단될 수 있습니다. 이 경우 해당 제공자는 일시적으로 비활성화되지만, 다른 제공자를 통해 콘텐츠를 계속 이용할 수 있습니다. 제공자 상태는 앱 내 Providers 배지를 통해 확인할 수 있으며, 빨간색으로 표시될 경우 해당 사이트가 차단되었음을 의미합니다. 이는 앱의 오류가 아닌 외부 서비스의 정상적인 동작입니다.

FAQ

• anime-sh는 무료로 사용할 수 있나요?
  네, anime-sh는 MIT 라이선스 하에 배포되는 오픈소스 소프트웨어로, 무료로 다운로드하고 사용할 수 있습니다.
• Windows에서만 사용할 수 있나요?
  아니요, anime-sh는 Windows, macOS, Linux에서 모두 사용할 수 있습니다. 설치 방법은 운영체제에 따라 다를 수 있지만 핵심 기능은 동일합니다.
• AniList 계정이 없어도 사용할 수 있나요?
  네, AniList 연동은 선택 사항입니다. 계정 없이도 검색, 재생, 다운로드, 기록 관리 등의 모든 핵심 기능을 사용할 수 있습니다.
• 설치 후 ‘anime’ 명령이 인식되지 않아요.
  이는 PATH가 갱신되지 않았기 때문입니다. Winget을 사용한 경우 새로운 터미널을 열어야 하며, Scoop이나 uv를 사용한 경우 일반 터미널에서 바로 작동해야 합니다. 여전히 문제가 있다면 `uv tool update-shell` 또는 터미널 재시작을 시도해 보세요.
• 다운로드 기능을 사용하려면何が必要ですか？
  다운로드 기능을 사용하려면 ffmpeg가 설치되어 있어야 합니다. Scoop이나 Chocolatey를 통해 설치한 경우 별도로 `scoop install ffmpeg` 또는 `choco install ffmpeg` 명령을 실행해 ffmpeg를 추가로 설치해야 합니다.