Soulsolid

Self hosted

Tue, 09 Sep 2025 21:10:44 +0200

Container Usage

The application can run without copying config.yaml into the container. If no config file exists, it will automatically create one with sensible defaults.

Paths

Tue, 09 Sep 2025 21:10:37 +0200

This document describes all available placeholders and functions for the Soulsolid path parser, which is used to organize music files into directories based on metadata.

Jobs

Tue, 09 Sep 2025 21:09:51 +0200

The jobs section configures how Soulsolid handles background tasks. These jobs are stored in runtime and their logs are persisted in files under a specified location. The default location for these logs is ./logs/jobs.

Analyze

Sun, 30 Nov 2025 00:00:00 +0000

The analyze feature aims to run an analysis of the metadata of your library and fill those missing gaps.

Analyze Jobs

At the moment, jobs for adding AcoustID and Lyrics are available. More analysis will be added in future releases of Soulsolid.

Configuration

Tue, 09 Sep 2025 21:10:30 +0200

The config.yaml file contains all application settings. Key sections:

telegram: Bot configuration and allowed users
library: Path to your music library
import: Import settings and file organization rules
metadata: Metadata provider settings (musicbrainz, deezer, discogs, acoustid)
server: Web server configuration
downloaders: External service configurations in the form of plugins. Supports both local .so files and automatic building from Git repositories.

Security Note: Never commit sensitive values like tokens or API keys to version control. Use environment variables instead.

Importing

Tue, 09 Sep 2025 21:10:30 +0200

The soulsolid application supports importing music from local directories. The import process handles metadata extraction, duplicate detection, file organization, and automatic artist/album creation.

Downloading

Tue, 09 Sep 2025 21:10:28 +0200

The soulsolid application downloads tracks via configurable plugins and writes metadata tags to the files through a multi-step process. Metadata is fetched from configured providers.

Screenshots

Fri, 03 Oct 2025 00:00:00 +0000

Here are some screenshots of the Soulsolid application interface.

Main dashboard interface

License

Sun, 05 Oct 2025 00:00:00 +0200

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

Privacy Policy

Sun, 05 Oct 2025 00:00:00 +0200