集成 Slskd 和 Beets 的自动化音乐下载器和管理器。
Soulbeet is a self-hosted music downloader, library manager, and discovery engine. Search for music, download it, and let the app handle everything else: finding the best source, tagging, organizing, and keeping your library clean. Connect your scrobble history and Soulbeet will find new music for you automatically.
Screenshots: here
You search, you click download. Behind the scenes:
The recommended way to run Soulbeet is via Docker Compose. This ensures all dependencies (like beets and python) are correctly set up.
Compatibility: The Docker image supports both AMD64 and ARM64 architectures.
docker-compose.yml file:…Important: The /downloads volume must match between slskd and soulbeet so Soulbeet can see the files slskd downloaded. The /music volume must match between soulbeet and navidrome so Navidrome can see the organized library. Soulbeet requires slskd 0.26 or newer (downloads are enqueued through the batches API introduced in 0.26).
Run:
docker-compose up -dhttp://localhost:9765 and log in with your Navidrome credentials./music).For discovery (optional): add your Last.fm API key and/or ListenBrainz token in Settings > Library, enable discovery on a folder, pick your profiles, and hit Generate.
| Variable | Description | Default |
|---|---|---|
DATABASE_URL |
Connection string for SQLite | sqlite:soulbeet.db |
DOWNLOAD_PATH |
Path where slskd saves downloads | /downloads |
SECRET_KEY |
Encryption key for tokens and credentials | |
NAVIDROME_URL |
Your Navidrome server URL | |
BEETS_CONFIG |
Path to custom beets config file | beets_config.yaml |
BEETS_ALBUM_MODE |
Enable album import mode (see below) | false |
Note: slskd URL and API key are configured through the web UI (Settings > Config) and stored in the database. Scrobble credentials (Last.fm API key, ListenBrainz token) are configured per-user in Settings > Library.
Soulbeet uses beets to import music. You can mount a custom config.yaml to /config/config.yaml (or wherever you point BEETS_CONFIG to) to customize how beets behaves (plugins, naming formats, etc.).
Default beet import flags used:
-q: Quiet mode (no user interaction)-s: Singleton mode (Default behavior unless BEETS_ALBUM_MODE is set)-l [library_path]: Library database path (per-folder)-d [target_path]: Import to the specific folder selected in the web UI.Soulbeet ships three image tiers: :light (default, MusicBrainz tagging only), :medium (adds AcoustID fingerprint matching via the chroma plugin), and :full (adds cover art, lyrics, ReplayGain, and more). :latest is an alias for :light so existing installs keep their current behavior. See docs/beets-plugins.md for what each tier ships, how to switch, and how to drop in your own plugins.
Important: Each music folder you configure in Soulbeet has its own beets database (.beets_library.db) stored at the root of that folder. This enables:
Each user can have multiple libraries. Each library is a folder that contains music files and a .beets_library.db file. This database is used to avoid duplicate tracks within the same library.
Since we use different databases, we can't directly compare tracks across libraries. However, we can use the beets CLI to interact with each library individually. This way you can add tracks outside of Soulbeet but keep them in sync with your library.
To manually interact with a library (list tracks, modify tags, remove items, etc.), use the beet CLI with the -l flag pointing to the folder's database:
# List all tracks in a library
beet -l /music/Person1/.beets_library.db lsIf using Docker, run these commands inside the container:
docker exec -it beet -l /music/Person1/.beets_library.db lsFor more beets commands, see the beets documentation.
BEETS_ALBUM_MODE)By setting BEETS_ALBUM_MODE=true, Soulbeet will attempt to group downloaded files by their parent directory and import them as an album instead of singletons.
This flag is only needed when you want album tags on your tracks. E.g: albumartist mb_albumid and so on..
Important for Album Mode:
Since beets is run in quiet mode (-q), it will skip any imports that require user intervention (e.g., if the metadata doesn't match confidently). To ensure partial albums or less popular releases are imported correctly, you must configure your beets_config.yaml to be more permissive.
Recommended additions to your beets_config.yaml for Album Mode:
import:
# quiet_fallback: asis # Optional: If no strong match, import with existing tags instead of skipping
timid: no
match:
strong_rec_thresh: 0.10 # Lower threshold to accept less confident matches
max_rec:
missing_tracks: strong
unmatched_tracks: strong
distance_weights:
missing_tracks: 0.1 # Reduce weight (I think default is 0.9) to penalize less for missing tracks, improving the overall score.
# unmatched_tracks: 0.2 # Optional: Similar for extra tracks.Note: Tweaking strong_rec_thresh and other matching parameters increases the risk of incorrect tags, but is necessary for fully automated imports of obscure or partial albums.
Discovery generates personalized playlists from your scrobble history and pushes them to Navidrome. Here's how to set it up.
Enable ReportRealPath for the Soulbeet player. Go to your Navidrome instance > Settings > Players (e.g. https://your-navidrome/app/#/player), find the Soulbeet player entry, and enable "Report Real Path". Without this, rating sync and auto-delete cannot resolve file paths.
Your Soulbeet folder paths must point to the same physical directories that Navidrome's music library uses. The mount paths inside each container can differ (e.g. Soulbeet at /music, Navidrome at /media/music), as long as they map to the same files on the host.
Discovery/ directory inside your chosen folder, with subdirectories per profile (e.g., Discovery/Balanced/, Discovery/Adventurous/).When enabled (Settings > Library > Auto-delete), 1-star tracks are deleted from disk during rating sync. This requires ReportRealPath to be enabled in Navidrome so Soulbeet receives the actual file path. For shared folders (multiple users), a track is only deleted if the average rating across all users is 1 or below.
dioxus_cli../css.shdx serve --platform web暂无开放 Issues,或尚未同步最近议题。