Skip to content

Latest commit

 

History

History
160 lines (121 loc) · 9.82 KB

README_pt.md

File metadata and controls

160 lines (121 loc) · 9.82 KB

English | 中文(简体) | 中文(繁體) | Русский | 日本語 | Українська | 한국어 | Česky | Ελληνικά | Português
Atenção: os arquivos "readme" são mantidos por tradutores e podem ficar desatualizados com o tempo. Para ter as informações mais atuais, visite o arquivo em inglês.

Galaxy Buds Client

Um gerenciador não oficial para os Buds, Buds+, Buds Live e Buds Pro

GitHub downloads count GitHub release (latest by date) License Platform

Funções PrincipaisDownloadComo funcionaContribuindoCreditosLicença

Screenshot

Screenshot

Funções Principais

Configurar e controlar qualquer aparelho da linha Samsung Galaxy Buds e integra-los ao seu desktop.

Além das funções conhecidas do aplicativo oficial de Android esse projeto também ajuda você a desbloquear o potencial máximo de seus earbuds e implementa novas funcionalidades como:

  • Estátisticas detalhadas das baterias
  • Diagnósticos e auto-testes de fabrica
  • Diversas informações ocultas de debugging
  • Customização nas ações de toque longo
  • Firmware flashing, downgrading (Buds+, Buds Pro)
  • e muito mais...

Download

Para obter os binaries para Windows e Linux na página de versões. Por favor, leia as notas antes de realizar a instação.

Download

winget

O pacote para Windows também está disponivel para instalação com o Windows Package Manager (winget)

winget install ThePBone.GalaxyBudsClient

AUR package

Um AUR package para Arch Linux mantido por @joscdk também está disponivel:

yay -S galaxybudsclient-bin

Como funciona

Para utilizar a técnologia sem fio, Bluetooth, o aparelho deve ser capaz de intepretar perfis especificos de Bluetooth que permitem a comunicação eficiente entre um aparelho e o outro.

O Galaxy Buds define dois perfis Bluetooth: AD2P (Perfil de Distribuição de Audio Avançado) para controle/transmissão de áudio e SPP (Perfil de Serial Port) para transmissão de streams binários. Os fabricantes frequentemente usam esse perfil (que depende do protocolo RFCOMM) para configurar a troca de informação, realizar updates de firmware, ou enviar outros comandos para o aparelho Bluetooth.

Mesmo que o perfil A2DP é padronizado e documentado, o formato que a troca de dados binarios realizados por esse protocolo RFCOMM é normlamente próprio da empresa.

Para realizar engenharia-reversa desse formato de dados eu comecei analisando a estrutura da transmissão binaria enviada pelos earbuds. Mais tarde eu também dissequei o aplicativo oficial dos Galaxy Buds para conseguir mais entendimento sobre o funcionamento interno dos fones. Você pode encontrar algumas notas (incompletas) que eu tomei abaixo. Confira o código fonte para obter informações mais detalhadas na estrutura do protocolo.

Galaxy Buds (2019) NotasGalaxy Buds Plus Notas

Enquanto me aprofundava nos Galaxy Buds Plus eu também notei algumas particularidades, como um modo de debug de firmware, um modo de pareamento não utilizado e a enumeração de chaves Bluetooth. Eu documentei esses achados aqui:

Galaxy Buds Plus: Funções incomuns

No momento eu estou tentando modificar e realizar engenharia-reversa no firmware dos Buds+. No momento que eu escrevo isso, já fiz duas ferramentas para acessar e analzar os firmware em binario. Confira eles aqui:

Firmware DownloaderFirmware Extractor

Observe o monitoramento de informação em tempo real dos seus Buds Pro usando esse script: ThePBone/BudsPro-Headtracking

Contribuindo

Pedidos de funcionalidades, relatos de bugs ou qualquer tipo de pull requests são sempre bem-vindos.

Se você deseja avisar sobre algum bug ou propor ideias para esse projeto, você é livre para relatar tudo com um template adequado. Visite a nossa Wiki para uma explicação detalhada.

Se você planeja nos ajudar traduzindo esse aplicativo, confira as instrunções em nossa wiki. Nenhum conhecimento de programação é necessário, você pode testar as suas traduções sem instalar nenhuma ferramenta de desenvolvedor antes de enviar um pull request. Você pode achar relatorios automáticos do progresso de traduções existentes [aqui] (https://github.com/ThePBone/GalaxyBudsClient/blob/master/meta/translations.md).

Se você deseja contribuir com seu próprio código, você pode simplesmente enviar um pull request explicando suas mudanças. Para contribuições maiores e complexas é interessante abrir um "issue" (ou me contactar via telegram @thepbone) antes de começar a trabalhar nisso.

Creditos

Colaboradores

Tradutores

Licença

Esse projeto é licenciado sob GPLv3. Ele não é afiliado com a Samsung nem supervisionado por eles de alguma maneira.

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 O