# Binhex Soularr

Binhex Soularr is a self-hosted downloaders app. Soularr is a Python application that automates music downloads from Soulseek for Lidarr. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2096/binhex-soularr

## Description

Soularr is a Python application that automates music downloads from Soulseek for Lidarr. It monitors Lidarr for wanted albums and searches Soulseek to download them, providing seamless integration between your music collection manager and the Soulseek network.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

44/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 9 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/binhex/arch-soularr
- GitHub: https://github.com/binhex/arch-soularr
- Official website: https://soularr.net
- Unraid: https://ca.unraid.net/apps/soularr-0fiuln90y5ebm9?q=soularr

## Common questions

### Does Soularr need an Slskd API key?

Yes, Soularr requires an API key from Slskd. It is added in the Slskd yml file under web, authentication, api_keys, my_api_key.

### How should the download directory be shared with Lidarr?

Lidarr must be able to see the Slskd download directory, and you may need to mount it if Lidarr is running in Docker. Set the same directory as download_dir under Lidarr in the Soularr config.

### What Docker mounts are typical for the Soularr container?

Mount the Slskd download directory to /downloads and the Soularr data/config directory to /data. Set the container user to your UID and GID.

### How are completed downloads imported into Lidarr?

As downloads complete in Slskd, the script automatically tells Lidarr to import the files.

### What should I check if Soularr fails to search, download, or import?

Check configuration problems, connection issues, search failures, download errors, and import problems. These are common troubleshooting areas for Soularr.

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