Binhex Soularr
Soularr is a Python application that automates music downloads from Soulseek for Lidarr.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
44/100 Fair
- Maintained
- 72last commit 9 days ago
- Popular
- 61 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 32 days ago
- GitHub stars
- 1
- Open issues
- 0
- Last commit
- 2026-11-12
- Latest release
- 233ff0a9d05b5d40ee0f62ec4c7928b28a9c8f48-05
- License
- GPL-3.0
- Activity
- rising
Checked 9 days ago - source: GitHub (binhex/arch-soularr)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Use an Artist/Album music folder Point Seakarr at a music library folder organized as Artist/Album/track files. If the folders do not match this layout, downloads and album organization can end up in the wrong places or fail to recognize what you already own. source
- Set and open the Soulseek incoming port In the Soulseek config, set listen_port to a real port number instead of 0, and open that port on your router if you want peers to reach you. Without an open incoming peer port, other people may not be able to share with you, causing slower searches or failed downloads. source
- Choose minimum audio quality filters Set min_bit_rate for lossy files and min_bit_depth for lossless files if you want to avoid low-quality matches; 0 turns each check off. Leaving them at 0 means Seakarr may accept poor-quality audio because no minimum quality is enforced. source
- Configure Lidarr and slskd Set LIDARR_HOST_URL and LIDARR_API_KEY, plus SLSKD_HOST_URL and SLSKD_API_KEY, so Soularr can query Lidarr for wanted albums and submit searches to the slskd Soulseek daemon. source
Fetched 39 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
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.
Answers sourced from deepwiki.com, selfhost.directory, soularr.net
Community
- Reddit (reddit)
- [Support] binhex - slskd - Page 2 - Docker Containers - Unraid (forum)
- [Support] binhex - Sonarr - Docker Containers - Unraid (forum)
- [Support] binhex - Sonarr - Page 49 - Docker Containers - Unraid (forum)
- Binhex Sonarr trouble : r/unRAID - Reddit (reddit)
Collected 53 days ago - public community threads