bt-dualboot-sync 0.1.0__tar.gz

bt_dualboot_sync-0.1.0/.dockerignore

@@ -0,0 +1 @@
+dist/

bt_dualboot_sync-0.1.0/.github/dependabot.yml

@@ -0,0 +1,23 @@
+version: 2
+updates:
+  # Python dependencies
+  - package-ecosystem: "uv"
+    directory: "/"
+    target-branch: "dev"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    groups:
+      python:
+        patterns: ["*"]
+
+  # GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    target-branch: "dev"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    groups:
+      actions:
+        patterns: ["*"]

bt_dualboot_sync-0.1.0/.github/workflows/build-dist.yml

@@ -0,0 +1,55 @@
+name: Build Release Distributions
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Check tag against project.version
+        if: github.event_name == 'release'
+        env:
+          TAG: ${{ github.event.release.tag_name }}
+        run: |
+          set -euo pipefail
+          VERSION="$(python3 -c 'import pathlib, tomllib; print(tomllib.loads(pathlib.Path("pyproject.toml").read_text())["project"]["version"])')"
+          if [ "$TAG" != "v${VERSION}" ]; then
+            echo "::error::release tag '$TAG' does not match project.version '$VERSION' in pyproject.toml"
+            exit 1
+          fi
+
+  build:
+    needs: [verify]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.11"
+
+      - name: Build sdist and wheel
+        run: uv build --out-dir dist
+
+      - name: Check distribution metadata
+        run: uvx twine check dist/*
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/*
+
+      - name: Attach distributions to the GitHub Release
+        if: github.event_name == 'release'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release upload "${{ github.event.release.tag_name }}" dist/* --clobber --repo "${{ github.repository }}"

bt_dualboot_sync-0.1.0/.github/workflows/linter.yml

@@ -0,0 +1,88 @@
+name: Lint & Test
+
+on:
+  push:
+    branches: [dev]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.11"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Install dev dependencies
+        run: uv sync --group dev
+
+      - name: ruff (lint)
+        run: uv run -- ruff check --output-format github bt_dualboot/
+
+      - name: ruff (format)
+        run: uv run -- ruff format --check --diff bt_dualboot/
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.11", "3.12", "3.13"]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python }}
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Install chntpw
+        run: sudo apt-get update && sudo apt-get install -y --no-install-recommends chntpw
+
+      - name: pytest
+        run: uv run --python ${{ matrix.python }} -- pytest tests/
+
+  changelog:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Verify CHANGELOG.md
+        run: uvx --from python-kacl==0.7.3 kacl-cli verify
+
+      - name: Require changelog notes if this PR bumps the version
+        if: github.event_name == 'pull_request'
+        run: |
+          set -euo pipefail
+          git fetch origin main
+          BASE_VERSION="$(git show origin/main:pyproject.toml | python3 -c 'import sys, tomllib; print(tomllib.load(sys.stdin.buffer)["project"]["version"])')"
+          HEAD_VERSION="$(python3 -c 'import pathlib, tomllib; print(tomllib.loads(pathlib.Path("pyproject.toml").read_text())["project"]["version"])')"
+          if [ "$BASE_VERSION" = "$HEAD_VERSION" ]; then
+            echo "Version unchanged ($HEAD_VERSION); this PR won't trigger a release."
+            exit 0
+          fi
+          echo "Version bumped $BASE_VERSION -> $HEAD_VERSION; checking for release notes..."
+          # kacl-cli's 'get' errors out (rather than printing nothing) when the
+          # section has no subsections at all, so treat any failure as "empty".
+          if ! NOTES="$(uvx --from python-kacl==0.7.3 kacl-cli get unreleased --no-header 2>/dev/null)" || [ -z "$NOTES" ]; then
+            echo "::error::pyproject.toml is bumped to ${HEAD_VERSION}, but CHANGELOG.md has no content under '## [Unreleased]'. Merging as-is will bump the version with an empty changelog and fail release.yml after merge. Add release notes under '## [Unreleased]' first."
+            exit 1
+          fi
+          echo "Notes found under [Unreleased]."

bt_dualboot_sync-0.1.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  workflow_run:
+    workflows: ["Build Release Distributions"]
+    types: [completed]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    # Only for successful runs triggered by a published release.
+    if: >
+      github.event.workflow_run.conclusion == 'success' &&
+      github.event.workflow_run.event == 'release'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v8
+        with:
+          run-id: ${{ github.event.workflow_run.id }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          path: dist
+          pattern: dist
+          merge-multiple: true
+
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist

bt_dualboot_sync-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,157 @@
+name: Release
+
+# Fires automatically whenever a merge to main bumps pyproject.toml's version:
+#
+#   read VERSION from pyproject.toml -> promote CHANGELOG.md's [Unreleased] section
+#   -> sync bt_dualboot/__meta__.py -> commit + tag on main -> DRAFT the release
+#   -> sync the promotion back onto dev
+
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'pyproject.toml'
+
+permissions:
+  contents: write
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: main
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Read the version from pyproject.toml
+        id: version
+        run: |
+          set -euo pipefail
+          VERSION="$(python3 -c 'import pathlib, tomllib; print(tomllib.loads(pathlib.Path("pyproject.toml").read_text())["project"]["version"])')"
+          case "$VERSION" in
+            [0-9]*) ;;
+            *) echo "::error::Version '$VERSION' in pyproject.toml must start with a digit."; exit 1 ;;
+          esac
+          {
+            echo "version=$VERSION"
+            echo "tag=v$VERSION"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Skip if this version is already released
+        id: gate
+        env:
+          TAG: ${{ steps.version.outputs.tag }}
+        run: |
+          set -euo pipefail
+          if git rev-parse -q --verify "refs/tags/${TAG}" >/dev/null; then
+            echo "::notice::${TAG} is already tagged - this push didn't bump the version (or it shipped already). Nothing to do."
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "skip=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Require notes under [Unreleased]
+        if: steps.gate.outputs.skip != 'true'
+        run: |
+          set -euo pipefail
+          # kacl-cli's 'get' errors out (rather than printing nothing) when the
+          # section has no subsections at all, so treat any failure as "empty".
+          if ! NOTES="$(uvx --from python-kacl==0.7.3 kacl-cli get unreleased --no-header 2>/dev/null)" || [ -z "$NOTES" ]; then
+            echo "::error::pyproject.toml was bumped to ${{ steps.version.outputs.version }}, but CHANGELOG.md has no content under '## [Unreleased]'. Add the release notes, then push a follow-up commit to main."
+            exit 1
+          fi
+          echo "Notes found under [Unreleased]:"
+          echo "$NOTES"
+
+      - name: Promote [Unreleased] to [${{ steps.version.outputs.version }}] in CHANGELOG.md
+        if: steps.gate.outputs.skip != 'true'
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+        run: uvx --from python-kacl==0.7.3 kacl-cli release "$VERSION" --modify --auto-link
+
+      - name: Sync bt_dualboot/__meta__.py with pyproject.toml
+        if: steps.gate.outputs.skip != 'true'
+        run: python3 dev/pre-release/update-version
+
+      - name: Commit and tag
+        if: steps.gate.outputs.skip != 'true'
+        id: commit
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+          TAG: ${{ steps.version.outputs.tag }}
+        run: |
+          set -euo pipefail
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          # Not pyproject.toml: it is already correct from the merge that triggered
+          # this run, and this push must not touch it, or the path filter above would
+          # re-trigger this workflow on the commit below.
+          git add CHANGELOG.md bt_dualboot/__meta__.py
+          if git diff --cached --quiet; then
+            echo "::error::Nothing changed; is CHANGELOG.md already at ${VERSION}?"
+            exit 1
+          fi
+          git commit -m "docs(changelog): promote to ${TAG}"
+          git push origin HEAD:main
+          git tag -a "$TAG" -m "bt-dualboot-sync ${VERSION}"
+          git push origin "refs/tags/${TAG}"
+          echo "sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
+
+      - name: Draft the release from CHANGELOG.md
+        if: steps.gate.outputs.skip != 'true'
+        env:
+          GH_TOKEN: ${{ github.token }}
+          VERSION: ${{ steps.version.outputs.version }}
+          TAG: ${{ steps.version.outputs.tag }}
+        run: |
+          set -euo pipefail
+          uvx --from python-kacl==0.7.3 kacl-cli get "$VERSION" --no-header > /tmp/notes.md
+          gh release create "$TAG" \
+            --draft \
+            --title "$TAG" \
+            --notes-file /tmp/notes.md \
+            --target "${{ steps.commit.outputs.sha }}"
+          url="$(gh release view "$TAG" --json url --jq .url)"
+          {
+            echo "### Draft release \`${TAG}\` is ready"
+          } >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Sync the release commit back to dev
+        if: steps.gate.outputs.skip != 'true'
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ steps.version.outputs.tag }}
+        run: |
+          set -euo pipefail
+          git fetch origin dev:refs/remotes/origin/dev
+          BRANCH="sync-main-${TAG}"
+          git checkout -b "$BRANCH" origin/dev
+          git merge --no-edit origin/main
+
+          if [ "$(git rev-parse HEAD)" = "$(git rev-parse origin/dev)" ]; then
+            echo "dev is already up to date with main; nothing to sync."
+            exit 0
+          fi
+
+          git push --set-upstream origin "$BRANCH"
+
+          gh label create "release changelog" --description "Pull requests with a release changelog update" --force || true
+          gh pr create \
+            --title "Sync ${TAG} back to dev" \
+            --body "Merges the \`${TAG}\` version bump and changelog promotion from \`main\` back into \`dev\`, so \`dev\` picks up a fresh \`[Unreleased]\` section." \
+            --label "release changelog" \
+            --base dev \
+            --head "$BRANCH"

bt_dualboot_sync-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+# Python
+__pycache__
+dist/
+.venv/
+
+# OS files
+.DS_Store
+
+# IDE files
+.vscode/
+.idea/

bt_dualboot_sync-0.1.0/.kacl.yml

@@ -0,0 +1,13 @@
+kacl:
+  file: CHANGELOG.md
+
+  links:
+    auto_generate: True
+    host_url: https://github.com/vhrabar/bt-dualboot
+    compare_versions_template: '{host}/compare/v{previous_version}...v{version}'
+    unreleased_changes_template: '{host}/compare/v{latest_version}...HEAD'
+    initial_version_template: '{host}/releases/tag/v{version}'
+
+  git:
+    commit: False
+    tag: False

bt_dualboot_sync-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11.15

bt_dualboot_sync-0.1.0/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-09-12
+
+### Added
+
+- The first release of this fork of [x2es/bt-dualboot](https://github.com/x2es/bt-dualboot): it carries the community fixes that were merged upstream but never published, and modernises packaging, tooling and CI around `uv` package manager.
+- Published to PyPI as `bt-dualboot-sync` (the command is still `bt-dualboot`).
+- Bluetooth 5.1 / LE device support: LTK, ERand and EDIV keys are read from the Linux `info` file and written to `ControlSet001\Services\BTHPORT\Parameters\Keys` in the Windows registry. Contributed by [@Simon128](https://github.com/Simon128); never released upstream.
+- `--list` reports a *Missing pairing key* group for devices that have no key to sync, instead of leaving them unexplained. Contributed by [@asarium](https://github.com/asarium) in [#1](https://github.com/vhrabar/bt-dualboot/pull/1); never released upstream.
+- `dev/start-windows-vm`, which boots the installed Windows partition in a QEMU VM with the Bluetooth adapter passed through, so a sync can be verified without rebooting. Autodetects the Windows disk and the Bluetooth USB device, with manual overrides.
+
+### Changed
+
+- Requires Python 3.11 or newer; tested against 3.11, 3.12 and 3.13.
+- Packaging moved from Poetry to `uv` with the `hatchling` build backend; `uv.lock` replaces `poetry.lock`.
+- Docker images and the `dev/` scripts install and run the project through `uv`.
+
+### Fixed
+
+- No longer crashes on devices without a `LinkKey` in the Windows registry. Contributed by [@asarium](https://github.com/asarium) in [#1](https://github.com/vhrabar/bt-dualboot/pull/1); never released upstream.
+- `[General]/Class=` in `/var/lib/bluetooth/ADAPTER_MAC/DEVICE_MAC/info` is treated as optional, instead of failing when it is absent. Fixed upstream by [@x2es](https://github.com/x2es) in [x2es/bt-dualboot#4](https://github.com/x2es/bt-dualboot/pull/4); never released.
+- The "paired for multiple BT-adapters" warnings print the device MACs again; they were literal text because of a missing f-string prefix. Fixed upstream by [@J3RN](https://github.com/J3RN) in [x2es/bt-dualboot#9](https://github.com/x2es/bt-dualboot/pull/9); never released.
+- `raise ... from err` on the device-not-found path, so the underlying error is no longer reported as an unexpected exception during handling.
+
+[Unreleased]: https://github.com/vhrabar/bt-dualboot/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/vhrabar/bt-dualboot/releases/tag/v0.1.0

bt_dualboot_sync-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2022 Konstantin Ivanov
+Copyright (c) 2026 Vedran Hrabar
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bt_dualboot_sync-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.5
+Name: bt-dualboot-sync
+Version: 0.1.0
+Summary: Sync Bluetooth for dualboot Linux and Windows
+Project-URL: Homepage, https://github.com/vhrabar/bt-dualboot
+Project-URL: Repository, https://github.com/vhrabar/bt-dualboot
+Project-URL: Documentation, https://github.com/vhrabar/bt-dualboot/wiki
+Project-URL: Issues, https://github.com/vhrabar/bt-dualboot/issues
+Project-URL: Changelog, https://github.com/vhrabar/bt-dualboot/blob/main/CHANGELOG.md
+Author-email: Vedran Hrabar <vedran.hrabar@outlook.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bluetooth,dualboot,keys,pairing,sync
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Home Automation
+Classifier: Topic :: Multimedia
+Classifier: Topic :: System
+Classifier: Topic :: System :: Operating System
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+Sync Bluetooth for dualboot Linux and Windows
+=============================================
+
+User-friendly CLI that makes your Bluetooth devices work in both Windows and
+Linux without the re-pairing chore. It copies the pairing keys from Linux into
+the Windows registry, so you don't have to reboot back and forth.
+
+* doesn't require rebooting multiple times
+* discovers the mounted Windows partition automatically
+* safe, size-preserving Windows Registry update via `chntpw/reged`
+* backs up the Windows Registry before writing
+* `--dry-run` to preview any command
+
+## Requirements
+
+* [uv](https://docs.astral.sh/uv/)
+* `chntpw` (`sudo apt install chntpw` on Ubuntu/Mint)
+
+## Quick start
+
+Pair your devices on Windows, boot to Linux, pair them there too, then:
+
+```console
+# mount the Windows partition read-write, then:
+$ sudo uvx --from bt-dualboot-sync bt-dualboot --sync-all
+```
+
+List devices and sync a single one:
+
+```console
+$ sudo uvx --from bt-dualboot-sync bt-dualboot -l
+$ sudo uvx --from bt-dualboot-sync bt-dualboot --sync C2:9E:1D:E2:3D:A5
+```
+
+For a persistent command: `uv tool install bt-dualboot-sync`
+
+## Documentation
+
+Full usage, troubleshooting, advanced options and CLI reference:
+https://github.com/vhrabar/bt-dualboot
+
+## License
+
+Released under the MIT License. See [`LICENSE`](https://github.com/vhrabar/bt-dualboot/blob/main/LICENSE).
+
+Fork of [x2es/bt-dualboot](https://github.com/x2es/bt-dualboot) by Konstantin Ivanov.
+
+Copyright © 2022 Konstantin Ivanov
+Copyright © 2026 Vedran Hrabar