Binhex Soularr

Soularr is a Python application that automates music downloads from Soulseek for Lidarr.

  • Downloaders
  • Media Applications
  • Media Servers
  • Tools & Utilities
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
  • 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

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

Collected 53 days ago - public community threads