π§ Brainarr v1.6.1 - AI-Powered Music Discovery
Thank you for using Brainarr! This release brings you the latest improvements to our AI-powered music recommendation engine.
π What's New
\n## β Compatibility\n\nRequires Lidarr (unknown)+ on the plugins/nightly branch. CI validates against ghcr.io/hotio/lidarr:pr-plugins-3.1.2.4913.\n
π Highlights
π§ Improvements
- refactor(ci): use Common's reusable notify-failure workflow (#581)
- refactor(ci): use Common's reusable CodeQL workflow (#580)
π Bug Fixes
- fix(test): make HttpResponseFactory shim self-contained (unbreak build)
- fix(schema): allow license/tags/targetFramework/rootNamespace in plugin.schema.json
- fix: invariant casing in genre-overview matching (Turkish-I locale bug)
- fix(memory): cap ValidationMetrics history on the batch path
- fix: harden recommendation pipeline against untrusted LLM data (defect hunt) (#583)
π Installation
Easy Installation (Recommended)
- Open Lidarr Web Interface
- Go to Settings β General β Updates
- Set Branch to
nightly(plugins branch required) - Go to Settings β Plugins
- Click Add Plugin
- Enter GitHub URL:
https://github.com/RicherTunes/Brainarr - Click Install
- Restart Lidarr when prompted
- Navigate to Settings β Import Lists β Add New β Brainarr
Manual Installation
- Download
Brainarr-$VERSION.zipfrom assets below - Extract to your Lidarr plugins directory:
- Windows:
C:\ProgramData\Lidarr\plugins\Brainarr\ - Linux:
/var/lib/lidarr/plugins/Brainarr/ - Docker:
/config/plugins/Brainarr/
- Windows:
- Restart Lidarr
- Configure in Settings β Import Lists
π€ Supported AI Providers
π Privacy-First (Local)
- Ollama - 100% local, no data leaves your network
- LM Studio - Local with GUI interface
π° Budget-Friendly
- DeepSeek - 10-20x cheaper than GPT-4
- Google Gemini - Free tier available
- Groq - 10x faster inference
β Premium
- OpenAI - Industry-leading GPT-4o models
- Anthropic - Best reasoning with Claude 3.5/4 Sonnet
- OpenRouter - Access 200+ models with one API key
- Perplexity - Web-enhanced responses
π Verification
Verify your download integrity:
# Check SHA256 hash
sha256sum -c Brainarr-$VERSION.zip.sha256
# Expected file structure after extraction:
Brainarr/
βββ Lidarr.Plugin.Brainarr.dll # Main plugin
βββ plugin.json # Plugin manifest
βββ README.md # Documentation
βββ LICENSE # License file
βββ dependencies/ # NuGet packagesπ¬ Support
- Documentation: README.md
- Issues: GitHub Issues
- Discussions: GitHub Discussions
ποΈ For Developers
This release includes:
- β Comprehensive test suite (33+ test files)
- β Cross-platform CI/CD (Ubuntu/Windows/macOS)
- β Docker-based assembly extraction for reliable builds
- β Semantic versioning with automated releases
Full Changelog: $PREVIOUS_TAG...$VERSION
π€ This release was automated with Claude Code
π Release Statistics
- Commits: 24
- Files Changed: 37
- Contributors: 2