{"id":28244020,"url":"https://github.com/ololx/sbc-bitpool-expander","last_synced_at":"2025-09-10T21:42:58.467Z","repository":{"id":45297481,"uuid":"252661378","full_name":"ololx/sbc-bitpool-expander","owner":"ololx","description":"This is a simple tool for the sound quality improving of wireless headphones with the sbc codec on a mac.","archived":false,"fork":false,"pushed_at":"2023-05-17T07:57:59.000Z","size":8253,"stargazers_count":25,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-19T07:08:19.462Z","etag":null,"topics":["bit-pool","bitrate","bluetooth-audio","bluetooth-headphones","macos","macos-app","macos-application","macos-applications","macosx","maximum-bitpool","open-source","sbc","sbc-audio","sbc-codec","wireless-headphones"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ololx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-03T07:26:55.000Z","updated_at":"2025-05-07T15:35:02.000Z","dependencies_parsed_at":"2022-09-10T04:05:02.409Z","dependency_job_id":null,"html_url":"https://github.com/ololx/sbc-bitpool-expander","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Fsbc-bitpool-expander","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Fsbc-bitpool-expander/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Fsbc-bitpool-expander/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Fsbc-bitpool-expander/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ololx","download_url":"https://codeload.github.com/ololx/sbc-bitpool-expander/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Fsbc-bitpool-expander/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259066781,"owners_count":22800198,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bit-pool","bitrate","bluetooth-audio","bluetooth-headphones","macos","macos-app","macos-application","macos-applications","macosx","maximum-bitpool","open-source","sbc","sbc-audio","sbc-codec","wireless-headphones"],"created_at":"2025-05-19T07:08:17.701Z","updated_at":"2025-06-10T11:31:46.417Z","avatar_url":"https://github.com/ololx.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"right\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/downloads/ololx/sbc-bitpool-expander/total?style=social\" alt=\"downloads\"/\u003e\n\t\u003ca href=\"https://github.com/ololx/sbc-bitpool-expander/discussions\" target=\"_blank\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/github/discussions/ololx/sbc-bitpool-expander?label=welcome%20to%20discussions\u0026logo=github\u0026style=social\" alt=\"discutions\"/\u003e\n\t\u003c/a\u003e\n\u003c/div\u003e\n\n# sbc-bitpool-expander\n\nThis is a simple tool for the sound quality improving of wireless headphones with the sbc codec on a mac.\n\n[![tag](https://img.shields.io/github/v/tag/ololx/sbc-bitpool-expander?style=flat\u0026include_prereleases\u0026logo=github)](https://github.com/ololx/sbc-bitpool-expander/tags) [![release](https://img.shields.io/github/v/release/ololx/sbc-bitpool-expander?style=flat\u0026include_prereleases\u0026logo=github)](https://github.com/ololx/sbc-bitpool-expander/releases)\n\n[![osslifecycle](https://img.shields.io/osslifecycle/ololx/sbc-bitpool-expander?style=flat)](OSSMETADATA) [![last_commit](https://img.shields.io/github/last-commit/ololx/sbc-bitpool-expander?style=flat\u0026logo=github)](https://github.com/ololx/sbc-bitpool-expander/commits) [![release_date](https://img.shields.io/github/release-date/ololx/sbc-bitpool-expander?style=flat\u0026logo=github)](https://github.com/ololx/sbc-bitpool-expander/releases)\n\n[![licence](https://img.shields.io/github/license/ololx/sbc-bitpool-expander?style=flat)](LICENCE) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg?style=flat)](CODE_OF_CONDUCT.md) [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fololx%2Fsbc-bitpool-expander.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fololx%2Fsbc-bitpool-expander?ref=badge_shield)\n\n![repo_size](https://img.shields.io/github/repo-size/ololx/sbc-bitpool-expander?style=flat\u0026logo=github) ![languages_code_size](https://img.shields.io/github/languages/code-size/ololx/sbc-bitpool-expander?style=flat\u0026logo=github) ![languages_count](https://img.shields.io/github/languages/count/ololx/sbc-bitpool-expander?style=flat\u0026logo=github) ![languages_top](https://img.shields.io/github/languages/top/ololx/sbc-bitpool-expander?style=flat\u0026logo=github)\n\n![platform](https://img.shields.io/badge/platform-OS_X_10.11_|_OS_X_10.12_|_OS_X_10.13_|_OS_X_10.14-important?style=flat)\n\n## 📇 Table of Contents\n\n- [About](#about)\n- [Demo](#demo)\n- [Features](#feature)\n- [Getting Started](#getting-started)\n- [Built With](#built-with)\n- [Contributing](#contributing)\n- [Code of Conduct](#code-of-conduct)\n- [Versioning](#versioning)\n- [Authors](#authors)\n- [Licensing](#licensing)\n\n## 📖 About\n\nThe sbc-bitpool-expander is a mac automator program, which executes a shell command to change the SBC encoding bitpool values. This changes could up the bitrate value till 357 kbit/s for SBC audio.\n\n### Motivation\n\nThe SBC codec has many different parameters:\n\n- Channels count and type: Joint Stereo, Stereo, Dual Channel, Mono;\n- Frequency bands count: 4 or 8;\n- Package blocks count: 4, 8, 12, 16;\n- Quantization bit allocation algorithm: volume, SNR;\n- bit pools max-min value: in  usually it's from 2 to 53.\n\n***These parametters uses the bitpool value and affects the final audio quality.***\n\n*For instance, Dual Channel mode encodes channels separately, using the entire bitpool for each channel. The forcing device to use Dual Channel instead of Joint Stereo, allos get an almost double bitrate with the same maximum bitpool value: 617 kbps.*\n\nThese fixed values, Bitpool and Bitrate, originate from a table with high-quality audio recommended values. But it's just a recommendations.\n![The high-quality audio recommended values](https://github.com/ololx/sbc-bitpool-expander/blob/assets/about/high-quality-audio-recommended-values.png?raw=true)\n\nThe Bluetooth stack of macOS have artificial limitations on the maximum value of the bitpool parameter: \n\n- Min A2DP bit pool value is  among 2;\n- Max A2DP bit pool value is  among 40;\n- Fact A2DP bit pool value is dinamicaly and changes from max to min values.\n  This limitations directly affects the maximum bitrate.\n\n***Almost all headphones also limit the maximum bitpool value to 53. But such a bitrate will never be negotiated under normal conditions, on ordinary Bluetooth stacks on macOS.***\n\n### How does it work?\n\nThe sbc-bitpool-expander is a mac automator program, which executes a shell command to change the SBC encoding bitpool values. This changes could up the bitrate value till 357 kbit/s for SBC audio. At launch, this tool setups the bit pool min value to 53. This setupping prevents the bit pool from being changing to the standard minimum values ​of 2 and affects the final bitrate and sound quality.\n\n## 📸 Demo\n\n### Usage\n\nThis animation demonstrates how is the simple to use this tool.\n\n\u003cimg align=\"center\" width=\"640\" src=\"https://github.com/ololx/sbc-bitpool-expander/blob/assets/demo/sbc-bitpool-expander-demo.gif?raw=true\"/\u003e\n\n### Effect\nThis pictures demonstrates how the increasing bit rate from 261 kb/s (BEFORE) to 357 kb/s (AFTER) by the bitpool increases after launching this tool.\n\n![The audio graph before usage](https://github.com/ololx/sbc-bitpool-expander/blob/assets/demo/before-usage.png?raw=true) ![The audio graph after usage](https://github.com/ololx/sbc-bitpool-expander/blob/assets/demo/after-usage.png?raw=true)\n\nAfter launching this tool, the following lines will appear in the bluetoothaudiod macOS settings:\n\n```bash\n{\n    ...\n    \"Apple Bitpool Max\" = 64;\n    \"Apple Bitpool Min\" = 53;\n    \"Apple Initial Bitpool\" = 53;\n    \"Apple Initial Bitpool Min\" = 53;\n    \"Negotiated Bitpool\" = 53;\n    \"Negotiated Bitpool Max\" = 64;\n    \"Negotiated Bitpool Min\" = 53;\n    ...\n}\n```\n\n## 🎚 Features\n\n- Increase the sbc bluetooth audio bit rate with in several click.\n\n### To Do\n\n- For more information on an upcoming development, please read the [todo](TODO.md) list.\n\n### Changelog\n\n- For more information on a releases, a features and a changes, please read the [changelog](CHANGELOG.md) notes.\n\n## 🚦 Getting Started\n\nThese instructions allow to get a copy of this project and run it on a local machine.\n\n### Prerequisites\n\nBefore using it, make sure that follows software are installed on the local machine:\n\n- **[macOS](https://www.apple.com/ru/macos/what-is/)** - the operating system under which the process is executing;\n\nIf any of the listed programs is not installed, then it can be installed by instruction as described below.\n\n1. #### macOS\n    - Install macOS by [this](https://support.apple.com/ht201372) instruction.\n\n\n### Installing\n\nIn order to install it is enough to download executable file `sbc bitpool expander.app` for the required release from this page:\n\n```http\nhttps://github.com/ololx/sbc-bitpool-expander/releases/\n```\n\nIf you want to install the source files it is quite simple to clone or donload this repository.\n\n### Cloning\n\nFor the cloning this repository to a local machine, just use the follows link:\n\n```http\nhttps://github.com/ololx/sbc-bitpool-expander\n```\n\n### Using\n\nFor use it is required to:\n\n1. Go to the directory where you download this tool (optionally):\n\n   - via Finder;\n   - via Terminal prompt; \n\n   ```bash\n   cd /{path to parent dir with this repository}/\n   ```\n\n2. Launch the tool in macOS (optionally):\n\n   - via double-click on `sbc bitpool expander.app`;\n   - via Terminal prompt;\n\n   ```bash\n   open sbc\\ bitpool\\ expander.app\n   ```\n3. Set the required bitpool size values. In general, these will be the following settings:\n\n```\n- Current/Initial bitpool value is 53;\n- Min bitpool value is 53;\n- Max bitpool value is 64;\n```\n\n4. Enter the administrator credentials if necessary\n\n5. Reconnect a headphones to a local machine via `Bluetooth`\n\n### If you want a better result for your device \n\nNOTE: It's universal settings and it works for the most devices. Below you can find settings for better sound quality on your device.\nIf you want to watch your current settings:\n```bash\nsudo defaults read bluetoothaudiod \n```\nor if you want reset it to default:\n```bash\nsudo defaults delete bluetoothaudiod\n```\nYou may experement with \"Apple Bitpool Min\" setting. For example, the best sound on my device \"Harman Kardon Go + Play\" is on value 111:\n```bash\nsudo defaults write bluetoothaudiod \"Apple Bitpool Min\" -int 111\nsudo defaults write bluetoothaudiod \"Apple Bitpool Max\" -int 111\n```\nAnd I got stable bit rate at 705 kb/s.\n\n## 🛠 Built With\n\n- **[Xcode](https://developer.apple.com/xcode/)** - the IDE for the `AppleScriptObjC` automatisation development.\n\n## 🎉 Contributing\n\nIf you want to contribute this project - you are welcome and have fun.\nPlease visit the [contributing](CONTRIBUTING.md) section for details on this code of conduct, and the process for submitting pull requests.\n\n## 📝 Code of Conduct\n\nIn order to ensure that all is welcoming, please review and abide by the [code of conduct](CODE_OF_CONDUCT.md).\n\n## 🗒 Versioning\n\nFor the versioning is used [Semantic Versioning](http://semver.org/). For the versions available, see the [changelog](CHANGELOG.md) or the tags on this repository.\n\n## ©️ Authors\n\n* **Alexander A. Kropotin** - *initial work* - [ololx](https://github.com/ololx).\n\n### Contributors ✨\n\n#### Thanks goes to these wonderful people:\n\n* **Roman** - *contributing* - [dE1l](https://github.com/dE1l).\n\n## 🔏 Licensing\n\nThis project is licensed under the MIT license - see the [lisence](LICENSE) document for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fololx%2Fsbc-bitpool-expander","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fololx%2Fsbc-bitpool-expander","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fololx%2Fsbc-bitpool-expander/lists"}