krateng/maloja

어떤 프로젝트인가요?

핵심 기능

• 01스크로블을 파싱하기 쉬운 형식으로 로컬에 저장
• 02데이터 손실 없이 아티스트와 하위 유닛, 협업 프로젝트, 솔로 프로젝트를 연결
• 03여러 아티스트가 참여하거나 피처링이 포함된 트랙에서 아티스트별 재생 횟수를 따로 집계
• 04프록시 스크로블을 통해 다른 서비스로 스크로블 전달
• 05Last.fm 호환 또는 ListenBrainz 호환 서버를 지원하는 모든 클라이언트에서 스크로블 수신
• 06아티스트와 트랙 이미지를 직접 업로드

활용 사례

• 장기간의 청취 습관 기록을 비공개로 보관
• 연결된 앱으로 재생하지 않는 바이닐이나 배경 음악의 재생 기록 추적
• Last.fm 또는 Spotify 내보내기 파일에서 수년 치 기록 가져오기
• 홈 서버에서 개인용 통계 페이지 운영

빠른 시작

1. 1

   데이터 폴더를 마운트한 상태로 Docker 컨테이너를 실행하세요

   docker run -p 42010:42010 -v $PWD/malojadata:/mljdata -e MALOJA_DATA_DIRECTORY=/mljdata krateng/maloja
2. 2

   브라우저에서 localhost:42010에 접속해 웹 인터페이스를 여세요

사용 전 알아둘 점

• !현재는 보안 업데이트만 배포되고 있으며, 작성자는 후속 프로젝트인 maloja-rs를 개발 중입니다.
• !README에서는 베어메탈 설치를 권장하지 않으며 해당 설치에 대한 지원도 제공하지 않습니다. Docker 또는 Podman을 사용하세요.
• !아티스트 이미지를 표시하려면 무료 Last.fm 및 Spotify API 키가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

maloja은(는) 무엇인가요?

청취 기록을 저장하고 개인 청취 통계와 차트를 생성하는 셀프 호스팅 음악 스크로블 데이터베이스입니다. Maloja는 셀프 호스팅 서버로, 음악 플레이어가 전송하는 재생 기록인 스크로블을 수집해 개인 청취 통계와 차트로 만들어 줍니다. 라이브러리는 로컬에 보관되며 공개 음악 데이터베이스와 동기화되지 않으므로, 원하는 태그 체계를 적용할 수 있습니다.

maloja은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

maloja은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

maloja은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. maloja의 마지막 커밋은 2026년 11월 6일입니다.

maloja은(는) 어디에 사용할 수 있나요?

장기간의 청취 습관 기록을 비공개로 보관 연결된 앱으로 재생하지 않는 바이닐이나 배경 음악의 재생 기록 추적 Last.fm 또는 Spotify 내보내기 파일에서 수년 치 기록 가져오기 홈 서버에서 개인용 통계 페이지 운영

maloja는 어떻게 설치하나요?

데이터 폴더를 마운트한 상태로 Docker 컨테이너를 실행하세요: docker run -p 42010:42010 -v $PWD/malojadata:/mljdata -e MALOJA_DATA_DIRECTORY=/mljdata krateng/maloja 브라우저에서 localhost:42010에 접속해 웹 인터페이스를 여세요

maloja은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/krateng/maloja