프로젝트 소개

Miraru(anime-tracker)는 Python/FastAPI 백엔드와 SQLite로 만든 데스크톱 애플리케이션으로, 개인 애니·시리즈·영화 라이브러리를 관리하기 위한 도구입니다. 프런트엔드는 프레임워크 없이 HTML/CSS/JS로 구성되며 PyInstaller로 패키징되어 휴대용 실행 파일 또는 Windows 설치 프로그램을 제공합니다. 검색 및 소스: 8개의 애니 소스(AniList, Jikan v4, Kitsu, Crunchyroll, AnimeFLV, AnimePlanet, AnimeAV1, MAL)를 통합하며, 개별적으로 또는 한 번에 모두 조회할 수 있습니다. 비애니 영화와 시리즈에는 TMDB 데이터를 사용합니다. 검색기는 항목을 추가하기 전에 미리보기를 표시합니다. 정리: 사용자 지정 목록, 즐겨찾기, 시즌, 평점 및 메모를 지원하고, 그리드 또는 압축 테이블 보기, 카드에서 별표로 빠른 평가, 목록 간 드래그 앤 드롭, 일괄 작업(상태, 목록, 즐겨찾기, 삭제)을 위한 다중 선택을 제공합니다. 인터페이스 및 생산성: Ctrl+K 명령 팔레트, 키보드 단축키(/, Esc, N), genre:, score:, eps:, year:, fav: 같은 검색 연산자, 삭제 시 5초 동안 실행 취소 스낵바가 있습니다. 탐색: 각 항목에는 예고편, 시청 가능 플랫폼, 유사 작품(AniList)이 포함됩니다. 도넛 차트, 장르 필, 완료까지 걸리는 시간이 있는 통계가 있고, 다음 에피소드와 방영 중 애니를 보여주는 신작 섹션, 당일 에피소드 알림이 있는 주간 캘린더, «계속 보기» 위젯과 몰아보기 모드, 좋아하는 장르 기반 자동 추천, 새 에피소드에 대한 웹 알림이 있습니다. 동기화 및 모바일: 선택적 Google Sheets 동기화와 PC에서 PIN으로 활성화할 수 있는 설치형 PWA를 통한 로컬 WiFi 모바일 접속을 제공합니다. 인터페이스는 스페인어, 영어, 프랑스어, 독일어를 지원하며 라이트 및 다크 모드가 있습니다. 설치: 사용자용으로 Python이 필요 없고 데이터를 파일 옆에 저장하는 휴대용 실행 파일(Miraru-Portable.exe) 또는 바로가기가 포함된 설치 프로그램(Miraru-Setup.exe)이 있습니다. Scoop 또는 winget에 게시하기 위한 매니페스트도 있습니다. 소스 코드에서 실행하려면 Python을 찾아 의존성을 설치하고 브라우저를 여는 Miraru.vbs를 사용하면 되며, launcher.py 또는 main.py로 수동 실행할 수도 있습니다. 실행 파일은 태그를 푸시하면 GitHub Actions를 통해 자동으로 생성되거나, 로컬에서 compilar.bat 및 build.py --portable로 빌드됩니다. 라이선스는 MIT입니다.