# Hera

Hera is a self-hosted music recommendation and music discovery service with automated downloading powered by Last.fm and Downtify. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2464/hera

## Description

Hera is a self-hosted music recommendation and music discovery service with automated downloading powered by Last.fm and Downtify. Discover new music tailored to your listening taste, fetch recommendations on a schedule, and keep your self-hosted music library fresh.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

45/100 (Fair), based on 3 of 4 factors.
- Maintained: 71 (last commit 69 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/athuul/hera
- GitHub: https://github.com/athuull/hera
- Unraid: https://ca.unraid.net/apps/hera-1czrap61noeqta?q=hera

## Common questions

### How do I point Hera at my music folder and settings location?

Mount a local directory to /music/downloads for downloaded music and another to /config for settings. The defaults are ./music and ./config, and MUSIC_DIR and CONFIG_DIR can be overridden in a .env file.

### Do I need any extra services or credentials for Hera to download music?

Yes, the Docker Compose setup includes a Downtify service and uses DOWNTIFY_API_URL so Hera can perform downloads. You also need to enter your Last.fm API key and username in the settings panel.

### How does Hera avoid downloading duplicate tracks?

It indexes local files and ID3 tags before downloading using multi-tier deduplication. This includes exact title normalization, unicode support, distinctive title extraction, and artist matching.

### What audio formats and metadata options can I configure?

Hera supports MP3 up to 320 kbps CBR, FLAC, M4A, and Opus output. It can also configure cover art resolution, include synced .lrc lyrics, and use ffmpeg to convert .webm files to .mp3.

### Can Hera automatically fetch and limit recommendation downloads?

It can run automated cron downloads on a configurable schedule, such as nightly. New tracks are fetched and downloaded automatically up to a daily limit.

---
Source: Our Local Host (https://ourlocalhost.com/app/2464/hera), the self-hosted and open-source app directory.
