From 36fd622076256b5d2b5e56df1a05aed4a496eb8d Mon Sep 17 00:00:00 2001 From: Hyeonho Kang Date: Mon, 3 Feb 2025 00:32:30 +0900 Subject: [PATCH] Update README.md & README_kor.md --- README.md | 19 +++--- docs/README_kor.md | 147 ++++++++++++++++++++++++++++++--------------- 2 files changed, 109 insertions(+), 57 deletions(-) diff --git a/README.md b/README.md index f64df654..c4371d57 100644 --- a/README.md +++ b/README.md @@ -33,7 +33,7 @@

Screenshot - Screenshot + Screenshot

## Key Features @@ -61,12 +61,12 @@ Get binaries for Windows in the [release](https://github.com/timschneeb/GalaxyBu Download the desktop version here:

- Download + Download

Download the Android mobile version here (paid):

- + Get it on Google Play

@@ -84,7 +84,7 @@ flatpak install me.timschneeberger.GalaxyBudsClient > **Note**: Flatpaks are sandboxed. This application can only access `~/.var/app/me.timschneeberger.GalaxyBudsClient/` by default. -### AUR package +### AUR package An [AUR package](https://aur.archlinux.org/packages/galaxybudsclient-bin/) for Arch Linux maintained by @joscdk is also available: ``` @@ -157,6 +157,7 @@ If you want to contribute your own code, you can simply submit a plain pull requ * [@ArthurWolfhound](https://github.com/ArthurWolfhound) - Russian and Ukrainian translation * [@PlasticBrain](https://github.com/fhalfkg) - Korean and Japanese translation * [@cozyplanes](https://github.com/cozyplanes) - Korean translation +* [@corydalis10](https://github.com/corydalis10) - Korean translation * [@erenbektas](https://github.com/erenbektas) and [@Eta06](https://github.com/Eta06) - Turkish translation * [@kakkk](https://github.com/kakkk), [@KevinZonda](https://github.com/KevinZonda), [@ssenkrad](https://github.com/ssenkrad), [@pseudor](https://github.com/pseudor) and [@YexuanXiao](https://github.com/YexuanXiao) - Chinese translation * [@YiJhu](https://github.com/YiJhu) - Chinese-Traditional translation @@ -177,7 +178,7 @@ If you want to contribute your own code, you can simply submit a plain pull requ ### Services -* [Cloudflare](https://www.cloudflare.com/) - Secures the backend APIs of GalaxyBudsClient and provided a Pro license +* [Cloudflare](https://www.cloudflare.com/) - Secures the backend APIs of GalaxyBudsClient and provided a Pro license ### Assets * Earbud asset used in the Android icon created by [Archival](https://www.flaticon.com/authors/archival) from [Flaticon](https://www.flaticon.com/) @@ -187,9 +188,9 @@ If you want to contribute your own code, you can simply submit a plain pull requ This project is licensed under [GPLv3](https://github.com/timschneeb/GalaxyBudsClient/blob/master/LICENSE). It is not affiliated with Samsung nor supervised by them in any way. ``` -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 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. ``` diff --git a/docs/README_kor.md b/docs/README_kor.md index dae0de21..09f07ef1 100644 --- a/docs/README_kor.md +++ b/docs/README_kor.md @@ -6,19 +6,19 @@ Galaxy Buds Client
-

버즈, 버즈 플러스, 버즈 라이브와 버즈 프로를 위한 비공식 매니저

+

갤럭시 버즈 기기를 위한 비공식 매니저

- + Github 다운로드 횟수 - - GitHub 릴리즈 (최신 날짜) + + GitHub 릴리즈 (최신) - + 라이센스 - - 플랫폼 + + 플랫폼

@@ -27,15 +27,12 @@ 동작 방식 • 기여 • 제작자 • - 라이선스 + 라이선스

- 스크린샷 -

- -

- 스크린샷 + 스크린샷 + 스크린샷

## 주요 기능 @@ -52,15 +49,51 @@ ## 다운로드 -Windows와 Linux 바이너리는 [릴리즈 섹션](https://github.com/ThePBone/GalaxyBudsClient/releases)에서 다운로드가 가능합니다. 설치하기 전에 릴리즈 노트를 읽어 주세요. +몇 가지 Linux 패키지를 사용할 수 있습니다: +* [Flatpak (모든 Linux 배포판)](#flatpak) +* [AUR 패키지 (아치 리눅스)](#aur-package) + +Windows용 바이너리는 [릴리즈](https://github.com/timschneeb/GalaxyBudsClient/releases) 섹션에 있습니다. 설치하기 전에 릴리스 노트를 읽어주세요. + +여기에서 데스크톱 버전을 다운로드하세요: +

+ 다운로드 +

+여기에서 안드로이드용 모바일 버전을 다운로드하세요 (유료):

- 다운로드 + + Google Play에서 받기 +

-Windows 패키지는 Windows Package Manager(winget)로도 설치가 가능합니다. +### Flatpak + +모든 Linux 배포판을 위한 범용 바이너리 패키지입니다. Flatpak 버전은 수동으로 설정하지 않는 한 자동 시작을 지원하지 않습니다. 'galaxybudsclient /StartMinimized'를 사용하여 시작 시 앱을 자동으로 실행할 수 있습니다. + +FlatHub에서 다운로드 가능: https://flathub.org/apps/me.timschneeberger.GalaxyBudsClient +``` +flatpak install me.timschneeberger.GalaxyBudsClient +``` + +Flathub에서 다운로드하기 + +> **노트**: Flatpak은 샌드박스가 적용되었습니다. 이 애플리케이션은 기본적으로 `~/.var/app/me.timschneeberger.GalaxyBudsClient/`에만 접근할 수 있습니다. + +### AUR 패키지 + +@joscdk가 유지 관리하는 Arch Linux용 [AUR 패키지](https://aur.archlinux.org/packages/galaxybudsclient-bin/)도 사용할 수 있습니다: +``` +yay -S galaxybudsclient-bin +``` + +### winget + +Windows 패키지는 Windows 패키지 관리자 (winget)로도 설치할 수 있습니다. -`winget install ThePBone.GalaxyBudsClient` +``` +winget install timschneeb.GalaxyBudsClient +``` ## 동작 방식 @@ -70,11 +103,11 @@ Bluetooth 무선 기술을 사용하기 위해, 디바이스는 동작 가능한 A2DP 프로필이 표준화 및 문서화되더라도, RFCOMM 프로토콜로 교환되는 실제 바이너리 데이터의 형식은 일반적으로 문서화되지 않은 독자적 형식입니다. -이 데이터 형식을 역분석하기 위해, 저는 이어버즈로부터 전송되는 바이너리 스트림을 분석하기 시작했습니다. 그 후에는 디바이스들의 내부 동작을 더 자세히 알기 위해 안드로이드 공식 갤럭시 버즈 앱을 분석했습니다. 이 일을 하는 동안, 저는 제가 했던 생각들을 기록했습니다. 별로 아름다운 기록은 아니지만, 밑에 링크를 기재했습니다. 제가 상세한 내용 하나 하나에 대해서 모두 기록하지는 않았음을 알아두세요. 프로토콜에 대해 더 자세한 정보를 알고 싶다면 소스 코드를 확인하세요. +이 데이터 형식을 역분석하기 위해, 저는 이어버드로부터 전송되는 바이너리 스트림을 분석하기 시작했습니다. 그 후에는 디바이스들의 내부 동작을 더 자세히 알기 위해 안드로이드 공식 갤럭시 버즈 앱을 분석했습니다. 이 일을 하는 동안, 저는 제가 했던 생각들을 기록했습니다. 별로 아름다운 기록은 아니지만, 밑에 링크를 기재했습니다. 제가 상세한 내용 하나 하나에 대해서 모두 기록하지는 않았음을 알아두세요. 프로토콜에 대해 더 자세한 정보를 알고 싶다면 소스 코드를 확인하세요.

- 갤럭시 버즈 (2019) 기록 • - 갤럭시 버즈 플러스 기록 + 갤럭시 버즈 (2019) 노트 • + 갤럭시 버즈 플러스 노트

갤럭시 버즈 플러스를 유심히 분석하면서, 저는 펌웨어 디버그 모드와 쓰이지 않은 페어링 모드, Bluetooth 키 덤퍼와 같은 특이한 기능을 찾아냈습니다. 그 기능들에 대한 내용도 아래의 링크에 기록했습니다: @@ -90,46 +123,64 @@ A2DP 프로필이 표준화 및 문서화되더라도, RFCOMM 프로토콜로 펌웨어 추출기

+이 스크립트를 사용하여 버즈 프로에서 헤드 트래킹 데이터를 실시간으로 스트리밍하세요: [timschneeb/BudsPro-Headtracking](https://github.com/timschneeb/BudsPro-Headtracking) + ## 기여 기능 요청, 버그 보고, Pull Requests 등 어떤 형태의 기여도 환영합니다. -버그를 제보하거나 아이디어를 제시하고 싶으시면, 템플릿과 함께 제공되는 [새로운 Issue 생성](https://github.com/ThePBone/GalaxyBudsClient/issues/new/choose)을 이용해 주세요. [위키](https://github.com/ThePBone/GalaxyBudsClient/wiki/2.-How-to-submit-issues)를 방문해 자세한 설명을 참고하세요. +버그를 제보하거나 아이디어를 제시하고 싶으시면, 템플릿과 함께 제공되는 [새로운 Issue 생성](https://github.com/timschneeb/GalaxyBudsClient/issues/new/choose)을 이용해 주세요. [위키](https://github.com/timschneeb/GalaxyBudsClient/wiki/2.-How-to-submit-issues)를 방문해 자세한 설명을 참고하세요. + +이 프로그램의 번역에 도움을 제공하고 싶으시다면, [위키의 설명](https://github.com/timschneeb/GalaxyBudsClient/wiki/3.-How-to-help-with-translations)을 참조하세요. 프로그래밍 지식을 요구하지 않으며, Pull Request 전 어떤 개발 툴의 설치도 없이 번역을 테스트할 수 있습니다. +번역에 대한 자동 생성 진행률 보고서는 [여기](https://github.com/timschneeb/GalaxyBudsClient/blob/master/meta/translations.md)에서 확인할 수 있습니다. -이 프로그램의 번역에 도움을 제공하고 싶으시다면, [위키의 설명](https://github.com/ThePBone/GalaxyBudsClient/wiki/3.-How-to-help-with-translations)을 참조하세요. 프로그래밍 지식을 요구하지 않으며, Pull Request 전 어떤 개발 툴의 설치도 없이 번역을 테스트할 수 있습니다. 소스 코드에 기여하고 싶으시다면, 변경한 내용에 대한 Pull Request를 생성하면 됩니다. 프로그램에 대한 크거나 민감한 기여 사항은 작업을 시작하기 전에 Issue를 생성해 주세요. (또는 텔레그램 [@thepbone](https://t.me/thepbone)으로 연락) ## 제작자 -#### 기여 - -- [@ArthurWolfhound](https://github.com/ArthurWolfhound) - Issue 템플릿, 위키 제작과 번역 -- [@AndriesK](https://github.com/AndriesK) - 버즈 라이브 버그 픽스 -- [@TheLastFrame](https://github.com/TheLastFrame) - 버즈 프로 아이콘 -- [@githubcatw](https://github.com/githubcatw) - 연결 알림 기반 제작 -- [@GaryGadget9](https://github.com/GaryGadget9) - WinGet 패키지 - -#### 번역 - -- [@ArthurWolfhound](https://github.com/ArthurWolfhound) - 러시아어, 우크라이나어 번역 -- [@BrainInAVet](https://github.com/fhalfkg) - 한국어, 일본어 번역 -- [@cozyplanes](https://github.com/cozyplanes) - 한국어 번역 -- [@erenbektas](https://github.com/erenbektas) - 터키어 번역 -- [@kakkk](https://github.com/kakkk), [@KevinZonda](https://github.com/KevinZonda), [@ssenkrad](https://github.com/ssenkrad) and [@pseudor](https://github.com/pseudor) - 중국어 번역 -- [@efrenbg1](https://github.com/efrenbg1), Andrew Gonza - 스페인어 번역 -- [@giovankabisano](https://github.com/giovankabisano) - 인도네시아어 번역 -- [@lucasskluser](https://github.com/lucasskluser) - 포르투갈어 번역 -- [@alb-p](https://github.com/alb-p), [@mario-donnarumma](https://github.com/mario-donnarumma) - 이탈리아어 번역 -- [@Buashei](https://github.com/Buashei) - 폴란드어 번역 -- [@KatJillianne](https://github.com/KatJillianne), [@thelegendaryjohn](https://github.com/thelegendaryjohn) - 베트남어 번역 -- [@joskaja](https://github.com/joskaja), [@Joedmin](https://github.com/Joedmin) - 체코어 번역 -- [@TheLastFrame](https://github.com/TheLastFrame), [@ThePBone](https://github.com/ThePBone) - 독일어 번역 -- [@nikossyr](https://github.com/nikossyr) - 그리스어 번역 -- [@grigorem](https://github.com/grigorem) - 루마니아어 번역 +#### 기여자 + +* [@nift4](https://github.com/nift4) - macOS 지원 및 버그 수정 +* [@ArthurWolfhound](https://github.com/ArthurWolfhound) - 이슈 템플릿, 위키 및 번역 +* [@AndriesK](https://github.com/AndriesK) - 버즈 라이브 버그 수정 +* [@TheLastFrame](https://github.com/TheLastFrame) - 버즈 프로 아이콘 +* [@githubcatw](https://github.com/githubcatw) - 연결 대화 상자 기반 +* [@GaryGadget9](https://github.com/GaryGadget9) - WinGet 패키지 +* [@joscdk](https://github.com/joscdk) - AUR 패키지 + +#### 번역가 + +* [@ArthurWolfhound](https://github.com/ArthurWolfhound) - 러시아어 및 우크라이나어 번역 +* [@PlasticBrain](https://github.com/fhalfkg) - 한국어 및 일본어 번역 +* [@cozyplanes](https://github.com/cozyplanes) - 한국어 번역 +* [@erenbektas](https://github.com/erenbektas) 및 [@Eta06](https://github.com/Eta06) - 터키어 번역 +* [@kakkkk](https://github.com/kakkk), [@KevinZonda](https://github.com/KevinZonda), [@ssenkrad](https://github.com/ssenkrad), [@pseudor](https://github.com/pseudor) 및 [@YexuanXiao](https://github.com/YexuanXiao) - 중국어 번역 +* [@YiJhu](https://github.com/YiJhu) - 중국어-전통 번역 +* [@efrenbg1](https://github.com/efrenbg1) 및 Andrew Gonza - 스페인어 번역 +* [@giovankabisano](https://github.com/giovankabisano) - 인도네시아어 번역 +* [@lucasskluser](https://github.com/lucasskluser) - 포르투갈어 번역 +* [@alb-p](https://github.com/alb-p), [@mario-도나룸마](https://github.com/mario-donnarumma) - 이탈리아어 번역 +* [@Buashei](https://github.com/Buashei) - 폴란드어 번역 +* [@KatJillianne](https://github.com/KatJillianne) 및 [@theLegendaryjohn](https://github.com/thelegendaryjohn) - 베트남어 번역 +* [@jos카자](https://github.com/joskaja) 및 [@Joedmin](https://github.com/Joedmin) - 체코어 번역 +* [@Benni0109](https://github.com/Benni0109), [@TheLastFrame](https://github.com/TheLastFrame), [@timschneeb](https://github.com/timschneeb) - 독일어 번역 +* [@nikossyr](https://github.com/nikossyr) - 그리스어 번역 +* [@grigorem](https://github.com/grigorem) - 루마니아어 번역 +* [@tretre91](https://github.com/tretre91) - 프랑스어 번역 +* [@Sigarya](https://github.com/Sigarya) - 히브리어 번역 +* [@domroaft](https://github.com/domroaft) - 헝가리어 번역 +* [@lampi8426](https://github.com/lampi8426) - 네덜란드어 번역 + +### 서비스 + +* [Cloudflare](https://www.cloudflare.com/) - Secures the backend APIs of GalaxyBudsClient and provided a Pro license + +### 요소 +* [Flaticon](https://www.flaticon.com/)의 [Archival](https://www.flaticon.com/authors/archival)이 만든 안드로이드 아이콘에 사용된 이어버드 에셋입니다. ## 라이선스 -이 프로젝트는 [GPLv3](../LICENSE) 라이선스를 따릅니다. 삼성과 관련되지 않았으며 그 어떤 권고나 제한도 받지 않습니다. +이 프로젝트는 [GPLv3](../LICENSE) 라이선스를 따릅니다. 삼성과 관련되지 않았으며 그들에게 어떠한 권고나 제한도 받지 않습니다. ``` THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,