boomarr 1.0.0a1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,2 @@
1
+ github: EuleMitKeule
2
+ custom: paypal.me/lennardbeers
@@ -0,0 +1,103 @@
1
+ name: Publish
2
+
3
+ on:
4
+ workflow_dispatch:
5
+ release:
6
+ types:
7
+ - published
8
+
9
+ env:
10
+ PYTHON_VERSION: "3.14"
11
+
12
+ jobs:
13
+ version:
14
+ runs-on: ubuntu-latest
15
+ outputs:
16
+ version: ${{ steps.set_output.outputs.version }}
17
+ env:
18
+ VERSION: ""
19
+ steps:
20
+ - name: Get version from release
21
+ if: github.event_name == 'release'
22
+ run: |
23
+ echo "VERSION=${{ github.event.release.tag_name }}" >> $GITHUB_ENV
24
+
25
+ - name: Get release from API
26
+ if: github.event_name == 'workflow_dispatch'
27
+ id: release_api
28
+ uses: octokit/request-action@v3.0.0
29
+ with:
30
+ route: GET /repos/${{ github.repository }}/releases/latest
31
+ env:
32
+ GITHUB_TOKEN: ${{ secrets.PAT }}
33
+
34
+ - name: Parse API response
35
+ if: github.event_name == 'workflow_dispatch'
36
+ run: |
37
+ echo "VERSION=${{ fromJson(steps.release_api.outputs.data).tag_name }}" >> $GITHUB_ENV
38
+
39
+ - name: Log version
40
+ run: |
41
+ echo "Version: $VERSION"
42
+
43
+ - name: Fail if no version
44
+ run: |
45
+ if [[ -z "$VERSION" ]]; then
46
+ echo "Missing version"
47
+ exit 1
48
+ fi
49
+
50
+ - name: Set outputs
51
+ id: set_output
52
+ run: |
53
+ echo "version=$VERSION" >> $GITHUB_OUTPUT
54
+
55
+ package:
56
+ needs: version
57
+ runs-on: ubuntu-latest
58
+ environment:
59
+ name: pypi
60
+ url: https://pypi.org/p/boomarr
61
+ permissions:
62
+ id-token: write
63
+ steps:
64
+ - name: Checkout code
65
+ uses: actions/checkout@v6.0.2
66
+
67
+ - name: Set up Python
68
+ uses: actions/setup-python@v6.2.0
69
+ with:
70
+ python-version: ${{ env.PYTHON_VERSION }}
71
+
72
+ - name: Install uv
73
+ uses: astral-sh/setup-uv@v8.0.0
74
+ with:
75
+ python-version: ${{ env.PYTHON_VERSION }}
76
+ enable-cache: true
77
+ cache-suffix: uv-${{ runner.os }}-${{ env.PYTHON_VERSION }}
78
+
79
+ - name: Install dependecies
80
+ run: uv sync
81
+
82
+ - name: Set all versions
83
+ run: |
84
+ $version = "${{ needs.version.outputs.version }}"
85
+ Get-ChildItem -Recurse -File | ForEach-Object {
86
+ (Get-Content $_.FullName -Raw) -replace '0\.0\.0-dev', $version | Set-Content $_.FullName -NoNewline
87
+ }
88
+ shell: pwsh
89
+
90
+ - name: Build package
91
+ run: |
92
+ uv build
93
+
94
+ - name: Publish to PyPI
95
+ uses: pypa/gh-action-pypi-publish@v1.13.0
96
+
97
+ - name: Upload assets to release
98
+ env:
99
+ GITHUB_TOKEN: ${{ secrets.PAT }}
100
+ run: |
101
+ gh release upload "${{ needs.version.outputs.version }}" \
102
+ ./dist/boomarr-${{ needs.version.outputs.version }}.tar.gz \
103
+ ./dist/boomarr-${{ needs.version.outputs.version }}-py3-none-any.whl
@@ -0,0 +1,140 @@
1
+ name: Code Quality
2
+
3
+ on:
4
+ workflow_dispatch:
5
+ pull_request:
6
+ types:
7
+ - opened
8
+ - synchronize
9
+ - reopened
10
+ push:
11
+ branches:
12
+ - master
13
+ - develop
14
+
15
+ env:
16
+ PYTHON_VERSION: "3.14"
17
+ SONAR_PROJECT_KEY: EuleMitKeule_boomarr
18
+ SONAR_PROJECT_ORGANIZATION: eule
19
+
20
+ jobs:
21
+ cache:
22
+ runs-on: ubuntu-latest
23
+ steps:
24
+ - name: Checkout
25
+ uses: actions/checkout@v6.0.2
26
+
27
+ - name: Install uv
28
+ uses: astral-sh/setup-uv@v8.0.0
29
+ with:
30
+ python-version: ${{ env.PYTHON_VERSION }}
31
+ enable-cache: true
32
+ cache-suffix: uv-${{ runner.os }}-${{ env.PYTHON_VERSION }}
33
+
34
+ - name: Install dependecies
35
+ run: uv sync --all-groups
36
+
37
+ ruff:
38
+ needs: cache
39
+ runs-on: ubuntu-latest
40
+ steps:
41
+ - name: Checkout
42
+ uses: actions/checkout@v6.0.2
43
+
44
+ - name: Install uv
45
+ uses: astral-sh/setup-uv@v8.0.0
46
+ with:
47
+ python-version: ${{ env.PYTHON_VERSION }}
48
+ enable-cache: true
49
+ cache-suffix: uv-${{ runner.os }}-${{ env.PYTHON_VERSION }}
50
+
51
+ - name: Install dependecies
52
+ run: uv sync --all-groups
53
+
54
+ - name: Run ruff
55
+ run: |
56
+ uv run ruff check .
57
+
58
+ mypy:
59
+ needs: cache
60
+ runs-on: ubuntu-latest
61
+ steps:
62
+ - name: Checkout
63
+ uses: actions/checkout@v6.0.2
64
+
65
+ - name: Install uv
66
+ uses: astral-sh/setup-uv@v8.0.0
67
+ with:
68
+ python-version: ${{ env.PYTHON_VERSION }}
69
+ enable-cache: true
70
+ cache-suffix: uv-${{ runner.os }}-${{ env.PYTHON_VERSION }}
71
+
72
+ - name: Install dependecies
73
+ run: uv sync --all-groups
74
+
75
+ - name: Run mypy
76
+ run: |
77
+ uv run mypy --strict .
78
+
79
+ tests:
80
+ needs: cache
81
+ runs-on: ubuntu-latest
82
+ steps:
83
+ - name: Checkout
84
+ uses: actions/checkout@v6.0.2
85
+
86
+ - name: Install uv
87
+ uses: astral-sh/setup-uv@v8.0.0
88
+ with:
89
+ python-version: ${{ env.PYTHON_VERSION }}
90
+ enable-cache: true
91
+ cache-suffix: uv-${{ runner.os }}-${{ env.PYTHON_VERSION }}
92
+
93
+ - name: Install dependecies
94
+ run: uv sync --all-groups
95
+
96
+ - name: Run tests
97
+ run: |
98
+ uv run pytest --cov=. --cov-report=term tests
99
+
100
+ sonar:
101
+ needs: cache
102
+ runs-on: ubuntu-latest
103
+ steps:
104
+ - name: Checkout
105
+ uses: actions/checkout@v6.0.2
106
+ with:
107
+ fetch-depth: 0
108
+
109
+ - name: Install uv
110
+ uses: astral-sh/setup-uv@v8.0.0
111
+ with:
112
+ python-version: ${{ env.PYTHON_VERSION }}
113
+ enable-cache: true
114
+ cache-suffix: uv-${{ runner.os }}-${{ env.PYTHON_VERSION }}
115
+
116
+ - name: Install dependencies
117
+ run: uv sync --all-groups
118
+
119
+ - name: Run tests
120
+ run: |
121
+ uv run pytest --cov=. --cov-report=xml --cov-report=term tests
122
+
123
+ - name: fix code coverage paths
124
+ run: |
125
+ sed -i 's|/home/runner/work/boomarr/boomarr|/github/workspace|g' coverage.xml
126
+
127
+ - name: Run SonarCloud analysis
128
+ uses: SonarSource/sonarqube-scan-action@v7.1.0
129
+ env:
130
+ GITHUB_TOKEN: ${{ secrets.PAT }}
131
+ SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
132
+ with:
133
+ args: >
134
+ -Dsonar.organization=${{ env.SONAR_PROJECT_ORGANIZATION }}
135
+ -Dsonar.projectKey=${{ env.SONAR_PROJECT_KEY }}
136
+ -Dsonar.python.coverage.reportPaths=coverage.xml
137
+ -Dsonar.sources=boomarr
138
+ -Dsonar.tests=tests
139
+ -Dsonar.python.version=${{ env.PYTHON_VERSION }}
140
+ -Dsonar.text.inclusions=**/*.py
@@ -0,0 +1,23 @@
1
+ name: Release
2
+
3
+ on:
4
+ workflow_dispatch:
5
+
6
+ jobs:
7
+ release:
8
+ runs-on: ubuntu-latest
9
+ concurrency: release
10
+ permissions:
11
+ contents: write
12
+ steps:
13
+ - name: Checkout code
14
+ uses: actions/checkout@v6.0.2
15
+ with:
16
+ fetch-depth: 0
17
+ persist-credentials: false
18
+
19
+ - name: Semantic Release
20
+ id: semantic
21
+ uses: cycjimmy/semantic-release-action@v6.0.0
22
+ env:
23
+ GITHUB_TOKEN: ${{ secrets.PAT }}
@@ -0,0 +1,209 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[codz]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ build/
12
+ develop-eggs/
13
+ dist/
14
+ downloads/
15
+ eggs/
16
+ .eggs/
17
+ lib/
18
+ lib64/
19
+ parts/
20
+ sdist/
21
+ var/
22
+ wheels/
23
+ share/python-wheels/
24
+ *.egg-info/
25
+ .installed.cfg
26
+ *.egg
27
+ MANIFEST
28
+
29
+ # PyInstaller
30
+ # Usually these files are written by a python script from a template
31
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
32
+ *.manifest
33
+ *.spec
34
+
35
+ # Installer logs
36
+ pip-log.txt
37
+ pip-delete-this-directory.txt
38
+
39
+ # Unit test / coverage reports
40
+ htmlcov/
41
+ .tox/
42
+ .nox/
43
+ .coverage
44
+ .coverage.*
45
+ .cache
46
+ nosetests.xml
47
+ coverage.xml
48
+ *.cover
49
+ *.py.cover
50
+ .hypothesis/
51
+ .pytest_cache/
52
+ cover/
53
+
54
+ # Translations
55
+ *.mo
56
+ *.pot
57
+
58
+ # Django stuff:
59
+ *.log
60
+ local_settings.py
61
+ db.sqlite3
62
+ db.sqlite3-journal
63
+
64
+ # Flask stuff:
65
+ instance/
66
+ .webassets-cache
67
+
68
+ # Scrapy stuff:
69
+ .scrapy
70
+
71
+ # Sphinx documentation
72
+ docs/_build/
73
+
74
+ # PyBuilder
75
+ .pybuilder/
76
+ target/
77
+
78
+ # Jupyter Notebook
79
+ .ipynb_checkpoints
80
+
81
+ # IPython
82
+ profile_default/
83
+ ipython_config.py
84
+
85
+ # pyenv
86
+ # For a library or package, you might want to ignore these files since the code is
87
+ # intended to run in multiple environments; otherwise, check them in:
88
+ # .python-version
89
+
90
+ # pipenv
91
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
92
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
93
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
94
+ # install all needed dependencies.
95
+ #Pipfile.lock
96
+
97
+ # UV
98
+ # Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
99
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
100
+ # commonly ignored for libraries.
101
+ #uv.lock
102
+
103
+ # poetry
104
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
105
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
106
+ # commonly ignored for libraries.
107
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
108
+ #poetry.lock
109
+ #poetry.toml
110
+
111
+ # pdm
112
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
113
+ # pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
114
+ # https://pdm-project.org/en/latest/usage/project/#working-with-version-control
115
+ #pdm.lock
116
+ #pdm.toml
117
+ .pdm-python
118
+ .pdm-build/
119
+
120
+ # pixi
121
+ # Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
122
+ #pixi.lock
123
+ # Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
124
+ # in the .venv directory. It is recommended not to include this directory in version control.
125
+ .pixi
126
+
127
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
128
+ __pypackages__/
129
+
130
+ # Celery stuff
131
+ celerybeat-schedule
132
+ celerybeat.pid
133
+
134
+ # SageMath parsed files
135
+ *.sage.py
136
+
137
+ # Environments
138
+ .env
139
+ .envrc
140
+ .venv
141
+ env/
142
+ venv/
143
+ ENV/
144
+ env.bak/
145
+ venv.bak/
146
+
147
+ # Spyder project settings
148
+ .spyderproject
149
+ .spyproject
150
+
151
+ # Rope project settings
152
+ .ropeproject
153
+
154
+ # mkdocs documentation
155
+ /site
156
+
157
+ # mypy
158
+ .mypy_cache/
159
+ .dmypy.json
160
+ dmypy.json
161
+
162
+ # Pyre type checker
163
+ .pyre/
164
+
165
+ # pytype static type analyzer
166
+ .pytype/
167
+
168
+ # Cython debug symbols
169
+ cython_debug/
170
+
171
+ # PyCharm
172
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
173
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
174
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
175
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
176
+ #.idea/
177
+
178
+ # Abstra
179
+ # Abstra is an AI-powered process automation framework.
180
+ # Ignore directories containing user credentials, local state, and settings.
181
+ # Learn more at https://abstra.io/docs
182
+ .abstra/
183
+
184
+ # Visual Studio Code
185
+ # Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
186
+ # that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
187
+ # and can be added to the global gitignore or merged into this file. However, if you prefer,
188
+ # you could uncomment the following to ignore the entire vscode folder
189
+ # .vscode/
190
+
191
+ # Ruff stuff:
192
+ .ruff_cache/
193
+
194
+ # PyPI configuration file
195
+ .pypirc
196
+
197
+ # Cursor
198
+ # Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
199
+ # exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
200
+ # refer to https://docs.cursor.com/context/ignore-files
201
+ .cursorignore
202
+ .cursorindexingignore
203
+
204
+ # Marimo
205
+ marimo/_static/
206
+ marimo/_lsp/
207
+ __marimo__/
208
+
209
+ config/
@@ -0,0 +1 @@
1
+ 3.14
@@ -0,0 +1,12 @@
1
+ {
2
+ "repository_url": "https://github.com/eulemitkeule/boomarr.git",
3
+ "branches": [
4
+ "master"
5
+ ],
6
+ "plugins": [
7
+ "@semantic-release/commit-analyzer",
8
+ "@semantic-release/release-notes-generator",
9
+ "@semantic-release/github"
10
+ ],
11
+ "tagFormat": "${version}"
12
+ }
@@ -0,0 +1,4 @@
1
+ {
2
+ "python.testing.unittestEnabled": false,
3
+ "python.testing.pytestEnabled": true,
4
+ }
@@ -0,0 +1,21 @@
1
+ # MIT License
2
+
3
+ Copyright (c) 2026 Lennard Beers
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,58 @@
1
+ Metadata-Version: 2.4
2
+ Name: boomarr
3
+ Version: 1.0.0a1
4
+ Summary: 🔊 Symlink-based audio language filter for Plex & Jellyfin - automatically mirrors your media library, keeping only files with your desired audio tracks.
5
+ Author-email: Lennard Beers <l.beers@outlook.de>
6
+ Maintainer-email: Lennard Beers <l.beers@outlook.de>
7
+ License: # MIT License
8
+
9
+ Copyright (c) 2026 Lennard Beers
10
+
11
+ Permission is hereby granted, free of charge, to any person obtaining a copy
12
+ of this software and associated documentation files (the "Software"), to deal
13
+ in the Software without restriction, including without limitation the rights
14
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
15
+ copies of the Software, and to permit persons to whom the Software is
16
+ furnished to do so, subject to the following conditions:
17
+
18
+ The above copyright notice and this permission notice shall be included in all
19
+ copies or substantial portions of the Software.
20
+
21
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
24
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
26
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
27
+ SOFTWARE.
28
+ License-File: LICENSE.md
29
+ Requires-Python: >=3.14
30
+ Requires-Dist: pydantic>=2.12.5
31
+ Requires-Dist: python-dotenv>=1.2.2
32
+ Requires-Dist: pyyaml>=6.0.3
33
+ Requires-Dist: typer>=0.24.1
34
+ Description-Content-Type: text/markdown
35
+
36
+ # Boomarr
37
+
38
+ ![PyPI - Version](https://img.shields.io/pypi/v/boomarr?logo=python&logoColor=green&color=blue)
39
+ ![GitHub License](https://img.shields.io/github/license/eulemitkeule/boomarr)
40
+ ![GitHub Sponsors](https://img.shields.io/github/sponsors/eulemitkeule?logo=GitHub-Sponsors)
41
+
42
+ [![Code Quality](https://github.com/EuleMitKeule/boomarr/actions/workflows/quality.yml/badge.svg)](https://github.com/EuleMitKeule/boomarr/actions/workflows/quality.yml)
43
+ [![Publish](https://github.com/EuleMitKeule/boomarr/actions/workflows/publish.yml/badge.svg)](https://github.com/EuleMitKeule/boomarr/actions/workflows/publish.yml)
44
+ [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=coverage)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
45
+ [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=bugs)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
46
+ [![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
47
+ [![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
48
+ [![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
49
+
50
+ 🔊 Symlink-based audio language filter for Plex & Jellyfin — automatically mirrors your media library, keeping only files with your desired audio tracks.
51
+
52
+ ## What is this?
53
+
54
+ Boomarr scans your media library for files that contain specific audio language tracks (using ffprobe) and creates symlinks to those files in a separate output folder. That folder can then be used as a dedicated Plex or Jellyfin library — perfect for family members who only want to see content available in their native language.
55
+
56
+ ## Inspiration
57
+
58
+ This project is inspired by [Filip Rojek's blog post](https://www.filiprojek.cz/posts/jellyfin-language-specific-library/) on creating a language-specific Jellyfin library using a custom Bash script. Boomarr takes that idea further by building it into a fully configurable, Docker-native tool with Sonarr/Radarr integration, inotify-based change detection, and automatic stale symlink cleanup.
@@ -0,0 +1,23 @@
1
+ # Boomarr
2
+
3
+ ![PyPI - Version](https://img.shields.io/pypi/v/boomarr?logo=python&logoColor=green&color=blue)
4
+ ![GitHub License](https://img.shields.io/github/license/eulemitkeule/boomarr)
5
+ ![GitHub Sponsors](https://img.shields.io/github/sponsors/eulemitkeule?logo=GitHub-Sponsors)
6
+
7
+ [![Code Quality](https://github.com/EuleMitKeule/boomarr/actions/workflows/quality.yml/badge.svg)](https://github.com/EuleMitKeule/boomarr/actions/workflows/quality.yml)
8
+ [![Publish](https://github.com/EuleMitKeule/boomarr/actions/workflows/publish.yml/badge.svg)](https://github.com/EuleMitKeule/boomarr/actions/workflows/publish.yml)
9
+ [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=coverage)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
10
+ [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=bugs)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
11
+ [![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
12
+ [![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
13
+ [![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=EuleMitKeule_boomarr&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=EuleMitKeule_boomarr)
14
+
15
+ 🔊 Symlink-based audio language filter for Plex & Jellyfin — automatically mirrors your media library, keeping only files with your desired audio tracks.
16
+
17
+ ## What is this?
18
+
19
+ Boomarr scans your media library for files that contain specific audio language tracks (using ffprobe) and creates symlinks to those files in a separate output folder. That folder can then be used as a dedicated Plex or Jellyfin library — perfect for family members who only want to see content available in their native language.
20
+
21
+ ## Inspiration
22
+
23
+ This project is inspired by [Filip Rojek's blog post](https://www.filiprojek.cz/posts/jellyfin-language-specific-library/) on creating a language-specific Jellyfin library using a custom Bash script. Boomarr takes that idea further by building it into a fully configurable, Docker-native tool with Sonarr/Radarr integration, inotify-based change detection, and automatic stale symlink cleanup.
@@ -0,0 +1,10 @@
1
+ """Boomarr: Symlink-based audio language filter for Plex & Jellyfin.
2
+
3
+ Automatically mirrors your media library, keeping only files with your desired
4
+ audio tracks. Uses intelligent symlink creation to maintain library structure
5
+ while filtering media by audio language preferences.
6
+ """
7
+
8
+ from boomarr.const import VERSION
9
+
10
+ __version__ = VERSION